Mihomo Party 日志怎么看:入口、级别与常见报错排查
简答:先打开 Mihomo Party 左侧的“日志”页面,复现一次连接问题,再按同一时间点查看日志;同时打开“连接”页面确认请求是否进入内核、命中了哪个规则和代理组。若界面没有“日志”字样,先检查侧边栏是否折叠,并以当前版本界面为准。官方发布页目前将 v2.0.4 标记为 Latest,该版本新增了日志等级筛选,但不同系统和版本的菜单位置仍可能略有差异。
定义:Mihomo Party 日志是客户端展示 Mihomo 内核运行信息的排错记录,主要用于确认请求是否进入内核,以及 DNS、规则、TCP、TLS 或节点连接在哪一步失败。
先用这条路径看日志:复现一次,再对照连接记录
本站是第三方使用指南站,不是 Mihomo Party 官方站。打开客户端后,先不要马上切换节点或重装软件,按下面顺序保留现场:
- 启动 Mihomo Party,确认当前配置已经启用,并记下代理组或节点名称。
- 点击左侧“日志”或“Logs”;如果看不到,先展开侧边栏,或在设置中恢复默认侧边栏布局。
- 清空当前可见记录或记住当前时间,然后重新访问一个原本打不开的地址。
- 马上回到“日志”页面,按时间顺序查看刚刚产生的记录。
- 再打开“连接”页面,搜索刚才访问的域名,确认它是否出现、使用了哪个策略组、节点或 DIRECT。
这一步的核心不是“看到 error 就换节点”,而是先判断请求有没有进入 Mihomo。连接页面没有目标域名时,优先检查系统代理、TUN、浏览器代理设置或其他 VPN;有目标域名但日志报错,则继续按失败阶段分析。
| 页面或记录 | 主要用途 | 先看什么 |
|---|---|---|
| 日志/Logs | 查看内核实时运行信息 | 时间、级别、域名、错误关键词 |
| 连接/Connections | 确认请求是否被接管 | 目标域名、规则命中、策略组、节点、连接状态 |
| 应用日志 | 查看客户端外壳或启动问题 | 订阅读取、界面、权限、进程启动错误 |
| 内核日志 | 查看 Mihomo 处理请求的过程 | DNS、dial、TLS、代理握手和超时 |
官方 Mihomo API 文档说明,日志流可以按 info、warning、error、debug 级别筛选,并可返回时间、级别、消息和字段等信息;Mihomo Party 的代码也通过内核日志接口读取实时日志。可参考 Mihomo API 文档中的日志接口 和 Mihomo Party 的日志流实现。
日志级别怎么选:先用 info,复现失败再提高级别
日常使用建议保持 info。它能显示一般运行信息,也包含 warning 和 error;如果页面提供筛选器,可以先只看 warning 和 error,再切回 info 看完整时间线。官方配置文档对各级别的定义是:silent 不输出,error 只输出错误,warning 输出警告与错误,info 输出一般运行信息、警告和错误,debug 输出尽可能多的运行信息。详见 Mihomo 通用配置中的 Log Level 说明。
- info:日常排查首选,信息量和可读性较平衡。
- warning:想快速找异常时使用,但可能忽略正常连接过程。
- error:只看明确失败,适合日志很多时缩小范围。
- debug:只在复现问题时短时间使用,不建议长期保持。
如果修改了日志等级但页面没有变化,先保存设置,再重启内核或重启客户端;官方 v1.9.6 发布说明曾记录过“修改 Mihomo 设置后未应用到运行中内核”的修复,说明版本差异确实可能影响设置生效方式。不要把旧版本的入口直接套用到当前版本。
常见日志关键词对照:先判断失败发生在哪一层
| 关键词或现象 | 通常说明 | 下一步 |
|---|---|---|
DNS error、解析失败、no such host | 域名没有成功解析,可能是 DNS 配置、网络或劫持问题 | 检查 DNS 设置、测试其他域名,并暂时关闭冲突的 DNS 软件 |
dial tcp、i/o timeout、timeout | 建立 TCP 连接或等待响应超时 | 先查看连接命中的节点,再测试其他节点;同时检查本地网络和防火墙 |
connection refused | 目标端口主动拒绝连接,也可能是本地端口或远端服务未监听 | 确认代理端口、节点端口和配置是否正确,检查是否有端口占用 |
TLS handshake failed | TLS 握手阶段失败,可能与时间、证书、SNI 或链路有关 | 检查系统时间、域名和节点配置,先用其他节点对照测试 |
| 日志有记录但连接页面没有目标域名 | 当前请求可能没有进入 Mihomo 内核 | 检查系统代理、TUN、浏览器独立代理和其他 VPN |
出现 DIRECT | 该请求被规则分配为直连,不代表节点已生效 | 查看命中的规则,确认是否需要改规则或代理组 |
这些关键词只能帮助定位阶段,不能单独证明节点一定故障。例如 timeout 可能来自本地网络、代理端口、节点链路或目标站点。应使用“同一域名、同一时间、不同节点”的对照方式,避免只凭一行日志下结论。
Windows、macOS、Linux 看不到日志文件怎么办
优先使用应用内的“日志/Logs”入口,因为不同版本、安装方式和便携版的数据目录可能不同。官方 v2.0.4 发布说明确认该版本新增了日志等级筛选;官方 v1.9.6 还提到过核心日志轮转、大小限制和便携版数据目录处理,因此不能把某个旧教程给出的固定路径当作所有系统都适用的结论。版本信息可在 Mihomo Party 官方 Releases 页面核对。
- Windows:先从应用内“日志”或“设置”进入;如果使用便携版,日志可能随应用数据目录保存,需在应用内打开数据目录或使用文件搜索查找包含
clash-party、core、log的文件。 - macOS:优先查看应用内日志;如果日志页面为空,检查客户端是否有权限运行内核,并确认没有被系统安全设置阻止。
- Linux:同样先用应用内入口;若从终端启动,可保留启动终端输出,但不要只依赖终端,因为实时内核日志还可能由客户端通过 API 读取。
如果完全没有日志,按“客户端没有启动—内核没有启动—日志等级为 silent—日志显示被关闭—当前页面没有连接到内核”的顺序检查。不要直接删除配置目录;先关闭客户端、备份配置,再尝试重启内核。
看不到目标域名:按这个决策顺序排查
- 连接页面没有任何记录:先访问一个明确会产生请求的网页,确认浏览器没有使用独立代理;然后检查系统代理或 TUN 是否开启。
- 只有部分应用没有记录:检查该应用是否绕过系统代理,或是否需要 TUN 才能接管。
- 连接页面有记录但状态失败:查看策略组、节点和错误关键词,不要先修改规则。
- 显示 DIRECT:查看规则命中结果。如果规则本来就要求直连,日志中出现 DIRECT 属于预期;如果不符合预期,再检查规则顺序和覆写。
- 日志页面持续空白:检查内核是否运行、日志等级是否为 silent、是否启用了关闭应用日志的选项,然后保存设置并重启内核。
如果开启 TUN 后出现断网,先关闭 TUN,恢复系统代理到原状态,再退出客户端并确认系统网络恢复;不要一开始就执行网络重置。需要继续排查时,可参考站内的 Mihomo Party TUN 模式设置与断网排查。
分享日志前必须脱敏:哪些内容不能原样贴出
日志可能包含访问过的域名、节点地址、内网 IP、订阅地址和配置字段。公开求助前至少隐藏以下内容:
- 订阅 URL、访问令牌、用户名和密码;
- 节点服务器地址、端口、UUID、password、密钥和认证信息;
- 局域网 IP、设备名、文件路径、公司域名和内部服务地址;
- 自定义规则集 URL、DNS hosts 中的私有地址;
- 完整的
config.yaml、profile.yaml或工作目录配置文件。
可保留时间、错误级别、通用错误关键词和脱敏后的规则结果。例如把 https://user:[email protected]/sub/token 改成 https://***:***@example.com/sub/***,把节点服务器改成 node.example.com。日志只用于定位连接问题,不要为了“完整”公开凭据。
一套可复现的最小排错流程
- 关闭其他 VPN、代理增强工具和可能接管 DNS 的软件。
- 在 Mihomo Party 中确认配置已启用,选择一个节点,并保持日志级别为 info。
- 打开日志和连接页面,访问同一个测试地址,记录时间。
- 确认连接页面是否出现目标域名,以及是否命中代理组、节点或 DIRECT。
- 若无记录,排查系统代理、TUN、浏览器设置和内核状态。
- 若有记录,按 DNS、TCP、TLS、拒绝连接的顺序定位失败阶段。
- 只修改一个变量,例如只换节点或只改 DNS,然后重复同一测试。
- 问题解决后,把 debug 调回 info,关闭不需要的抓取和日志窗口。
这套流程能把问题分成“请求未进入客户端”“规则选择不符合预期”“DNS 失败”“节点连接失败”“目标站点或 TLS 阶段失败”五类,比盲目重装或连续更换节点更容易复现。
结论:日志不是测速工具,而是连接路径证据
Mihomo Party 日志最适合回答三个问题:请求有没有进入内核、规则把请求交给了谁、失败发生在 DNS、TCP、TLS 还是代理响应阶段。先用连接页面确认流量,再用日志补充失败原因;如果页面入口、字段名称或日志文件路径与本文不同,以当前版本界面和官方发布说明为准。
常见问题
Mihomo Party 的日志入口在哪里?
通常在左侧边栏的“日志”或“Logs”页面。若看不到,先展开侧边栏;不同版本可能调整菜单布局,当前已核实的 v2.0.4 发布说明提到新增日志等级筛选,但没有给出所有系统统一的固定点击路径。
日志里出现 DIRECT 是不是节点失效?
不一定。DIRECT 表示该请求被规则分配为直连。先在连接页面查看命中的规则;如果规则本来要求直连,这是正常现象,只有不符合预期时才需要检查规则顺序或覆写。
日志里有 timeout,应该马上换节点吗?
不建议马上下结论。先确认请求是否进入 Mihomo,再查看连接页面命中的节点,随后用同一域名更换一个节点做对照。如果所有节点都超时,还要检查本地网络、端口、防火墙或目标站点。
为什么日志页面是空的?
依次检查内核是否运行、是否真的复现了请求、日志等级是否为 silent、是否关闭了应用日志,以及客户端是否连接到了正在运行的内核。保存设置后可先重启内核,再重启客户端。
debug 日志要一直开着吗?
不建议。debug 会输出更多运行信息,适合短时间复现问题;定位完成后调回 info,减少无关记录和隐私暴露。Mihomo 官方文档将 debug 定义为尽可能多输出运行信息。
分享 Mihomo Party 日志时要隐藏什么?
至少隐藏订阅 URL、令牌、节点地址、UUID、password、密钥、内网 IP、公司域名和完整配置文件。可以保留时间、错误级别和脱敏后的错误关键词。