一、先定位问题出在哪一层
Mihomo Party 连接失败，表现通常是「节点测速全红」「系统代理已开启但打不开网页」「TUN 模式启动失败」或「订阅更新报错」。排查思路是自上而下分四层：订阅配置层 → 内核运行层 → 系统代理层 → DNS 解析层。按顺序检查，绝大多数问题都能在三分钟内定位。
二、订阅与配置文件排查
1. 订阅链接是否已失效
- 在订阅页面点击「更新」，观察是否提示 403 / 404 / timeout。
- 把订阅链接直接粘贴到浏览器打开，正常应返回一段 Base64 或 YAML 文本；若返回登录页或报错，说明链接已过期或需要重新获取。
- 部分机场对 User-Agent 有校验，可在订阅设置中把 UA 改为
clash-verge/v1.0.0或mihomo/1.18.0后重试。
2. 配置文件语法错误
手动编辑过 YAML 的用户要特别注意缩进。YAML 不允许使用 Tab 缩进，冒号后必须跟一个空格。语法错误会导致内核启动即崩溃，表现为「已启动但无任何节点」。
验证方法：在「配置」页查看内核日志，若出现 yaml: line X: did not find expected key，请恢复到原始订阅文件后重新改动。
三、内核与运行环境排查
1. 内核未正确下载
首次使用时 Mihomo Party 需要下载 mihomo 内核。若处于无代理环境，下载会失败。解决办法：在「设置 → 内核」中手动指定已下载好的内核文件，或先通过其他网络环境完成一次内核下载。
2. 端口被占用
默认混合端口为 7890，控制端口为 9090。若本机已有 Clash、v2rayN、Docker 等服务占用同名端口，内核会启动失败。日志中常见 bind: address already in use。
处理方式：在「设置 → 端口」中把混合端口改为 7891 或其他空闲端口，控制端口改为 9091，保存后重启内核。
3. TUN 模式权限不足
- Windows：右键以管理员身份运行 Mihomo Party；或在设置中安装「服务模式」，之后即可免管理员权限启用 TUN。
- macOS：首次开启 TUN 会弹出系统授权，需在「系统设置 → 隐私与安全性」中允许网络扩展；若被拒绝，删除扩展后重新开启 TUN 触发授权。
- Linux：需要
cap_net_admin权限，可执行sudo setcap cap_net_admin,cap_net_bind_service+eip /path/to/mihomo。
4. 系统时间不同步
时间偏差超过几分钟会导致 TLS 握手失败，报错多为 x509: certificate has expired or is not yet valid。开启系统自动校时后重试即可。
四、DNS 与分流规则排查
1. DNS 污染或解析失败
日志出现 dns resolve failed、no such host 时，建议在配置中启用 fake-ip 模式，并把 nameserver 指向可信 DNS。示例片段：
dns:
enable: true
enhanced-mode: fake-ip
fake-ip-range: 198.18.0.1/16
nameserver:
- https://223.5.5.5/dns-query
- https://1.1.1.1/dns-query2. 规则模式导致「看着连上了却打不开」
- 把模式切换为「全局」测试一次。若全局正常、规则模式异常，说明是规则集或分流配置问题。
- 检查是否存在
GEOIP,CN,DIRECT之类的规则把目标域名误判为直连。 - 更新 GeoIP / GeoSite 数据库：设置中点击「更新 GEO 数据」。
五、常见报错速查表
| 报错提示 | 可能原因 | 解决方向 |
|---|---|---|
| bind: address already in use | 端口被占用 | 更换混合端口/控制端口 |
| permission denied（TUN） | 权限不足 | 管理员运行或安装服务模式 |
| yaml: did not find expected key | 配置文件语法错误 | 检查缩进，恢复原始配置 |
| dns resolve failed | DNS 污染或未启用 | 开启 fake-ip，更换 nameserver |
| context deadline exceeded | 节点不可用或超时 | 测速换节点，检查订阅是否过期 |
| certificate has expired | 系统时间偏差 | 开启自动校时 |
六、仍然连不上？按这个顺序重置
- 退出 Mihomo Party，确认后台无残留进程（任务管理器搜索 mihomo）。
- 关闭系统代理和 TUN，避免残留虚拟网卡导致断网。
- 更换一个全新订阅链接并重新导入。
- 把内核与客户端都升级到最新稳定版。
- 如使用蜂窝网络或公司网络，确认防火墙、安全软件未拦截 7890 端口与 mihomo 进程。
- 开启「日志」面板并调到 debug 级别，把报错复制出来搜索，定位效率最高。
最后提醒：代理工具请仅用于合法的跨境办公、学术检索与业务测试场景，并遵守所在地相关法律法规。