FIND THE NEXT CHECKmihomo.cyou / 独立中文指南
CHECK / 10故障排查 / NOTE 10

一份有用的 Mihomo 排错记录,应该怎么写

保留可复现步骤和关键错误,删除账户链接与密钥。具体信息往往比一整屏日志更有效。

Mihomo 排错手册 · · 约 3 分钟阅读

“软件不能用”很难让别人判断下一步,而直接发送全部配置又可能泄露订阅和密码。有效的排错记录,应让对方复现现象,同时只包含必要信息。

环境先写清楚

记录操作系统与架构、客户端版本、实际内核版本,以及系统代理还是 TUN。客户端和内核是两条版本信息;只写“最新版本”过一段时间就无法对照。

补充网络环境,例如家庭 Wi-Fi、热点或办公 VPN,同时说明正常基线是否可用。无需公开精确地址与账户,重点是可能影响解析和路由的差异。

排错记录:版本与环境 → 最小复现 → 脱敏后的证据排错记录 · 概念示意01版本与环境02最小复现03脱敏后的证据用于解释正文步骤,不是软件操作界面或实时检测结果排错记录:版本与环境 → 最小复现 → 脱敏后的证据排错记录 · 示意01版本与环境02最小复现03脱敏后的证据
保留必要信息,隐藏订阅、密码和内部资源。

Party 用户还要记录实际选用的内核

Clash Party(原 Mihomo Party)当前项目说明包含 Smart 与 Mihomo 内核选择。报错记录里应写明实际使用了哪一个及其版本,不能只写“Party 最新版”。客户端相同,实际内核和生成配置也可能不同;先保留配置副本,再以相同条件对照,才容易判断问题发生在哪一层。

用一个最小操作描述现象

选择一个可以稳定出现问题的动作,写出预期结果和实际结果。比如打开某个页面后,连接记录出现了什么规则、哪个出口,以及日志给出的错误。不要把几个不同时段的故障混在一张截图里。

写明已经做过的对照:系统代理是否正常、是否只在 TUN 失败、是否只影响一个应用。一次只改变一个变量得到的结果,通常比尝试过十种“优化”更有帮助。

发出之前做脱敏

隐藏订阅完整 URL、节点服务器凭据、控制 API 密钥、账户标识和不必要的内网信息。需要保留结构时,用 example.com 等示意值替换,并标明已经替换,避免别人把样例当作真实测试目标。

日志只截取与复现时间相邻的部分,保留第一条明确错误和上下文。最后补上最近一次正常工作的状态,以及此后改动了什么。这样一份记录既方便别人协助,也方便你下次遇到类似问题时自己快速恢复。

继续核对资料

MetaCubeX / Mihomo 项目Mihomo 文档TUN 配置文档Clash Party 的内核、覆写与备份说明

按 2026-10-21 可读项目资料整理。界面与参数可能随版本变化,请对照实际运行版本。

接下来可以看。

返回全部文章 →