如何快速部署Agentic SOC Platform:Docker Compose私有化AI SOC平台手把手教程

原创2026-10-15 15:52:281,689 阅读

如何快速部署Agentic SOC Platform:Docker Compose私有化AI SOC平台手把手教程

Agentic SOC Platform 是一个以 Agentic AI 为核心的开源安全运营平台(AI SOC),支持完全私有化部署、安全数据不出内网。本教程带你用 Docker Compose 在单台 Linux 主机上,通过 3 步命令完成部署:初始化环境、一键启动、健康检查并登录管理后台,最终在浏览器中打开属于你的 AI 安全运营中心。

Agentic SOC Platform AI SOC安全态势仪表盘

Agentic SOC Platform 是什么?

在动手之前,先了解一下这套 AI SOC 平台的核心能力,方便你部署后快速上手:

核心能力 说明
🚨 告警收敛 Module 流式消费 SIEM / Webhook 告警,提取 IOC、关联聚合,把告警洪水收敛成可处置的 Case
🤖 AI 调查报告 秒级自动生成严重性、置信度、影响、判定和结构化调查报告
📋 Playbook 编排 一键触发 LLM 调查、知识提取、威胁情报富化和 CMDB 富化
🔗 多 SIEM 接入 支持 Splunk、ELK 等日志源,统一调查入口
🧠 知识沉淀 从已关闭案件中提取可复用知识,越用越智能
🔒 内置治理 本地/LDAP 登录、用户角色、API Key、Inbox 通知和审计日志

官方仓库以 MIT 许可证开源,后端 Python、前端 TypeScript,完全本地化运行,安全数据不出内网,非常适合内网私有化场景。

Agentic SOC Platform 开源仓库代码目录结构

部署前置条件:服务器与 Docker 环境

硬件与环境要求

  • 一台 Linux 主机(CentOS / Ubuntu / Debian 均可),建议 4 核 8G 内存起步,磁盘预留 20GB
  • 已安装 Docker Engine 与 Docker Compose v2
  • 主机端口 443(HTTPS 入口)、8001(Redis Stack UI)、9001(RustFS Console)未被占用

先验证 Docker Compose 是否可用:

docker compose version

部署架构速览

官方部署包 deploy/asp-compose/ 通过 compose.yaml 编排了完整的服务栈,一次拉起:

服务 作用
asp-frontend Nginx 前端,HTTPS 入口(443)
asp-web / asp-asgi Django Web API(Gunicorn)与 WebSocket ASGI 服务
asp-worker-module / case-analysis / playbook 等 6 个后台 Worker,分别负责告警模块、案件分析、Playbook 执行等
postgres PostgreSQL 17,业务数据持久化
redis-stack Redis + Stream,异步任务队列
rustfs S3 兼容对象存储,附件与产物

第一步:获取 asp-compose 部署包

方式一:从代码仓库克隆(推荐)

git clone https://gitcode.com/gh_mirrors/ag/agentic-soc-platform
cd agentic-soc-platform/deploy/asp-compose

方式二:下载发布包

从项目官方 Release 页下载 asp-compose.tar.gz 发布包后解压:

tar -xzf asp-compose.tar.gz
cd asp-compose

⚠️ 重要:部署目录名必须保持为 asp-compose,不要修改目录名,否则 Docker Compose project name 和命名卷(named volumes)名称会发生变化,导致数据丢失。详见 deploy/asp-compose/README.zh.md。

第二步:一键初始化部署

进入部署目录后,只需要一条命令:

./scripts/init.sh

scripts/init.sh 会自动完成以下全部工作:

  1. 创建 certs/、custom/(模块与 Playbook 目录)、logs/ 等运行目录
  2. 复制 .env.example 生成 .env,并自动生成 Django、PostgreSQL、Redis、RustFS 的随机强凭据
  3. 生成用户覆盖文件 compose.override.yaml
  4. docker compose pull 拉取前后端镜像
  5. 执行 asp-migrate 完成数据库迁移
  6. docker compose up -d 启动全部服务

Agentic SOC Platform 安全运营案件列表工作台

初始化完成后,终端会提示运行 doctor.sh 验证部署,并给出创建管理员的命令。

第三步:健康检查与创建管理员

运行 doctor.sh 检查部署状态

./scripts/doctor.sh

scripts/doctor.sh 会依次检查 11 个核心服务(含 6 个 worker、postgres、redis-stack、rustfs 等)的运行状态和健康探针,最长等待时间由 .env 中的 ASP_DOCTOR_WAIT_SECONDS 控制(默认 180 秒)。

创建管理员账号

docker compose exec asp-web python manage.py createsuperuser

按提示输入用户名和密码后,浏览器访问:

https://<服务器IP>:443

首次启动时前端会自动生成自签名证书,浏览器会提示不受信任,点击继续访问即可。正式环境请按下一节替换为真实证书。

登录后如何体验 AI 能力?

登录后台后,进入 Cases(案件) 列表,可以看到告警已经按 IOC 关联聚合成了案件。选中一个案件点击 Playbook 即可触发 AI 调查:

  • 自动拉取 SIEM 日志上下文
  • 调用 LLM 生成调查报告:严重性(Severity)、影响(Impact)、优先级(Priority)、置信度(Confidence)与证据链
  • 数小时的人工调查压缩到秒级输出

AI SOC案件AI调查报告自动研判结果

💡 触发 AI 分析前,请先在系统设置中配置 LLM 提供商(如 OpenAI 兼容接口),配置项保存在 backend/apps/settings/ 对应的运行时配置中。

关键配置详解:.env 与 HTTPS 证书

常用 .env 参数

部署配置集中在 .env(模板见 .env.example),最常调整的几项:

参数 默认值 说明
ASP_HTTPS_PORT 443 HTTPS 入口端口
ASP_WEB_WORKERS 3 Gunicorn worker 进程数
ASP_REDIS_UI_PORT 8001 Redis Stack 管理界面端口
ASP_RUSTFS_CONSOLE_PORT 9001 RustFS 控制台端口
ASP_CERT_EXTRA_SAN 空 自签名证书额外 SAN,如 DNS:asp.example.com,IP:10.0.0.10
POSTGRES_* 见模板 PostgreSQL 内存与连接调优参数

修改 .env 后重启并复查:

docker compose up -d
./scripts/doctor.sh

⚠️ 初始化后不要只修改 PostgreSQL、Redis 或 RustFS 的密码,否则应用与服务端凭据会不一致。

替换正式 HTTPS 证书

将真实证书放到 certs/asp.crt 和 certs/asp.key,然后重启前端:

docker compose restart asp-frontend

管理界面入口

界面 地址 用途
Redis Stack UI http://<server>:8001 查看队列与缓存
RustFS Console http://<server>:9001 管理对象存储附件

生产环境建议通过防火墙或 VPN 限制这两个端口的外网访问。

日常运维:日志、备份与升级

查看状态与日志

docker compose ps                      # 查看服务状态
docker compose logs --tail=100 asp-web # 查看后端日志
docker compose logs -f asp-web         # 实时跟踪日志

Nginx 与后端进程日志同时写入 logs/ 目录。

备份与恢复

./scripts/backup.sh                          # 创建停机全量备份
./scripts/backup.sh /mnt/asp-backups         # 指定备份目录
./scripts/restore.sh /path/to/asp-full-backup # 恢复全量备份

脚本会在停止服务前校验备份 manifest、SHA-256、归档文件和 Compose 配置,恢复过程安全可靠。

版本升级

先备份,再更新发布包并执行 scripts/upgrade.sh:

./scripts/backup.sh
./scripts/upgrade.sh

升级脚本会自动更新镜像、执行数据库迁移并运行 doctor 检查。

🚫 切记:不要执行 docker compose down -v,除非你明确要删除全部持久化数据。

定制自己的 Module 与 Playbook

init.sh 已创建好定制目录,写入 Python 自定义模块即可适配新告警源:

  • 自定义模块:custom/modules/
  • 自定义剧本:custom/playbooks/
  • SIEM 数据配置:custom/data/siem/
  • 剧本提示词:custom/data/playbooks/

只修改 Module、Playbook 或 SIEM YAML 后,在 ASP 的 Custom Console 中执行 Refresh / Validate 即可生效;新增 Python 依赖时写入 custom/requirements.txt 并执行:

docker compose run --rm asp-custom-deps
docker compose restart asp-web asp-worker-module asp-worker-playbook

示例模块参考 custom/modules/,剧本示例参考 custom/playbooks/。

常见问题 FAQ

Q1:443 端口被占用怎么办? 修改 .env 中 ASP_HTTPS_PORT(如改为 8443),执行 docker compose up -d 后访问 https://<ip>:8443。

Q2:doctor.sh 提示某服务不健康? 先用 docker compose ps 确认状态,再 docker compose logs <服务名> 排查。数据库初始化通常需要几十秒,可等待后重试;默认最多等待 ASP_DOCTOR_WAIT_SECONDS(180 秒)。

Q3:初始化失败后如何重来? 删除 .env 后重新执行 ./scripts/init.sh 即可重新生成随机凭据。若需彻底清除数据卷,才考虑 docker compose down -v(会删除全部数据,慎用)。

Q4:升级后出问题如何回滚? 升级脚本不会自动回滚,请使用升级前执行 backup.sh 创建的全量备份,通过 restore.sh 恢复。

总结

恭喜!你已经完成了 Agentic SOC Platform 的私有化部署。回顾整个流程:

  1. ✅ 准备一台安装好 Docker Compose 的 Linux 主机
  2. ✅ 获取 asp-compose 部署包,执行 ./scripts/init.sh 一键初始化
  3. ✅ ./scripts/doctor.sh 健康检查 + 创建管理员
  4. ✅ 浏览器登录,配置 LLM 后体验 AI 调查与 Playbook 自动化

整套平台开源免费、架构清晰,从告警收敛到 AI 研判全部跑在内网,是一套真正可私有化的 AI SOC 解决方案。更多部署细节可查阅 deploy/asp-compose/README.zh.md,开发环境配置参考 development/docker/compose.yaml。

登录后查看全文
agentic-soc-platform