🐳 Docker 本地部署

最快的上手方式：两条命令起来，适合 1Panel / 宝塔面板环境，也适合本地试用。

快速开始

cd deploy/docker
cp .env.example .env
vi .env                     # 改 OPSM_ADMIN_PASS、OPSM_TOKEN、OPSM_PUBLIC_URL
docker compose up -d
docker compose logs -f

打开 http://宿主机IP:9999，用 .env 里的账号登录。

两种构建方式

⚠️ 最容易踩的坑：机器码会变，授权会失效

正确做法：

1. 先起一次容器；
2. 打开控制台「系统 → 授权购买」，复制页面显示的本机机器码（形如 C317-6E8B-BAE5-A8A6）；
3. 把它填到 .env 的 OPSM_LICENSE_MACHINE=；
4. docker compose up -d 重建。

之后无论容器怎么重建，机器码都是固定的，授权不会掉。

目录与数据

数据都在宿主机 ./data/，docker compose down 不会丢。备份直接打包这个目录即可。

采集端如何接入

采集端要能访问到宿主机的 9999（不是容器 IP）：

# 方式一：采集端装在宿主机 / 其它机器上，直接指宿主机地址
opsmonitor-agent -server http://10.0.0.5:9999 -token 与OPSM_TOKEN一致 -name web-01

# 方式二：控制台「监控 → 添加主机」复制一键安装命令，命令里自动带上平台地址

想用容器采集宿主机指标，见仓库 DEPLOY.md §5.3（需要 pid: host、network_mode: host、只读挂载 /）。

反向代理（可选，推荐生产用）

server {
    listen 80;
    server_name monitor.example.com;

    location / {
        proxy_pass http://127.0.0.1:9999;
        proxy_http_version 1.1;
        proxy_set_header Host              $host;
        proxy_set_header X-Real-IP         $remote_addr;
        proxy_set_header X-Forwarded-For   $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_read_timeout 300s;   # 探测任务与升级下载可能较慢
        client_max_body_size 200m; # 上传采集端发布物
    }
}

常用命令

docker compose ps                      # 状态
docker compose logs -f --tail=100      # 日志
docker compose restart                 # 重启
docker compose down                    # 停止（保留数据）
docker compose up -d --build           # 改完 .env 后重建
docker compose exec opsmonitor wget -qO- http://127.0.0.1:9999/api/health   # 容器内健康检查

常见排障