使用教程

Linux 机场教程:Ubuntu 翻墙客户端安装与服务器 mihomo 内核用法

更新于 · 约 15 分钟读完 · 登机口编辑整理

先分清你属于哪种情况

场景 推荐做法 难度 代理怎么生效
桌面发行版,日常上网 图形客户端(如 Clash Verge Rev) 低 系统代理或 TUN
桌面发行版,主要用终端 图形客户端 + 终端环境变量 低 环境变量
无图形界面的服务器 mihomo 内核 + 配置文件 中 环境变量,或内核的 TUN
需要开机自动运行的服务器 在上一行基础上加 systemd 托管 中 同上

只提供自研客户端的机场,一般没有 Linux 版本,也拿不到 Clash 格式的订阅,在 Linux 上基本用不了。买之前先确认这一点。客户端之间的差别见客户端怎么选。

桌面环境:用 Clash Verge Rev

Clash Verge Rev 是开源的图形客户端,内置 mihomo 内核,官方发布页提供 Linux 安装包。

  1. 从它在 GitHub 上的官方发布页下载对应的安装包。Ubuntu、Debian 系选 deb 格式,Fedora 等选 rpm 格式,注意区分 x64 和 ARM 架构;
  2. 用系统的包管理器安装下载好的文件。Ubuntu 上可以直接双击用软件中心安装,或者在终端里用 apt 安装本地文件,这样依赖会自动补齐;
  3. 打开客户端,进入订阅页,粘贴机场用户中心里的 Clash 格式订阅链接并导入,然后点击订阅卡片使其生效;
  4. 到代理页保持规则模式,选一个有延迟返回的节点;
  5. 在设置页打开系统代理开关,用浏览器访问一个国外网站验证。

界面操作和其他系统完全一致,更细的说明可以直接参照Clash Verge Rev 使用教程。

Linux 桌面上有一个其他系统没有的差异:系统代理不一定对所有桌面环境生效。 客户端的系统代理开关是通过修改桌面环境的代理设置实现的,GNOME 和 KDE 这类主流桌面支持得比较好,一些轻量窗口管理器根本没有统一的系统代理设置,开关打开也没有效果。遇到这种情况有三个办法:在浏览器里手动指定代理;给终端设置环境变量;开启 TUN 模式接管全部流量。TUN 首次开启需要管理员权限,原理见系统代理与 TUN 模式。

服务器:直接运行 mihomo 内核

没有图形界面的机器,装不了图形客户端,但图形客户端背后干活的本来就是内核。直接运行内核,效果是一样的。mihomo 是目前 Clash 系主流的内核,它是什么、和各种客户端的关系,见mihomo 内核是什么。

一般思路如下:

  1. 取得内核程序。 从 mihomo 的官方 GitHub 发布页下载与服务器架构匹配的版本(常见的是 amd64 或 arm64),解压后赋予可执行权限,放到一个固定位置。服务器本身访问不了发布页的话,在自己电脑上下载好再传上去;
  2. 准备配置目录。 新建一个目录专门存放配置,例如用户主目录下的某个文件夹;
  3. 取得配置文件。 把机场的 Clash 格式订阅内容保存为该目录下的 config.yaml。可以在服务器上用 curl 或 wget 直接下载订阅链接,也可以在本地电脑下载后上传;
  4. 启动内核。 运行内核并用 -d 参数指定配置目录,内核会读取其中的 config.yaml;
  5. 验证。 看启动日志里有没有报错,再用下一节的环境变量测试能否访问外网。
# 路径仅为示意,按你实际存放的位置修改
./mihomo -d ~/mihomo-config

几个容易踩的地方:

  • 下载下来的不是 YAML。 有些机场会根据请求方的客户端标识返回不同格式,用命令行工具下载到的可能是一段编码过的文本,而不是 Clash 配置。打开文件看一眼,开头应该是可读的配置项。不是的话,到机场用户中心找明确标注为 Clash 的订阅地址,或者在本地用图形客户端导入后把生成的配置文件拷贝过来。
  • 首次启动要下载数据文件。 内核第一次运行时通常需要下载用于规则判断的地理数据文件,服务器网络不通时会卡在这一步。可以在本地准备好这些文件,一起放进配置目录。
  • 订阅不会自己更新。 图形客户端会定时拉取订阅,裸跑内核时配置文件是静态的。机场换了节点,需要重新下载配置并重启内核,可以写一个定时任务来做。
  • 确认监听端口。 配置文件里的 mixed-port(或 port、socks-port)决定了本地代理端口,后面设置环境变量时要用到。

配置文件各字段的含义见Clash 配置文件入门。

终端代理环境变量

内核跑起来之后,只是在本机开了一个代理端口,程序不会自动使用它。命令行程序大多通过环境变量读取代理设置:

# 端口以你的配置文件或客户端设置页为准,7890 仅为示例
export http_proxy=http://127.0.0.1:7890
export https_proxy=http://127.0.0.1:7890
export all_proxy=socks5://127.0.0.1:7890

这三行只对当前终端会话有效,关掉终端就失效。想长期生效,可以写进 shell 的配置文件;更常见的做法是定义两个别名,一个开启、一个用 unset 取消。

验证方法是用 curl 访问一个国外网站,看能不能拿到响应。注意 ping 不走这类代理,用它测试没有意义。

环境变量不是万能的,下面几种情况需要单独处理:

  • sudo 默认不会继承当前用户的环境变量,所以 sudo apt update 不一定走代理;
  • 包管理器、Git、Docker 守护进程都有各自的代理配置方式,Docker 的写法见Docker 代理设置;
  • 少数程序完全不读取环境变量,这时要么用内核的 TUN 模式,要么借助专门的代理包装工具。

各种工具的具体写法整理在终端代理设置里。

用 systemd 托管内核

直接在终端里启动内核,关掉 SSH 连接进程就结束了。长期运行的服务器,通常交给 systemd 管理:开机自动启动、异常退出后自动重启、日志统一用 journalctl 查看。

思路是写一个服务单元文件,告诉 systemd 用什么命令启动内核。下面是一个最小示意,只保留了必要的字段:

# 最小示意,ExecStart 里的两个路径必须按你的实际位置修改
[Unit]
Description=mihomo
After=network-online.target

[Service]
ExecStart=/usr/local/bin/mihomo -d /etc/mihomo
Restart=on-failure

[Install]
WantedBy=multi-user.target

把它保存到 systemd 的系统服务目录后,依次执行重新加载配置、启动服务、设置开机自启这三步,再用 systemctl status 确认状态是运行中。启动失败时,先看日志里的报错,多数是路径写错、配置文件格式有问题,或者端口已被占用。

这个示意没有涉及运行用户、权限收紧等内容。要在服务器上启用 TUN 的话,建议参考 mihomo 官方文档给出的服务文件写法,不要照抄来路不明的脚本。

服务器上使用的几点提醒

不要把代理端口暴露到公网。 配置里有一项控制是否允许局域网连接。在云服务器上,如果打开了它,防火墙或安全组又放行了代理端口,这个端口就可能被扫描到并被别人滥用,消耗的是你的流量。只给本机用的话,保持关闭,让内核只监听本机地址。控制面板端口同理。

流量消耗可能比想象的大。 服务器上拉镜像、下载数据集,一次就是几十 GB。能直连的源尽量直连,或者换用国内镜像源,代理只留给确实需要的请求。

用控制接口查看和切换节点

裸跑内核没有界面,查看当前用的是哪个节点、换节点,都要通过内核的控制接口。配置文件里的 external-controller 一项指定了它监听的地址和端口,secret 是访问它的密钥。只给本机用时,让它监听 127.0.0.1,并且设置一个密钥。

这个接口是 HTTP 形式的,用 curl 就能操作:

# 地址、端口、密钥、代理组名称都以你的配置文件为准
# 查看所有代理组和节点的状态
curl -H "Authorization: Bearer 你的密钥" http://127.0.0.1:9090/proxies

# 把名为 PROXY 的代理组切换到指定节点
curl -X PUT -H "Authorization: Bearer 你的密钥" \
  -H "Content-Type: application/json" \
  -d '{"name":"节点名称"}' \
  http://127.0.0.1:9090/proxies/PROXY

第一条返回的是 JSON,内容很长,装了 jq 的话可以用它筛出需要的字段。第二条里的代理组名称和节点名称必须与配置文件里的完全一致;名称里有中文或空格时,写在网址里的那部分需要做 URL 编码。只有手动选择类型的代理组可以这样切换,自动选择类型的组由内核自己决定。

觉得命令行不方便,可以用网页控制面板。它本质上是一个连接到同一接口的网页,在浏览器里点选节点。服务器上的做法是用 SSH 端口转发把控制端口映射到自己电脑上,再在本地浏览器里打开,不要为了方便把控制端口直接开放到公网。

让订阅定时更新

裸跑内核时配置不会自己更新。最简单的办法是用定时任务定期重新下载配置,再重启服务。下面是一个示意:

# 每天凌晨 4 点执行,路径和订阅地址按实际情况修改
0 4 * * * curl -fsSL -o /etc/mihomo/config.new "订阅地址" && mv /etc/mihomo/config.new /etc/mihomo/config.yaml && systemctl restart mihomo

这一行做了三件事,前一步成功才会执行后一步:先把订阅下载到一个临时文件,-f 参数保证服务器返回错误时命令失败、不会留下一份坏文件;下载成功后才替换正式的配置;最后重启服务让新配置生效。

用之前有三点要想清楚:

  • 整份替换会冲掉本地改动。 你在配置里手动改过的内容,比如控制接口的密钥、是否允许局域网连接、自己加的规则,都会被订阅内容覆盖。更新之后要确认这几项仍然符合预期,尤其是在云服务器上;
  • 下载到的必须是 Clash 格式。 机场按客户端标识返回不同格式时,可以用 curl 的 -A 参数带上包含 clash 字样的标识再试,或者改用用户中心里明确标为 Clash 的订阅地址;
  • 重启会中断现有连接。 把执行时间放在不使用的时段。

订阅链接写在定时任务里,等于把账号凭证存在了服务器上。多人共用的服务器要留意文件权限,不要让其他用户读到。

桌面上的其他选择

除了 Clash Verge Rev,Linux 桌面上还有几款可用的图形客户端:FlClash 同样基于 mihomo,提供 Linux 安装包;v2rayN 的较新版本支持 Linux,适合使用节点链接形式订阅的人;Hiddify 基于 sing-box,也有 Linux 版本。它们的导入方式和 Windows 上相同,系统代理不生效时的处理办法也一样。选哪一款主要看机场给的订阅格式,见客户端怎么选。

常见问题

Linux 上系统代理打开了,浏览器还是上不了外网怎么办?

先确认节点本身可用:在代理页测一下延迟,或者在终端里设置环境变量后用 curl 测试。节点没问题的话,多半是当前桌面环境不支持统一的系统代理设置,或者浏览器没有跟随系统代理。可以在浏览器的网络设置里手动填写本机地址和客户端端口,或者改用 TUN 模式。

设置了环境变量,为什么 ping 还是不通?

ping 使用的是 ICMP 协议,而环境变量指定的 HTTP 和 SOCKS 代理只能转发 TCP 连接(部分情况下加上 UDP),两者不是一回事。ping 不通不代表代理没生效,用 curl 访问目标网站才是正确的测试方法。

订阅更新后需要重启内核吗?

裸跑内核时,配置文件是启动时读入的,替换文件后需要重启内核,或者通过内核提供的控制接口重新加载配置才会生效。用图形客户端则不需要操心,更新订阅后客户端会自动应用。

无图形界面的服务器怎么切换节点?

内核提供了一个控制接口,可以配合网页控制面板在浏览器里切换节点,前提是你能安全地访问到这个接口,比如通过 SSH 端口转发,而不是把它直接暴露到公网。嫌麻烦的话,也可以在配置文件里把默认分组设成自动选择或故障转移类型,让内核自己挑可用的节点。

控制接口一定要设置密钥吗?

建议设置。没有密钥时,任何能访问到这个端口的程序都可以查看和修改你的代理设置。只监听本机地址时风险较小,但服务器上往往还有其他用户和服务,加一个密钥成本很低。订阅自带的配置里这一项可能是空的,更新订阅后要重新检查。

在 WSL 里怎么用机场?

通常不需要在 WSL 里再装一套。Windows 上的代理客户端已经在运行,让 WSL 里的程序通过环境变量使用它的端口就行。较新版本的 WSL 支持与 Windows 共用网络的模式,这时直接用 127.0.0.1;默认的网络模式下,需要把地址换成 Windows 主机在 WSL 中看到的 IP,并在客户端里打开允许局域网连接。

服务器上只想让某一条命令走代理,怎么做?

不用 export,把环境变量写在命令前面即可,例如在命令开头加上 https_proxy=http://127.0.0.1:7890,变量只对这一条命令生效,不影响同一个终端里的其他命令。端口同样以你的配置为准。这样比开关全局环境变量更不容易忘记关。

Linux 上的流程跑通之后,如果还想让局域网里的其他设备共用这台机器的代理,可以接着看多设备共用与局域网共享。

本文中的套餐与价格整理自公开资料,核对日期为 2026年11月14日,未经本站实测,购买前请以官网为准。整理方法见这里。

接着读