Linux服务器代理联网指南:Clash与Mihomo
Linux 服务器上的软件安装、代码拉取、模型下载和 API 调用,可能需要通过代理访问网络。本文使用兼容 Clash 配置生态的 Mihomo 核心,在用户目录中运行代理,再让需要联网的程序显式使用它。
使用前提:服务器具备基础网络连接,并且已有可用的上游代理配置。 上游可以是单位提供的代理、自行部署的节点或订阅服务,并不要求必须购买代理套餐。Mihomo 本身不提供节点,也不代替校园网认证;仅使用 DIRECT 时,请求仍从服务器原有网络直接发出。
所有 Linux 命令均在服务器的 Bash 终端执行。安装和运行使用普通用户权限,代理端口设为 7890,不启用 TUN、透明代理或系统路由修改。SSH、VS Code 与 tmux 的基础操作可参考 AI Coding指南。
1. 代理在服务器上如何工作
本文采用的请求路径为:
1 | 服务器上的程序 → 127.0.0.1:7890 → Mihomo → 上游代理节点 → 目标网站 |
其中有三个独立部分:
- Mihomo 核心负责监听本地端口、匹配规则并建立上游连接。
- 配置文件提供节点、代理组和分流规则;仅安装程序不会自动获得可用节点。
- 应用程序通过代理参数或环境变量,把请求交给本地代理。
这里的 127.0.0.1 指服务器自身。Mihomo 直接运行在服务器上,因此 PC 关闭后无需继续为它转发流量;服务器仍须能够连接配置中的上游节点。代理不能替代服务器的基础网络连接,也不能解决上游本身不可达的问题。
Mihomo 是独立命令行核心,不要求安装桌面客户端。本文使用项目官方发布的二进制文件,避免依赖旧版 Clash 桌面安装包。发行文件与维护状态以 Mihomo 官方仓库 为准。
2. 安装到用户目录
2.1 确认系统架构
1 | uname -m |
x86_64 对应 linux-amd64,aarch64 对应 linux-arm64。AMD64 发布包中的 v1、v2、v3 是 CPU 指令集等级;不确定服务器支持情况时可选 amd64-v1。较旧内核还需检查对应构建的系统要求,见 官方发行包选择说明。
2.2 下载并解压
以已发布的 v1.19.31 为可复现示例。更新版本时,应从 官方 Releases 核对版本号与资产文件名。
1 | mkdir -p "$HOME/.local/bin" "$HOME/.local/share/mihomo-download" |
将输出与该资产在 Releases 页面展示的 SHA-256 对照。服务器暂时无法下载时,可在 PC 下载同一文件,通过 SFTP 上传到上述目录,再执行后续步骤。
1 | gzip -dc "$MIHOMO_ASSET" > mihomo |
若已有 Mihomo 正在运行,先在其终端中按 Ctrl+C 停止,再更新可执行文件。
将下面一行加入 ~/.bashrc,已有相同配置时无需重复添加:
1 | export PATH="$HOME/.local/bin:$PATH" |
重新载入并验证:
1 | source ~/.bashrc |
3. 导入已有配置
3.1 准备完整的 Clash / Mihomo 配置
从已有服务导出兼容的 完整 YAML 配置,或从已有客户端获取实际使用的配置文件。仅有节点链接、Base64 节点列表或桌面客户端的程序设置文件,不能直接作为这里的 config.yaml。
配置可能包含节点密码、UUID、订阅令牌和私有订阅地址,应存放在个人目录中。先创建配置目录:
1 | umask 077 |
通过 SFTP 将文件上传为 ~/.config/mihomo/config.yaml,然后执行:
1 | chmod 600 "$HOME/.config/mihomo/config.yaml" |
若配置引用本地 provider 文件,也需上传对应文件并修正路径。远程 proxy-providers、rule-providers 则要求服务器能访问其下载地址。私有订阅 URL 不应写进公开教程、仓库或终端截图;使用桌面客户端导出文件也能避免把订阅令牌写入命令历史。
3.2 调整监听方式
编辑 config.yaml,把以下字段合并到原配置中。已有同名字段时修改原值,不要直接在文件末尾追加一套重复键。 保留原有的节点、代理组、规则与必要的 DNS 配置。
1 | mixed-port: 7890 |
这是一段运行参数补丁,不是完整节点配置。mixed-port 同时接受 HTTP 和 SOCKS5 代理连接;其他常规入站端口设为 0,避免启动重复监听。若原配置另含 listeners、tunnels 等自定义入站,应删除不需要的条目;若启用了 DNS 服务监听,可移除 dns.listen,保留核心解析所需的其他 DNS 字段。代理端口说明
allow-lan: false 将常规代理入口限制在本机,外部控制 API 留空则不启动管理接口。这里无需管理面板。环回地址并不隔离服务器上的其他用户;共享机器如需限制代理使用者,可按管理要求另设入站认证。相关字段见 Mihomo 全局配置。
mode: rule 表示按原配置的 rules 分流,最终请求可能走代理,也可能走 DIRECT。代理组中的节点名称必须与节点或 provider 定义一致,不能把占位名称直接当成可用节点。
3.3 检查并启动
1 | mihomo -t -d "$HOME/.config/mihomo" |
-t 检查配置后退出,-d 指定配置和运行数据目录,默认读取其中的 config.yaml。需要指定其他文件时使用 -f。这些参数来自 Mihomo 命令行实现。
第二条命令在前台持续运行,终端暂时不返回提示符是正常现象。检查通过只代表配置可解析,不代表节点、订阅与目标网站均可访问;首次启动还可能下载配置依赖的数据文件。
4. 验证代理与设置环境变量
4.1 先用单条命令验证
保持 Mihomo 运行,另开一个服务器终端:
1 | curl -I --noproxy "" --proxy http://127.0.0.1:7890 \ |
将测试地址换成实际需要访问的网站,可验证对应线路。收到完整的 HTTP 响应说明请求已完成;403、404 等响应还需要结合目标网站判断,不能仅凭状态码认定代理失效。同时查看 Mihomo 日志,确认请求命中了哪条规则、选择了哪个出口。
HTTPS 请求通过 HTTP 代理时,通常先用 CONNECT 建立到目标的隧道,再在隧道中完成 TLS 握手。因此,代理地址中的 http:// 描述的是应用连接代理的方式,不意味着 HTTPS 目标请求变成明文 HTTP。curl 的 HTTP 代理说明
4.2 让当前终端中的程序使用代理
1 | export http_proxy=http://127.0.0.1:7890 |
不同程序对变量名的支持不同,示例同时设置大小写以兼容常见工具;其中 curl 对 HTTP 代理只接受小写 http_proxy。no_proxy 指定不经过代理的主机,可按需加入直接访问的服务域名。详细匹配规则因程序而异,见 curl 代理环境变量说明。
环境变量影响当前 shell 及其后续启动的子进程,不会自动修改其他 SSH 会话或已运行的程序,也不会接管系统所有流量。Python 库、Git、下载器是否使用它们,应以各工具的实现为准。
4.3 需要 SOCKS5 时
Mihomo 的混合端口也接受 SOCKS5。例如:
1 | curl -I --noproxy "" --proxy socks5h://127.0.0.1:7890 \ |
socks5h 让代理端解析目标域名;socks5 通常由应用本地解析。支持该变量的程序还可使用 all_proxy=socks5h://127.0.0.1:7890,但 curl 中具体协议的 http_proxy、https_proxy 优先于 ALL_PROXY,不能用新增 ALL_PROXY 的方式覆盖已设置的 HTTP 代理。curl 的 SOCKS 代理说明、变量优先级
5. 按需开启和关闭
将下面两个 Bash 函数加入 ~/.bashrc。这里仅定义操作,不在每次登录时自动开启代理:
1 | proxy_on() { |
保存后使用:
1 | source ~/.bashrc |
proxy_off 只清理当前 shell 的上述环境变量,不会停止 Mihomo,也不会取消其他程序单独保存的代理设置。如果原本已有单位或项目专用代理配置,应保留并恢复原值,而非直接使用这套清空逻辑。
只想为一次请求设置代理时,直接使用 curl --proxy ...;这样不会改变后续命令的环境。
6. 用 tmux 保持代理进程运行
前台验证完成后,在 Mihomo 所在终端按 Ctrl+C。确认服务器已有 tmux,再创建会话:
1 | tmux new -s mihomo |
在该会话内运行:
1 | umask 077 |
先按 Ctrl+B,松开后按 D,即可分离会话。Mihomo 继续在服务器上运行,SSH 断开不会因为终端关闭而直接结束它。重新登录后可检查会话或查看日志:
1 | tmux ls |
回到会话后按 Ctrl+C 可停止 Mihomo。改动配置或更新订阅后,先运行 mihomo -t -d "$HOME/.config/mihomo" 检查,再停止旧进程并用原启动命令重启,不要同时启动多个实例争用端口。
新 SSH 会话需要重新执行 proxy_on;代理进程常驻与当前终端是否使用代理是两个独立状态。tmux 不负责开机启动或崩溃重启,服务器重启、进程被终止或管理员清理用户会话后仍需重新启动。日志采用追加写入,长期使用应定期归档,避免持续占用磁盘。tmux 官方入门
7. 常见问题
程序提示 Exec format error 或 Illegal instruction
前者通常表示下载的系统或 CPU 架构不匹配;后者可能是 CPU 不支持该构建的指令集。重新核对 uname -m 与发行包,AMD64 机器优先尝试 amd64-v1。文件已有执行权限却无法运行时,还需检查安装目录是否被挂载为 noexec,并使用管理员允许执行程序的位置。
配置检查失败
按错误行号检查 YAML 缩进、重复键和节点引用。完整配置与 provider 的节点列表结构不同,不能互换;从桌面环境复制的绝对路径也可能在服务器不存在。分享错误信息前移除节点凭证与订阅地址。
address already in use 或 Connection refused
前者通常表示端口已被其他进程占用,后者通常表示目标端口没有程序监听。可以检查:
1 | ss -lntp 'sport = :7890' |
已有自己的实例时直接复用;端口属于其他用户时,为自己的 mixed-port 选择其他空闲高位端口,并同步修改代理变量。不要终止不属于自己的进程。
配置正确,但请求一直超时
先查看日志确认代理已启动,再区分目标域名解析、节点连接、TLS 握手和网站响应分别在哪一步失败。为测试命令设置超时,可以避免终端无限等待;没有报错或没有输出,都不能作为联网成功的依据。
如果启动时下载规则或 GEO 数据失败,需要先准备配置引用的文件,或使用当前可直接访问的可信下载来源。订阅在 PC 上可用也不保证服务器能连接同一节点;不要通过关闭证书验证来掩盖 TLS 错误。
curl 可用,但 IDE 或某个扩展仍不能联网
检查该程序运行在 PC 还是服务器、何时启动、是否支持代理环境变量。给终端设置变量不会改变已经运行的 VS Code Server。VS Code 的本地与远端代理配置,以及 SSH 转发 PC 代理的另一种方式,见 AI Coding指南。
请求成功,但出口没有变化
检查 Mihomo 日志中的匹配结果、mode、分流规则和代理组选择。规则命中 DIRECT 时,请求仍可经过本地监听端口,但最终由服务器直接访问目标;经过 127.0.0.1:7890 不等于必然使用上游代理。





