适用范围与准备

适用于Mihomo代理连接仍正常,访问自己的控制面板却空白或找不到静态资源。先备份配置和现有UI目录,确认访问的是正确内核;本篇针对内核提供的外部UI资源,不把第三方客户端自带界面都当成同一种部署。

先区分原因

官方配置将external-ui指定的静态网页资源提供在API地址的/ui下。external-ui-name可在该目录下再指定子目录,external-ui-url用于指定下载来源。API监听、静态页面文件和前端连接API是不同环节,能建立代理连接并不代表面板文件已正确下载或放置。

按顺序操作

  1. 先确认面板URL对应的API实例和端口,不把mixed-port当成面板入口。记录空白页、404或浏览器中失败的资源路径,避免立即改动节点配置。
  2. 检查生效配置里的external-ui,结合内核工作目录解析相对路径。只读查看实际文件位置及运行用户能否读取,不将整个系统加入SAFE_PATHS来绕过路径错误。
  3. 若设置external-ui-name,核对最终子目录,确认解压后的首页和资源不多套一层目录。保留旧UI副本,不覆盖到订阅缓存或其他程序的静态目录。
  4. 核对external-ui-url来自所选面板的官方发布或仓库。下载失败、下载到网页和压缩包布局不同应分别处理;不要把不明第三方面板接入含有控制密钥的API。
  5. 修正已确认的资源路径或来源后,重新打开/ui并检查资源请求。若页面加载后仍提示API错误,再核对连接地址和认证;不要为了让面板打开把控制API暴露到公网。
检查项应确认什么
external-ui静态文件实际目录
external-ui-name附加子目录及解压层级
external-ui-url可信下载来源与实际下载结果
页面加载后报API错误另查实例、地址和认证

怎样确认有效

应同时看到页面主要资源加载正常、连接预期API,以及原代理业务保持正常。仅首页HTTP 200或出现一个标题,不能证明脚本资源和控制连接已经可用。

无效时恢复与下一步

恢复原配置及已保存的UI目录,保留失败资源URL的脱敏记录。本文依据Mihomo官方字段说明,未下载或部署真实控制面板,也未修改API认证范围。