面板能够打开,却一直显示未连接,不代表代理已经停止工作。网页文件可以成功加载,管理接口却连不上;反过来,管理按钮能操作,也不证明某个网站一定可达。将这三件事分别验证,才能避免误改正常的业务连接。
先给三个端口命名
网页面板是界面资源,控制 API 接受管理请求,代理入口处理应用流量。它们可能部署在同一设备,但并非同一种协议或用途。mihomo 的 external-controller 配置用于管理 API,并可配置访问密钥;外部界面是另一项配置。mihomo:外部控制与界面。
因此,面板要求填写“后端地址”时,不要填浏览器当前的代理端口。也不要把订阅地址当作控制地址,它既不提供面板管理能力,还可能泄露凭据。
从核心本身开始检查
确认核心确实运行、配置加载成功,再查看实际控制监听地址。界面配置文件中的旧值,可能被应用设置覆盖;应以当前运行状态为准。在同一台电脑使用时,优先使用项目支持的本地控制方式,并核对端口与认证信息。
错误也有层次:连接被拒绝常需检查监听是否存在;超时需要检查路径;认证失败则核对密钥及客户端填写方式。只看“连接失败”的总提示不够,可以从面板提示或浏览器开发工具获得错误类别,但分享截图前须遮去密钥与私密地址。
再检查浏览器与地址关系
HTTPS 页面访问不符合浏览器安全要求的本地接口,或跨来源请求缺少适当配置,都可能受到限制。应按核心和面板正式文档设置匹配的访问方式;不要关闭浏览器整体安全机制,也不为了省事把允许来源设为任意来源并把接口开放到所有网卡。
如果面板运行在另一台设备,127.0.0.1 指的是那台设备自己。远程管理必须重新设计监听、认证与网络限制,不能靠随意换成公网地址解决。仅为本机切换节点时,没有必要扩大控制接口的访问范围。
用读操作验收,再恢复管理
- 面板能够读取预期核心的基本状态。
- 显示的配置、节点与本机实际环境一致。
- 执行一个可恢复的管理动作,观察核心确认结果。
- 发起新的业务请求,验证代理出口仍按预期工作。
可以先读取版本或连接列表,不要一连上就覆盖整份配置。如果控制的是错误实例,面板看起来正常也会改变另一套环境。关闭旧面板标签、保存正确的本地入口,并清理不再需要的临时控制配置。
管理密钥不同于节点密码和订阅 token,应独立保管。面板恢复只代表管理通道完成验证,无法证明节点长期稳定;报告问题时应分别写清页面、接口与业务流量的实际状态。