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 和請求標頭。