Clash Meta Linux 安装教程:Ubuntu 无界面与 systemd
为什么还要专门写一篇纯命令行的 Clash Meta Linux 教程
很多人平时的用法是:Windows 上用图形客户端一键导入订阅,macOS 上点菜单栏图标,Android 上授权 VPN 权限。可一到 Ubuntu、Debian 桌面、开发机,或者一台不接显示器的小主机,就希望同样的 Clash Meta(社区版本多标为 Mihomo 内核)能在没有图形界面的情况下长期跑着:开机自己起来、崩了自己拉起、日志能查。这是 Linux 代理客户端放到实际环境里最常见的要求,也补上了本站其他平台教程没覆盖的部分。
规则分流的大道理这里不再展开——还没搞清 Meta 系配置整体长什么样的,先看 Clash Meta 升级指南 和 分流规则配置教程。这篇只讲一件事:在 Linux 上把内核进程变成受控的系统服务,并且把 systemd 开机自启一次配对。
config.yaml 的用法都一样。 第一步:准备系统、规划目录
下载任何二进制之前,先定一个专门的目录,别让可执行文件散在下载文件夹里。可以在自己家目录下建 ~/clash-meta,也可以用 /opt/clash-meta(要 root 配合改权限),里面放内核程序、主配置文件,以后再加的规则缓存和 Geo 数据也放这。
确认你对这个目录能读能写;放在 /opt 下的话,用 chown 把目录交给实际跑代理的那个用户,后面 systemd 单元里 User= 也写同一个,否则会出现服务看着起来了、其实一直在重启的权限问题。基础工具还没装,就运行 sudo apt update 和 sudo apt install -y curl ca-certificates,方便核对下载和走 HTTPS。
第二步:拿到 Clash Meta(Mihomo)内核程序
Linux 版内核多以压缩包发布,文件名里写着架构(如 linux-amd64、linux-arm64)和版本号。先跑 uname -m 看架构:x86_64 选 amd64,aarch64 选 arm64。解压到上一步建好的目录,会得到一个可执行文件,社区里多叫 mihomo,有的包仍叫 clash-meta,两者是同一种 Meta 内核。
安全起见,从项目的官方 Release 页下载,并对照发布说明里的校验值。平时找安装包可以直接用本站 Clash 客户端下载页,那里的安装包取自官方 GitHub 发布页;要核对上游哈希或去社区提问时,再单独打开代码托管平台,别把下载程序和看 Issue 搅在一条来历不明的链接里。
文件放好后运行 chmod +x ./mihomo(按你实际的文件名),再用 ./mihomo -v 看能不能打印版本,顺便确认架构和动态库没问题。提示少了共享库的话,Ubuntu 上装 libc6 之类的基础包多半就能解决,具体看报错写的是什么。
第三步:写一份能跑起来的最小 config.yaml
Clash Meta 的工作目录用启动参数 -d 指定,目录里要有 config.yaml(或者启动参数里另外指定的文件)。最少要写清从哪里接流量和从哪里出去:比如用 mixed-port 一个端口同时提供 HTTP 和 SOCKS,终端和浏览器都能用;再写 proxies、proxy-groups,最后是 rules。节点来自机场订阅的话,把订阅地址放进 proxy-providers,让内核定时拉取并填进策略组——订阅和多来源怎么管理,可以看 订阅链接使用教程。
顺手把 external-controller 打开(比如监听 127.0.0.1:9090),就能通过 HTTP API 看连接、切节点;一定要配 secret,不然局域网里别的程序也能改你的运行状态。只在本机用,控制器绑在回环地址上就能少暴露一些。dns 段和 TUN 相关设置看你分流要多细再加;暂时不需要全局接管,就把模式留在 rule,并确保本机回环和局域网网段走 DIRECT。
config.yaml 里的订阅地址、secret 和个人规则都属于敏感内容;备份放私有存储或加密打包,文件权限也收紧(比如 chmod 600 config.yaml)。 第四步:前台运行,确认代理能用
接入 systemd 之前,一定先在前台跑一遍确认配置没错。在配置目录下运行 ./mihomo -d /path/to/your/dir,看输出里有没有端口就绪、规则加载完成之类的提示。再开一个终端,用 curl -x http://127.0.0.1:混合端口 去访问一个测试地址,核对出口 IP 和策略组是否如你所想。只想验 SOCKS,就用 curl --socks5-hostname 127.0.0.1:端口。
启动就报错,先查 YAML 缩进有没有混进制表符、订阅拿回来的是不是登录页而不是 Clash 配置、系统时间是否偏差太大导致 TLS 失败。这些问题跟是不是 Linux 无关,只是没有图形界面时你只能靠日志文字,从第一条报错开始看能省下大把时间。想弄清 TUN 和命令行工具之间的关系,可以参考 TUN 模式详解 里的分层讲解;Linux 上开 TUN 要额外的权限或能力位,新手先把 mixed 端口用稳,再考虑内核栈模式。
第五步:写 systemd 服务文件
前台验证没问题,就可以把这条启动命令交给 systemd。在 /etc/systemd/system/clash-meta.service(名字可改)里分三段写:[Unit] 写依赖,用 After=network-online.target 搭配 Wants=network-online.target,避免网络没好就先启动代理;[Service] 写运行用户、工作目录、ExecStart 的完整命令,并加上 Restart=on-failure 和合适的 RestartSec;[Install] 里写 WantedBy=multi-user.target,系统进入多用户模式时就会自动启动它。
ExecStart 里的程序和配置目录都用绝对路径,别依赖 shell 当前所在的位置。想让 journal 统一收日志,就用默认的 Type=simple,再用 journalctl -u clash-meta -f 实时查看;进程会 fork 才需要 Type=forking,Mihomo 本身在前台循环,用前者就行。非要用 root 跑服务(不建议)的话,得清楚权限放大的后果;稳妥的做法是普通用户、最少权限,真用到 TUN 时再去处理 capabilities 或设备权限。
第六步:启用、马上启动、开机自启
写好单元文件后运行 sudo systemctl daemon-reload,再运行 sudo systemctl enable --now clash-meta。enable 管开机自启,--now 管立即启动,一条命令把两件事都办了。systemctl status clash-meta 里看 Active 这一行,是 active (running) 且没有醒目的红色报错,就说明进程已经归 systemd 管了。
重启后运行 systemctl is-enabled clash-meta,返回 enabled;再用 ss -lntp 或 curl 验一下代理端口,确认这台机器上的 Linux 代理客户端开机登录后就能直接用。用 NetworkManager 又遇到拨号顺序问题的,有时得让服务晚一点启动,可以给单元加更细的依赖或少量延迟——前提是日志能复现问题,别凭感觉一味加等待时间。
长期运行:日志、升级和 API
长期跑着的机器,升级步骤固定下来:下新程序、核哈希、停服务、换文件、启动、简单回归一下。进程还没停就把程序文件换掉,结果说不准,别这么做。外部控制接口要默认「本机其他用户的进程也能访问回环地址」,所以 secret 和防火墙两头都要顾。
桌面环境下要配合浏览器扩展,让系统代理指到本机的 mixed 端口就够了;只在命令行里干活的,用环境变量或 proxychains 这类工具挂代理——这些跟 Meta 内核在 Ubuntu 上怎么装没关系,但内核服务先稳住始终排在最前面。
常见问题与排查顺序
服务反复重启怎么办
看 journalctl -xeu clash-meta 最后那几行;大多数是配置路径写错、程序没有执行权限,或者工作目录权限不够。检查 User= 指定的用户能不能读这个目录,config.yaml 的名字和位置有没有被改过。
端口已被占用
用 ss -lntp 看看是哪个进程霸着 mixed 端口或 API 端口;常见情况是上回前台调试忘了关,或者装了别的代理软件在抢。把它停掉,或者在配置里换个监听地址,再启动服务。
Linux 上先不开 TUN 行不行
行。很多开发场景用 mixed 端口加规则就够了;TUN 牵涉路由和权限,排查起来麻烦得多。等 mixed 模式稳定了,再照内核文档加上 tun 段,并给足相应的 capability。
和本站文档、下载入口怎么配合
把 Linux 无界面部署讲清楚,目的是让你不管在哪台桌面或服务器上,都能用同一套「订阅、规则、策略组」的写法;它和 Windows、macOS、Android 上的图形引导其实是一回事的两种形式。字段含义和进阶功能需要查的时候,对照本站 使用文档中心 里的 YAML 说明。
与其每次在终端里临时 export 一堆代理变量,不如把一套验证过的 Clash Meta Ubuntu 配置交给 systemd,少了「终端一关就失效」的麻烦,以后维护起来也更有数。想在图形界面里有和手机上类似的切换操作,可以从本站 Clash 客户端下载页 再装一个其他平台的客户端配合着用;纯 Linux 的工作方式里,命令行加服务化才是长久之计。
程序装好、配置跑通、服务也设成开机自启之后,可以再去本站 下载页 给其他设备装上同类客户端,规则和订阅的管理方式保持一致;比起每个平台各用一套互不兼容的工具,内核和配置思路统一下来省心得多。→ 免费拿一份 Clash 客户端,装好就能开始用