上手手册

Mihomo 内核命令行教程:Linux 上的配置与运行

2026-10-21 更新约 7 分钟读完进阶
先说结论

在 Linux 上直接使用 Mihomo 内核:从官方仓库发布页获取匹配架构的二进制,建配置目录,写好配置(端口、模式、订阅提供者、策略组、规则),先测试配置,再用 systemd 守护运行,最后谨慎设置外部控制与密钥。适合有命令行基础的人,不熟悉就用图形客户端。

Mihomo内核使用的命令行版本,是整条 Clash 系路线里最“素”的一种:没有窗口,没有按钮,只有一个二进制文件、一个配置目录和一条命令。它适合服务器、软路由、没有桌面的环境,也适合想把一切都掌握在自己手里的人。代价是:一切都要自己负责,包括获取是否可信、配置是否正确、服务是否守护、控制接口是否安全。这篇按“获取、骨架、订阅、运行、守护、安全”的顺序讲,字段与参数以官方文档为准,本文只讲结构。

先问自己:真的需要命令行吗

你的情况 建议
Linux 桌面,日常使用 优先用图形客户端,参考 Clash Verge Rev Windows 教程 的思路
服务器或无桌面环境 命令行合适
软路由 常配合插件使用,见 OpenClash 配置教程
想完全掌握配置 命令行合适,但要有耐心

内核本身的来历与名称,读 Mihomo 是什么。

第一步:获取内核,来源只认官方

官方仓库是 Mihomo 内核官方仓库,文档在 Mihomo(Clash Meta)文档。获取时:

  1. 先确认自己机器的处理器架构,再到发布页挑对应的文件;
  2. 版本号请自己在发布页查看,本文不写;
  3. 若发布页提供校验值,下载后核对;
  4. 放到固定位置并赋予可执行权限,路径自己定,下文用 /usr/local/bin 作示意;
  5. 别用第三方整合包或来路不明的脚本,来源安全见 客户端从哪里下载才安全。

第二步:Mihomo内核使用的第一步,建立配置目录与最小骨架

内核运行时需要一个配置目录,里面放主配置文件。可以先用最小骨架跑通:

mixed-port: 7890
allow-lan: false
mode: rule
log-level: info

这几项分别是:混合代理端口、是否允许局域网使用、运行模式、日志级别。建议一开始保持 allow-lan 为关闭,避免无意中把代理暴露给局域网。mihomo 配置文件的完整字段,请以官方文档为准。

第三步:用提供者引入订阅

不必把节点手写进配置,可以用“提供者”按链接拉取订阅。示意结构如下,其中的链接与路径均为占位:

proxy-providers:
  airport:
    type: http
    url: "你的订阅链接"
    interval: 3600
    path: ./providers/airport.yaml

要点:url 是订阅链接,属于账号凭证,别把配置文件发到任何公开的地方;interval 是更新间隔,单位是秒,不必太短;path 是本地缓存位置。订阅需要是 Clash 风格,格式确认读 订阅有哪几种格式,通用的导入思路读 Clash 订阅怎么导入。

第四步:策略组与规则,先用最简单的

骨架里还需要策略组和规则,才能把节点用起来。给新手的建议:

做法 说明
策略组先用手动选择或故障转移 概念读 策略组是什么
规则先用“国内直连,其余代理” 原理读 规则分流是什么
不要照搬他人的整套配置 来路不明的配置可能有问题
一次只加一块,加完测试 便于定位错误

第五步:测试配置,再运行

写完配置,先别急着启动,用内核的测试参数检查一遍,它会校验语法并退出,不会真的开始代理。具体参数请看命令的帮助输出。通过后,再前台运行一次:

mihomo -d /etc/mihomo

其中 -d 指定配置目录,路径是示意。前台运行时可以直接看到日志,方便发现问题。确认能正常工作后,再交给系统服务管理。

第六步:用 systemd 守护运行

长期运行,建议交给系统服务管理器。一个最简单的服务单元示意如下,路径按你的环境调整:

[Unit]
Description=Mihomo
After=network.target

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

[Install]
WantedBy=multi-user.target

保存为服务文件后,重新加载服务管理器,再启用并启动服务。查看日志可以用系统日志命令,按服务名过滤。出现反复重启,先看日志,多半是配置错误或端口被占用,端口问题读 代理端口被占用怎么办。

第七步:外部控制与面板,安全第一

内核可以开启外部控制接口,供网页面板管理。这是最需要小心的部分:

事项 建议
监听地址 默认只监听本机,不要暴露到公网
访问密钥 必须设置,并足够复杂
局域网访问 确有需要再放开,并检查防火墙
面板文件 只从可信来源获取,别用来路不明的

外部控制接口能管理内核,一旦暴露,别人就能操控你的代理,甚至读到配置里的信息,所以宁可保守。

让命令行的代理对终端生效

内核跑起来之后,终端里的工具要使用代理,通常是通过环境变量指向混合端口,或者在需要的工具里单独设置。如果想让更多程序被接管,可以考虑 TUN,原理读 TUN 模式是什么意思,在命令行环境下它需要相应的权限,要谨慎配置,并检查 DNS,见 DNS 泄露检测怎么做。

怎么确认运行正常

验证项 做法 通过的标志
服务状态 查看服务是否在运行 状态正常,没有反复重启
端口监听 查看混合端口是否被监听 端口处于监听
终端访问 让终端工具走代理访问一个国外站点 能正常访问
订阅更新 等一个更新周期,看缓存文件时间 文件被更新
重启验证 重启机器后再看 服务自动启动

遇到这些症状,先做什么

症状 多半是因为 先试这个
启动即退出 配置语法错误 用测试参数检查,看日志的行号
端口被占用 其他进程占着 查占用者,或换端口
订阅拉不下来 链接错误或网络问题 浏览器验证链接,检查网络
终端不走代理 没设置环境变量 设置代理变量或单独配置
开 TUN 后断网 权限、路由或 DNS 关闭 TUN,逐项排查

用命令行之前,最后问自己三个问题

一是,我是否真的需要命令行,图形客户端能不能满足;二是,我是否能负责这套配置的长期维护,包括订阅更新、内核升级、安全设置;三是,出问题时,我是否知道怎么看日志、怎么回退。三个问题都能肯定回答,再放心用命令行;否则,图形客户端会更省心,也更适合你。

下一步

没选好机场的话,用 选机场向导 缩小范围,再翻 机场推荐榜 核对资料,先买月付档。Mihomo内核使用的核心原则:骨架先小,来源要可信,控制接口别暴露,每次改动先测试。

这篇没有覆盖的
  • 本文只讲结构与思路,配置字段与命令参数请以内核官方文档和命令的帮助输出为准,不写具体版本号。
  • 示例中的路径、端口与占位内容均为示意,请按你的环境调整,不要原样照搬。
  • 本文不提供任何机场的订阅,爱梯子没有节点的速度或稳定性记录。

资料里明确写了支持 Clash 的几家

把 Clash 写进客户端栏的品牌很少。没写不等于不能用,多数机场都能给 Clash 格式的订阅,只是档案里找不到可以核对的说法。

名次机场最低一档流量线路
第 1 名无忧链接¥6.6/月 按年付费40GB/月IPLC、IEPL官网入口

看 Clash 上手手册 → 数据来自机场档案,价格以官网结账页为准。

本文引用的官方来源

这篇的几个常见问题

在 Linux 上一定要用命令行吗?

不一定。Linux 桌面上也有图形客户端可选,它们内部同样使用这个内核。命令行适合服务器、软路由、无桌面的环境,或者喜欢直接掌控配置的人。如果你只是在桌面上日常使用,图形客户端会省事得多。

配置文件里最核心的是哪几块?

基础设置(端口、模式、日志)、节点来源(直接写节点或引用订阅提供者)、策略组和规则。其他功能,比如 DNS、TUN、外部控制,都是在这个骨架上叠加。先让最小骨架跑通,再逐项增加,是最不容易出错的做法。

外部控制面板要注意什么安全问题?

外部控制接口能管理内核,务必不要暴露到公网。默认只监听本机地址,并设置访问密钥。需要局域网访问时再谨慎放开,并确认防火墙设置。面板文件也只从可信来源获取。

怎么确认配置没有写错?

内核通常提供测试配置的命令参数,运行后会检查语法并退出,不会真的启动代理。具体参数以命令的帮助输出和官方文档为准。每次修改配置后先测试,再重启,出错时看日志定位具体的行。