Dashboard 打不开、连接 9090 或提示 unauthorized 怎么办？

Dashboard 需要连接 external-controller API。打不开通常与监听地址、端口、secret、跨域、反向代理或防火墙有关。

查看答案返回分类
  • 安全、隐私与权限
  • 故障排查
简要回答

Dashboard 需要连接 external-controller API。打不开通常与监听地址、端口、secret、跨域、反向代理或防火墙有关。 先在本机验证控制地址和端口，再让 Dashboard 使用同一 secret。远程访问最后再加 HTTPS 和访问控制。

connection refused、unauthorized 和 CORS 怎么区分

connection refused 表示接口未连通，unauthorized 表示接口已响应但认证失败，CORS 则是浏览器跨域限制。

  • external-controller 是否启用并监听正确地址
  • 端口是否为 9090 或客户端实际配置端口
  • Dashboard 中填写的 secret 是否与配置一致
  • 浏览器控制台或日志是否出现 unauthorized、connection refused 或 CORS 错误

对齐控制地址、端口与 secret

  1. 先确认客户端或内核正在运行
  2. 在本机访问 127.0.0.1 加控制端口，确认 API 能响应
  3. 把 Dashboard 里的 API 地址和 secret 改成当前配置值
  4. 端口被占用时更换 external-controller 端口并同步 Dashboard（参见 外部控制设置、端口占用 FAQ）
  5. 远程访问时先加访问控制和 HTTPS，再开放到可信网络

9090 只是常见示例端口，实际端口以配置为准

secret 为空会增加控制接口风险

不要把 external-controller 直接暴露到公网

如何确认 Dashboard 已经恢复

接口可达且认证有效
访问控制地址能够返回版本信息，Dashboard 使用相同 secret 后可以读取节点和连接。
仍提示拒绝或未授权
区分 connection refused 与 unauthorized，再分别检查监听地址、端口、secret 和请求头。