网页面板可以正常显示,却一直提示核心未连接,说明页面加载与管理通信是两件事。浏览器取得了界面文件,不代表它能够访问本地控制接口。此时先沿管理通道排查,比更换机场节点或重新购买套餐更符合错误发生的位置。

给三个入口分别命名

面板负责展示,控制接口接收管理查询,代理监听入口负责转发业务流量。它们可能运行在同一台设备,但地址、端口和认证方式未必相同。以使用mihomo控制接口的环境为例,external-controller描述管理监听;HTTP、SOCKS或混合代理入口另有用途。不能把平时浏览器代理端口直接填为面板API地址。

确认核心先于面板正常工作

查看客户端或核心的启动状态,确认配置没有解析失败、管理接口没有因端口占用而无法监听。网页界面能显示并不能替核心作证明。若核心本身尚未启动,应先处理启动错误;不要在面板里反复输入不同地址,制造多个无法辨认的连接配置。

检查地址属于哪台设备

浏览器与核心在不同设备上时,回环地址分别指向各自设备,不能互换。局域网或远程使用还涉及监听范围与访问控制,不能为了方便把管理接口直接暴露给公网。先明确谁需要管理谁,只在必要且可信的范围内配置访问,不顺带开放与任务无关的接口。

认证信息应匹配控制接口

管理接口可能要求独立密钥或认证资料,它不一定是机场账户密码,也不是订阅链接。按当前核心与客户端说明核对,公开截图时遮盖密钥。不要将管理凭据提交给不明来源的在线面板;面板页面本身是否可信,同样属于选择管理工具时需要确认的条件。

用只读状态查询验证连接

先验证面板能否读取核心状态、版本或连接信息,再进行会改变配置的操作。假设业务上网正常而面板失败,应保留正常业务路径,专注检查管理地址、认证与浏览器错误。这样可以避免为修复一个管理界面而破坏原本可用的节点与规则。

完成以后缩回不必要范围

移除临时连接记录或不再需要的监听,恢复最小访问范围,并核对正常退出后的状态。记录面板、核心、代理入口三者的关系,后续升级时再对照。若仍失败,提供脱敏错误阶段和组件版本,不公开完整管理地址中的凭据。管理通道恢复,不能自动证明每项业务任务正常,两类验收仍应分开。

延伸阅读:客户端启动与端口冲突 · 客户端日志脱敏。