适用条件与现象
适用于浏览器面板连接 mihomo TCP/HTTPS 控制 API。面板资源可以来自本地或其他地址,因此页面加载与 API 请求成功不是同一个事实。
先区分原因
external-controller 指定 API 监听位置,secret 用于 API 访问认证;浏览器还会检查跨域条件,external-controller-cors 设置允许的来源。CORS 允许某来源不等于该来源自动通过认证,也不能代替访问密钥。
按顺序操作
- 在面板设置中核对 API 协议、主机和端口;如果面板在手机打开,127.0.0.1 指向手机本身,而非电脑内核。
- 在浏览器网络面板查看失败 API 请求的地址、状态和错误类型,区分无法连接、认证被拒和浏览器跨域拦截,分享前去掉访问密钥。
- 将面板保存的 secret 与本机运行配置核对;若是跨域错误,只允许实际需要的面板来源,并按协议和端口精确核对。
- 刷新后确认 API 返回真实节点和策略状态,再执行一次可恢复的本地选择操作并读回结果,避免仅凭空列表消失判定正常。
怎样确认结果
API 请求通过认证、浏览器能读取响应、面板显示与内核运行状态一致。若只是静态页面打开或缓存仍显示旧节点,应记为尚未验证 API。
失败后的恢复与下一步
恢复原 API 地址与来源配置,清理测试面板保存的临时密钥。不要通过把 secret 清空、CORS 全放开或将控制接口暴露公网来掩盖定位问题。