阅读建议
先确认遇到的具体问题，再按顺序处理；需要安装、订阅或配置细节时，可继续查看相关教程。
先分清两件事
MetaCubeXD 是 Mihomo Dashboard，负责展示流量、代理组、连接、规则、日志和配置。它本身不负责代理连接，真正的代理逻辑仍由 Mihomo 内核运行。
连接失败顺序
- 确认 Mihomo 已启动，配置里存在 external-controller。
- 确认控制端口没有被防火墙、Docker 网络或系统权限拦截。
- 如果配置了 secret，Dashboard 里也必须填写同一个 secret。
- 本机访问用 127.0.0.1，局域网访问要确认监听地址不是只绑定本机。
- 跨域或反向代理访问时，再检查 CORS、HTTPS 和路径转发。
最小控制配置示例
external-controller: 127.0.0.1:9090
secret: "change-this-secret"局域网访问前先确认风险和访问控制，不要把无密码控制端口暴露到公网。
Docker 场景
Docker 里常见问题是容器端口没有映射、network_mode 与访问地址不一致、配置文件挂载路径错误。先在宿主机确认 Mihomo 日志，再打开 Dashboard。
安全提醒
- external-controller 可以读取连接、切换节点和更新配置，不应裸露公网。
- 配置 secret 后要妥善保存，避免写进截图或公开仓库。
- 多人共用面板时，先明确谁可以改策略组和配置。