如何快速部署Agentic SOC Platform:Docker Compose私有化AI SOC平台手把手教程
如何快速部署Agentic SOC Platform:Docker Compose私有化AI SOC平台手把手教程
Agentic SOC Platform 是一个以 Agentic AI 为核心的开源安全运营平台(AI SOC),支持完全私有化部署、安全数据不出内网。本教程带你用 Docker Compose 在单台 Linux 主机上,通过 3 步命令完成部署:初始化环境、一键启动、健康检查并登录管理后台,最终在浏览器中打开属于你的 AI 安全运营中心。
Agentic SOC Platform 是什么?
在动手之前,先了解一下这套 AI SOC 平台的核心能力,方便你部署后快速上手:
| 核心能力 | 说明 |
|---|---|
| 🚨 告警收敛 | Module 流式消费 SIEM / Webhook 告警,提取 IOC、关联聚合,把告警洪水收敛成可处置的 Case |
| 🤖 AI 调查报告 | 秒级自动生成严重性、置信度、影响、判定和结构化调查报告 |
| 📋 Playbook 编排 | 一键触发 LLM 调查、知识提取、威胁情报富化和 CMDB 富化 |
| 🔗 多 SIEM 接入 | 支持 Splunk、ELK 等日志源,统一调查入口 |
| 🧠 知识沉淀 | 从已关闭案件中提取可复用知识,越用越智能 |
| 🔒 内置治理 | 本地/LDAP 登录、用户角色、API Key、Inbox 通知和审计日志 |
官方仓库以 MIT 许可证开源,后端 Python、前端 TypeScript,完全本地化运行,安全数据不出内网,非常适合内网私有化场景。
部署前置条件:服务器与 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 会自动完成以下全部工作:
- 创建
certs/、custom/(模块与 Playbook 目录)、logs/等运行目录 - 复制
.env.example生成.env,并自动生成 Django、PostgreSQL、Redis、RustFS 的随机强凭据 - 生成用户覆盖文件
compose.override.yaml docker compose pull拉取前后端镜像- 执行
asp-migrate完成数据库迁移 docker compose up -d启动全部服务
初始化完成后,终端会提示运行 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 分析前,请先在系统设置中配置 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 的私有化部署。回顾整个流程:
- ✅ 准备一台安装好 Docker Compose 的 Linux 主机
- ✅ 获取
asp-compose部署包,执行./scripts/init.sh一键初始化 - ✅
./scripts/doctor.sh健康检查 + 创建管理员 - ✅ 浏览器登录,配置 LLM 后体验 AI 调查与 Playbook 自动化
整套平台开源免费、架构清晰,从告警收敛到 AI 研判全部跑在内网,是一套真正可私有化的 AI SOC 解决方案。更多部署细节可查阅 deploy/asp-compose/README.zh.md,开发环境配置参考 development/docker/compose.yaml。



