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。