Mihomo Wiki 怎么看?文档核验、配置测试与排障路径
简答:一句话结论:搜索“mihomo wiki”时,先看 <a href="https://wiki.metacubex.one/">Mihomo 文档</a>,下载文件再看 <a href="https://github.com/MetaCubeX/mihomo/releases">项目 Releases</a>,不要把旧 Wiki、图形客户端和内核混为一谈。本文给出入口核验、文件选择、最小配置、-t 测试和常见排障步骤;不涉及服务商套餐、节点质量或速度承诺。
定义:Mihomo 是一个独立运行的代理内核,项目文档说明配置字段和运行方式,图形客户端则可能负责下载、调用或管理这个内核。
先用这张表找到正确入口
如果你只是想知道“mihomo wiki 在哪里”,先按用途选择入口。旧 GitHub Wiki 首页已经提示内容迁移到新的文档站,因此旧页面更适合确认项目关联,不应当作为完整配置手册。
| 你要解决的问题 | 应查看的页面 | 使用方法 |
|---|---|---|
| 查看配置字段和功能说明 | Mihomo docs | 从配置、启动、API、DNS 或 TUN 目录进入对应章节。 |
| 下载可执行文件 | Releases | 以当前发布页的稳定版或预发布标签为准,再筛选系统和 CPU 架构。 |
| 确认旧 Wiki 是否完整 | GitHub Wiki | 查看迁移提示,不要仅凭旧页面判断当前文档是否齐全。 |
| 查看启动与服务方式 | Startup 文档 | 查找命令行参数、目录、systemd 等启动说明。 |
项目文档、Releases 和图形客户端不是同一个东西:文档解释字段,Releases 提供构建资产,客户端可能内置或调用某个 Mihomo 版本。客户端内核版本、配置生成方式和界面菜单应以对应客户端资料为准,不能直接用一个项目的页面推断另一个客户端的行为。
下载前怎么核对系统、架构和文件名
不要根据搜索结果中的“最新版”或第三方下载按钮直接判断文件。打开项目 Releases 页面后,先确认发布标签、资产名称和校验信息;版本会变化,本文不把某个版本号写死。
- 确认操作系统。先判断自己使用的是 Windows、macOS、Linux、FreeBSD、Android 或其他受支持环境,再在资产列表中选择对应系统名称。
- 确认 CPU 架构。常见标签可能包括
amd64、386、arm64或armv7。Windows 的普通 64 位 Intel 或 AMD 电脑通常需要在系统信息中确认架构后再选择。 - 理解兼容标签。同一架构可能出现
compatible、v1、v2、v3或不同go标签。无法确认 CPU 指令集时,优先选择项目说明中标注为兼容范围更广的文件;具体含义应以项目 FAQ 和发布页为准。Mihomo FAQ - 先核验压缩包,再解压。如果发布资产列出 SHA-256,应对刚下载的原始
.zip、.gz或其他压缩包计算摘要,再与发布页对应值比较。不要把压缩包的摘要拿去和解压后、改名后的可执行文件比较。 - 记录实际文件名。Windows 解压后的文件可能仍带系统和架构后缀。若后续命令写成
mihomo.exe,要先把实际文件改名为mihomo.exe,或者始终使用解压出的完整文件名。
例如,文件名应使用发布页实际显示的形式,可用 mihomo-windows-amd64-<版本号>.zip 或 mihomo-linux-amd64-<版本号>.gz 表示命名结构;尖括号只是说明版本位置,不是需要直接下载的文件名。
最小 config.yaml:先用 -t 验证,再逐项增加功能
第一次排查时,不要直接粘贴包含节点、订阅、DNS、TUN 和大量规则的完整配置。先验证内核能否读取一份最小配置,可以把“程序文件问题”和“配置或订阅问题”分开。
mixed-port: 7890
allow-lan: false
mode: rule
log-level: info
rules:
- MATCH,DIRECT
这个示例没有在 proxies 中自定义名为 DIRECT 的代理条目,而是直接引用内置策略,避免自定义名称与内置策略重复。配置字段的最终行为仍以对应版本的 Configuration 文档为准。
- 在准备好的配置目录中创建
config.yaml,粘贴最小内容并保存为 UTF-8 文本。 - 确认内核文件能运行。Linux 或 macOS 可执行
./mihomo -v;Windows PowerShell 如果文件已经改名,可执行.\mihomo.exe -v。 - 执行配置测试。Linux 或 macOS 示例:
./mihomo -t -d ./data -f ./data/config.yaml。Windows PowerShell 示例:.\mihomo.exe -t -d .\data -f .\data\config.yaml。 - 判断结果。命令正常退出,说明这份配置至少通过了解析测试;如果出现 YAML 缩进、字段不存在、端口或名称重复等报错,按错误行修改后重新执行
-t。 - 测试通过后,再一次只增加一类内容,例如先增加一个代理,再增加代理组,最后增加规则或 Provider。每次改动后都重新执行
-t。
-t 只能帮助检查配置解析,不能证明节点可用、DNS 没有问题或 TUN 已经接管流量。若配置通过但连接仍失败,应继续检查端口监听、规则匹配、DNS、系统代理或客户端内核兼容性。
配置结构怎么读:代理、代理组、规则和 Provider
读 Mihomo Wiki 时,可以把配置拆成几个相互关联的部分,而不是把 YAML 当作一整块内容。
- 代理节点。通常放在
proxies中,描述一个具体出站连接。协议类型、认证字段和传输参数必须按照对应协议文档填写。 - 代理组。通常放在
proxy-groups中,用于手动选择、自动选择或故障切换。组内引用的名称必须真实存在,包含内置策略时也要使用正确名称。 - 规则。放在
rules中,通常按从上到下的顺序匹配。排查“某个域名走错出口”时,先检查规则顺序,再检查规则指向的代理组。 - proxy-providers。用于加载代理集合,涉及订阅地址、缓存文件和更新格式。订阅地址通常包含访问令牌,复制日志或截图前应先打码。
- rule-providers。用于加载规则集合,同样需要检查 URL、格式、保存路径和更新结果。
相关字段可以从 配置总目录、proxy-providers 文档和 rule-providers 文档分别查找。不要拿某个图形客户端导出的字段,直接推断纯命令行配置一定支持。
DNS、TUN 和 API:先确认用途,再逐项开启
DNS、TUN 和控制接口解决的是不同问题。建议先使用 mixed-port 验证基础代理入站,再根据实际需求增加其他模块。
- DNS。负责域名解析。出现域名打不开、解析地址异常或缓存结果不一致时,再对照 DNS 文档检查 nameserver、fake-ip、缓存和监听设置。
- TUN。用于接管更广泛的系统流量,可能涉及虚拟网卡、路由、DNS 和系统权限。开启后无法连接时,先关闭 TUN,用 mixed 入站验证基础连接,再按 TUN 文档逐项检查。
- external-controller。用于本地管理接口或控制面板。只在确有需要时开启,并设置
secret;不要为了测试把控制端口直接暴露到不受信任的网络。
如果接口已经在本机监听,可用 API 文档中的版本接口进行验证:Linux 或 macOS 可执行 curl -H 'Authorization: Bearer <secret>' http://127.0.0.1:<端口>/version。Windows PowerShell 5.1 建议明确使用 curl.exe -H "Authorization: Bearer <secret>" http://127.0.0.1:<端口>/version,或者使用 Invoke-RestMethod -Headers @{Authorization='Bearer <secret>'} -Uri 'http://127.0.0.1:<端口>/version'。微软文档说明,PowerShell 5.1 中的 curl 是 Invoke-WebRequest 的别名,而 PowerShell 7+ 不定义这个别名。Mihomo API 文档 Microsoft Learn:curl on Windows
Linux 常驻运行:systemd 的最小排查路径
如果你需要在 Linux 上让 Mihomo 作为服务运行,先手动验证配置,再交给 systemd。项目文档提供了以 -d /etc/mihomo 指定工作目录的服务思路,具体目录和权限仍应按发行版调整。systemd 服务文档
- 完成压缩包摘要核验、解压并确认可执行文件名,再执行
sudo mv <实际文件名> /usr/local/bin/mihomo。 - 创建配置目录:
sudo mkdir -p /etc/mihomo,将已经测试过的config.yaml放入其中。 - 测试最终路径:
sudo /usr/local/bin/mihomo -t -d /etc/mihomo -f /etc/mihomo/config.yaml。 - 创建
/etc/systemd/system/mihomo.service,最小核心内容可写为:[Unit]。
After=network-online.target
[Service]
ExecStart=/usr/local/bin/mihomo -d /etc/mihomo
Restart=on-failure
[Install]
WantedBy=multi-user.target - 执行
sudo systemctl daemon-reload和sudo systemctl enable --now mihomo,再用systemctl status mihomo、journalctl -u mihomo -o cat -e查看结果。
如果 -t 已通过但服务仍退出,按“文件权限→工作目录→端口占用→服务用户→TUN 权限→日志内容”的顺序检查,不要一次修改多个变量。
常见错误与处理顺序
- 命令提示找不到文件:先列出解压目录中的实际文件名。Windows 需要确认是否已经改名为
mihomo.exe;Linux 或 macOS 还要确认文件具有执行权限。 - 配置提示重复名称:检查
proxies、proxy-groups和规则引用,尤其不要重复自定义内置策略名称。 - 端口被占用:确认
mixed-port、控制端口和 DNS 监听端口,再使用系统工具定位占用进程。不要只改端口而忽略旧进程仍在运行。 - TUN 开启后无法连接:先关闭 TUN 验证 mixed 入站,再检查虚拟网卡、路由、DNS 和权限。
- 升级后报错:保留旧内核、配置和日志;先对新文件执行
-v,再对最终配置执行-t,确认后再替换常用文件。 - 订阅或日志泄露:订阅 URL、控制接口密钥和认证字段不要直接贴到公开工单、截图或聊天记录中;需要反馈时先脱敏。
结论:把 Mihomo Wiki 当作任务导航,而不是单一下载页
搜索“mihomo wiki”时,最稳妥的顺序是:先用项目文档确认字段和命令,再用 Releases 选择系统与架构对应的资产,下载后在解压前核验摘要,随后用最小配置和 -t 完成基础验证。只有基础配置通过后,才逐项加入代理、规则、Provider、DNS、TUN 或控制接口。
本文是第三方使用指南,不是 Mihomo 或任何客户端的官方网站。页面中的版本号、资产列表和客户端内置内核都可能变化,实际操作应以项目当前文档、发布页以及你所使用客户端的说明为准。
常见问题
搜索到的 Mihomo Wiki 为什么有多个入口?
项目文档、GitHub Wiki、Releases 和图形客户端承担不同职责。配置字段优先看项目文档,下载资产看 Releases,旧 GitHub Wiki 先查看迁移提示,客户端界面和内核版本则以客户端自身说明为准。
Mihomo 配置测试命令怎么写?
常用形式是 <code>mihomo -t -d <配置目录> -f <配置文件></code>。Linux 或 macOS 可写 <code>./mihomo -t -d ./data -f ./data/config.yaml</code>;Windows PowerShell 可写 <code>.\mihomo.exe -t -d .\data -f .\data\config.yaml</code>。
为什么最小配置不应该自定义 DIRECT?
为了减少名称冲突,最小示例直接在规则中引用内置的 <code>DIRECT</code>,不再在 <code>proxies</code> 中创建同名条目。这样更适合先验证 YAML 和基础字段。
下载 Mihomo 后应先解压还是先算 SHA-256?
如果发布页提供摘要,应先对下载完成的原始压缩包计算 SHA-256,再解压。压缩包摘要不能直接拿来比较解压或改名后的可执行文件。
Windows PowerShell 中为什么建议写 curl.exe?
Microsoft Learn 说明,Windows PowerShell 5.1 中 <code>curl</code> 是 <code>Invoke-WebRequest</code> 的别名,参数与真实 curl 不完全相同。写成 <code>curl.exe</code>,或改用 <code>Invoke-RestMethod</code>,更容易按示例执行。
配置通过 -t 是否代表节点一定可用?
不是。<code>-t</code>主要用于配置解析测试,不能证明节点、DNS、规则、TUN、路由或远端服务正常。连接问题需要继续按端口、规则、DNS、系统代理和 TUN 分层检查。
相关阅读
- 先了解 Mihomo 内核与客户端的关系
- 继续看 Mihomo Linux 安装与 systemd 配置
- 查看 Mihomo 安卓客户端配置步骤
- 排查 Mihomo DNS 解析与泄漏问题
- 继续定位节点、DNS 还是 TUN 导致的变慢
参考资料
- Mihomo docs
- Startup - mihomo docs
- Configuration - mihomo docs
- DNS configuration - mihomo docs
- TUN configuration - mihomo docs
- proxy-providers configuration - mihomo docs
- rule-providers configuration - mihomo docs
- APIs - mihomo docs
- Create a running service - mihomo docs
- Releases - MetaCubeX/mihomo
- Home - MetaCubeX/mihomo Wiki
- FAQ - MetaCubeX/mihomo Wiki