Mihomo 面板显示断开怎么办?控制端口、密钥与浏览器报错排查
Mihomo 面板能打开,却显示断开或读不到节点,先检查面板连接的控制接口。页面文件加载成功,不代表内核 API 已连接;代理还能上网,也不能证明面板地址、密钥和浏览器请求都正确。把页面、控制接口和代理流量分开排查,才能避免反复换节点却没有变化。
作者:小六|资料核对日期:2026年10月11日。本文适用于连接自己 Mihomo 内核的网页面板;客户端内置界面的实现可能不同,设置入口以软件说明为准。
一、三个地址,先分清用途
| 地址或端口 | 用途 | 常见误填 |
|---|---|---|
| 面板页面地址 | 加载按钮、图表等网页内容 | 认为页面能打开就代表内核已连接 |
| 控制接口地址 | 查询内核状态、规则和策略组 | 把 HTTP 或混合代理端口填进面板 |
| HTTP、SOCKS 或混合代理入口 | 接收应用需要代理的请求 | 当成面板的管理 API |
Mihomo 的 external-controller 是控制 API 监听地址,external-ui 可提供面板静态文件,文档说明其访问路径为 API 地址下的 /ui。见官方全局配置。代理入口则由代理端口文档另行说明。
不要把教程中的端口当成所有客户端的固定值。先查看当前生效配置,再核对面板保存的协议、主机和端口;数字相同或页面名称相似,都不能替代这一步。
二、先记录浏览器的真实错误
打开浏览器开发者工具,查看网络请求和控制台,再重新连接面板。菜单名称按浏览器而定,重点记录失败请求的目标、时间、状态或错误类型,暂时不导出整份网络记录。
| 观察结果 | 下一步方向 |
|---|---|
| 连接被拒绝、超时 | 内核是否运行、控制地址与监听范围是否一致 |
| 控制 API 返回 401 | 请求是否携带该 API 所需的有效授权 |
| 控制台明确报告 CORS | 核对页面来源与 API 的跨来源响应 |
| 报告 Mixed Content | 核对页面和请求的协议及地址类型 |
| 版本请求成功,只有部分功能失败 | 分别检查对应请求、接口和面板兼容性 |
这张表用于选排查方向。普通“Failed to fetch”提示不能单独证明 CORS、节点失效或密钥错误,必须继续看具体请求。
三、控制接口 401,检查 API 密钥
HTTP 401 表示请求缺少目标资源所需的有效凭据,含义见 MDN 的 401 说明。这里先确认返回错误的是控制 API,不是面板页面所在网站。
Mihomo API 文档展示了 Authorization: Bearer 方式,其中使用的是配置中的 API 密钥。见官方 API 说明。在面板的对应密钥栏核对当前值,注意旧保存项、多余空格及是否连到了另一份内核配置。
不要把机场账户密码、节点参数或代理入口的用户名密码填进去。请求头可能含授权信息,求助截图应遮住它;分享材料只需保留错误状态和请求路径。代理入口出现 407 属于另一条排查线,可阅读本站代理认证与凭据区别。
四、跨来源错误,先看面板从哪里加载
网页来源由协议、主机和端口共同确定。面板与 API 使用不同来源时,浏览器会检查 CORS;部分请求还会先发送 OPTIONS 预检。MDN 指出,具体失败原因应在浏览器控制台查看,见 CORS 官方说明。
若确认是这一层,核对 Mihomo 的 external-controller-cors 及面板文档。围绕实际需要的面板来源设置允许范围,不直接照搬允许所有来源的示例,也不要用关闭浏览器安全检查代替修复。终端里请求成功,仍不能证明网页的跨来源访问通过了检查。
如果报错来自预检,应记录它和实际 API 请求的区别。只看一条 OPTIONS 成功,不能断言随后读取节点的请求也成功。
五、协议错误与监听错误,不能靠换节点修复
HTTPS 页面请求不安全资源时,浏览器可能按混合内容规则拦截接口请求。MDN 也说明,本机回环地址有特殊处理,所以不能仅凭“页面 HTTPS、接口 HTTP”就断定一定被拦。应以具体提示为依据,见混合内容说明。
需要 HTTPS 控制接口时,按内核和面板文档核对 TLS 监听与证书配置;只把面板里的 http 改成 https,不会自动让原来的监听端口支持 TLS。不要为了消除报错关闭证书校验。
若属于连接被拒绝,先确认内核仍在运行、控制端口确实已监听,地址也没有填成其他设备自己的回环地址。发现监听失败或端口冲突,可参考本站Windows 本地监听排查。不应为了接入面板随意把管理接口开放到公网。
六、恢复后,用读取状态来确认
先观察面板能否读取版本及节点列表,再检查策略组当前选择。官方 API 文档列出只读的 GET /version,可用于核对版本信息;不要借排查之名随意调用更新配置、重启或升级接口。
保持同一个面板和控制地址,一次只改一项已确认有误的设置。版本信息成功,只证明相应请求通过了;若日志或图表仍异常,应继续查看它们各自的请求。面板显示正常,也不能替代实际应用的代理连接验证。
欢迎带着面板名称、内核版本、错误类型和脱敏后的请求路径交流,注明是“页面打不开”还是“页面已加载但 API 失败”,不用提供 API 密钥或完整配置:Telegram 联系我。
评论