Docker 部署

本指南涵盖 Argus Agentic SOC Platform 的生产级 Docker Compose 部署，包括服务架构、生产加固、运维管理和故障排查。

如需最简快速启动，请参阅安装部署。

服务架构

平台由三个容器化服务组成：

┌──────────────┐     ┌──────────────┐     ┌──────────────┐
│    前端      │────▶│    后端      │────▶│  PostgreSQL  │
│  (Next.js)   │     │  (Django)    │     │   数据库     │
│  Port 3000   │     │  Port 8000   │     │  Port 5432   │
└──────────────┘     └──────────────┘     └──────────────┘

开发环境 vs. 生产环境

生产环境部署

启动服务

docker-compose -f docker-compose.prod.yml up --build -d

服务端口（生产环境）

查看日志

docker-compose -f docker-compose.prod.yml logs -f

停止服务

docker-compose -f docker-compose.prod.yml down

生产加固检查清单

在将平台暴露给生产流量之前：

• 在 .env 中设置 DEBUG=False
• 生成强随机 SECRET_KEY：

  python -c "from django.core.management.utils import get_random_secret_key; print(get_random_secret_key())"
  

• 将 ALLOWED_HOSTS 限制为实际域名（如 siem.example.com）
• 设置 CSRF_TRUSTED_ORIGINS 为生产域名
• 如不需要外部数据库访问，从 docker-compose.prod.yml 中移除端口 5432 的对外暴露
• 在前端容器前部署 TLS 终止反向代理（Nginx、Traefik）
• 首次部署前轮换 .env 中的所有默认密码
• 确认 .env 未被提交到版本控制（检查 .gitignore）

环境变量配置

所有运行时配置均通过 .env 文件控制。复制示例文件并填写：

cp env.example .env

生产环境必填变量

运维管理

Makefile 快速参考

重启单个服务

docker-compose -f docker-compose.prod.yml restart backend

重建单个服务

docker-compose -f docker-compose.prod.yml up --build -d backend

执行 Django 管理命令

# 创建管理员超级用户
docker exec -it backend python manage.py createsuperuser

# 手动执行数据库迁移
docker exec -it backend python manage.py migrate

# 收集静态文件
docker exec -it backend python manage.py collectstatic --noinput

进入容器 Shell

docker exec -it backend sh
docker exec -it frontend sh
docker exec -it postgres bash

数据库管理

备份

docker exec postgres pg_dump -U siem_user siem_db > backup_$(date +%Y%m%d).sql

恢复

docker exec -i postgres psql -U siem_user siem_db < backup_20260704.sql

数据持久化

PostgreSQL 数据存储在名为 postgres_data 的 Docker 卷中。执行 docker-compose down 后数据持久保留，但执行 docker-compose down --volumes 时数据会被删除。

在执行任何 down --volumes 或 clean 命令前，请务必完成非宿主机外部备份。

自动启动行为

每次容器启动时，后端入口脚本自动执行：

1. 运行 makemigrations 和 migrate 以应用待处理的 schema 变更
2. 运行 collectstatic --noinput 以收集前端静态资源

如需禁用静态文件收集，在 .env 中设置 DJANGO_COLLECTSTATIC=0。

反向代理（HTTPS）

生产 HTTPS 配置需在前端容器前部署反向代理。Nginx 配置示例：

server {
    listen 443 ssl;
    server_name siem.yourdomain.com;

    ssl_certificate     /etc/ssl/certs/yourdomain.crt;
    ssl_certificate_key /etc/ssl/private/yourdomain.key;

    location / {
        proxy_pass http://localhost:3000;
        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;
    }
}

故障排查

容器启动失败

docker logs <容器名称>

检查：.env 是否存在且包含所有必填变量；主机端口是否被占用。

数据库连接拒绝

• 确认 .env 中 POSTGRES_HOST=db（不是 localhost）
• PostgreSQL 容器可能仍在初始化——等待几秒后重试，或在 docker-compose.yml 中添加健康检查

前端无法连接后端

• 确认 BACKEND_ORIGIN=http://backend:8000
• 确认两个容器在同一 Docker 网络（Compose 自动处理）

端口被占用

# macOS / Linux
lsof -i :8000

# Windows
netstat -ano | findstr :8000

完整清理重建

make clean-rebuild-prod
# 或手动执行：
docker-compose -f docker-compose.prod.yml down --volumes --rmi all
docker-compose -f docker-compose.prod.yml up --build -d