FAQ

常見問題與解答。

安裝部署

一鍵安裝指令碼下載失敗？

檢查伺服器外網連通性；如在國內網路環境，可先配置 Docker 映象加速。

埠被佔用怎麼辦？

修改安裝指令碼或容器編排中的埠對映，或停用佔用埠的服務。常用埠：8010、9090、9093、8500、4505/4506。

忘記 admin 密碼怎麼辦？

# 进入容器重置密码
docker exec -it opsany-proxy-opsant python manage.py changepassword admin

主機納管

為什麼指令碼執行選不到主機？

指令碼執行、檔案分發、定時任務只能選擇已納管主機。請先在「主機管理」確認主機已進入「已納管」列表（待納管主機不可選）。

OpsMini 主機一直在「待納管」？

Agent 已上報但未審批。進入「主機管理 - 待納管」，點選「同意納管」。

Token 校驗失敗？

Agent 的 Token 與平臺不一致。檢查 Agent 配置檔案中的 server_token 是否與「系統設定 - 對接 Token」一致。

監控告警

告警事件無資料？

1. 確認「系統設定 - Prometheus 接入」配置正確
2. 確認 Prometheus 地址可訪問、Basic Auth 憑據正確
3. 確認主機已納管並註冊到 Consul

AI 助手

獲取模型失敗？

確認 API Key 正確、Base URL 可訪問。DeepSeek 不支援 embeddings 介面（僅 chat completions），知識庫向量化需另配其它服務。

其它

平臺訪問 502？

本地透過代理訪問時可能走代理導致 502，可嘗試直連或配置 --noproxy。