先确认适用条件
适用于电脑上曾运行多个 mihomo 客户端,或同时管理本机和路由器,出现面板显示的模式、节点或流量与当前应用不一致。重点排查控制面板是否连到了另一实例,而不是重复导入订阅。
先区分原因与影响范围
仪表盘是控制界面,external-controller 指定的是它连接的内核 API。页面能打开不证明正在控制预期内核;两个实例版本相同,也不表示它们使用同一配置、端口或流量入口。
按顺序检查,每次只改一项
- 在预期客户端的有效配置或诊断界面记录控制器地址与监听端口,再对照仪表盘保存的连接配置。127.0.0.1 指浏览器所在设备,不能代表另一台路由器。
- 先只读查看版本和基本配置,不点重启、更新或清空连接。官方 API 的 GET /version 返回版本,GET /configs 返回运行中的基本配置;PUT、PATCH 等同路径操作可能写入,不能混用。
- 比较当前运行模式、mixed-port 等实际配置与预期客户端。敏感字段留在本机,不公开完整配置或 secret;通过已信任的本地面板使用现有认证即可,不为排查解除认证。
- 从需要排查的应用发起一个无敏感信息的新请求,在预期实例的连接记录中查找。如果面板没有记录,再检查应用是否接入另一个代理端口或根本绕过代理。
- 确认错连后,仅修改面板保存的控制器目标,再重复只读比较与请求测试。暂时不要停掉不明后台进程,以免影响其他用户或服务。
| 只读观察 | 证据边界 |
|---|---|
| GET /version | 确认版本,不能唯一识别实例 |
| GET /configs | 比较当前基本配置,不代表原始 YAML 全文 |
| 新请求的连接记录 | 把实际流量与目标实例关联起来 |
| 页面标题与收藏夹名称 | 只是界面标签,不是内核身份 |
怎样确认已经恢复
控制器目标、运行配置和同一次新请求的记录应相互对应。版本号相同、流量曲线在动或页面成功登录,任何单项都不足以证明找对实例。
未恢复时如何回退与求助
保存原面板连接配置后才修改,必要时可恢复。若控制器认证失败,转查 secret 和 CORS;若运行配置正确但应用仍无记录,继续检查应用代理入口,不重新安装整个客户端。