3分钟部署StrikeAgent_AtkBrain-Flash：Docker快速入门完整教程（含macOS适配）

StrikeAgent_AtkBrain-Flash 是由夜安团队研发的AI Agent 渗透测试平台，主打自监督、自循环、自进化的分形架构，专注于可控环境（CTF）下的自动化攻防能力。对于新手来说，最大的门槛往往是环境搭建——而本文正是为此而生：跟着下面的 Docker 快速入门步骤，3 分钟即可在 Linux 或 macOS 上把平台跑起来，无需手动配置 Python、Node 和探测工具链。

部署前准备：环境要求与端口说明

开始之前，先确认你的机器满足以下条件：

两个关键端口请记住：

• :2333— 后端 API（本机 HTTP）
• :2334— 浏览器访问的 HTTPS 控制台（自签证书，首次打开点"继续"即可）

⚠️ 注意：不要同时用 Docker 和本机 systemd 两套方式抢占2333/2334端口，二选一即可。

一键克隆仓库并初始化配置

打开终端，克隆仓库并把示例配置复制为.env：

git clone https://gitcode.com/gh_mirrors/st/StrikeAgent_AtkBrain-Flash cd StrikeAgent_AtkBrain-Flash cp .env.example .env

.env保持默认值即可，这里有两个新手常踩的点（详见 .env.example）：

• 首次登录账号是admin/admin，登录后页面会强制要求改密；
• 模型 API Key 不要写在.env里——模型在控制台起来后，到「设置 → 模型」里配置。

Linux 快速部署：一条命令启动

Linux 使用 host 网络模式，浏览器所在机器只要能访问这台主机的2334端口即可。在仓库根目录执行：

docker compose -f compose.yaml -f deploy/compose.build.yaml up -d --build --wait

这条命令做了三件事：

1. 按 Dockerfile.console 构建镜像strikeagent-atkbrain-flash:console（内含控制台、Pi 运行时与常用探测工具）；
2. 后台启动两个容器：strikeagent-atkbrain-flash（API）与strikeagent-atkbrain-caddy（HTTPS）；
3. --wait会等到健康检查（python3 -m atkbrain.healthcheck）通过后才返回，看到命令正常结束就说明部署成功了。

构建完成后可以验证一下容器状态：

docker compose -f compose.yaml ps

🐧 提示：如果你的机器在局域网中其他设备上访问，.env中默认的ATKBRAIN_HOST=0.0.0.0已满足要求，无需修改。

macOS 适配：解决 Docker Desktop 无 host 网络的问题

macOS 用户请注意：Docker Desktop 不支持 host 网络，直接执行 Linux 的命令会遇到端口问题。项目已经准备好了适配方案——deploy/compose.mac.yaml 会把两个容器改到桥接网络，并将2333/2334只绑定到本机127.0.0.1。

macOS 启动命令只需在原有基础上多叠一份 compose 文件：

docker compose -f compose.yaml -f deploy/compose.build.yaml -f deploy/compose.mac.yaml up -d --build --wait

区别仅在于：macOS 上控制台只能通过本机的https://127.0.0.1:2334访问，无法从局域网其他设备打开，这是预期行为。

获取登录入口：30秒找到控制台地址

平台的安全设计让登录入口是一个随机 8 位路径（仅写在本机，网页和 API 上查不到）。启动后执行一条命令即可打印带随机入口的完整登录地址和当前口令：

docker compose -f compose.yaml exec atkbrain python -m atkbrain.panel

复制输出的https 地址（形如https://<主机>:2334/xxxxxxxx）到浏览器打开，自签证书点"继续"，用admin/admin登录，然后按提示修改密码。

🔐 忘了入口或口令？再执行一次上面的panel命令即可重新打印；数据都存放在backend/data/，重装或升级镜像不会丢失库、入口和已保存的模型配置。

配置模型：设置里的两步操作

控制台起来后，进入设置 → 模型：

1. 选择OpenAI（走 Chat Completions）或Anthropic（走 Messages API）；
2. 填写模型名、Base URL 和 API Key，保存后会写入backend/data/pi-models.json；
3. 点「测试连通」发一条最短请求，确认地址和密钥可用。

这一步完成后，你的 AI 渗透测试平台就真正"通电"了。

部署后能看到什么：控制台速览

登录后，你会在一个侧边栏控制台里管理所有渗透任务，核心模块包括：

• 新建项目：Agent测试与CTF两个入口，目标支持单条填写或导入 txt / csv 批量创建；
• 项目控制台：攻击图、时间线、漏洞、对话四合一视图，实时观察 Agent 的猎面进度；
• 漏洞管理：汇总红队/蓝队/基队发现的漏洞，按严重度分级，支持二次验证与红队评级；
• 交付报告：一键导出 HTML/PDF 渗透测试报告。

顺便说下这个平台为什么值得关注：在腾讯安全云鼎实验室的智能攻防 Agent 评测 Tsecbench v1 中，StrikeAgent_AtkBrain-Flash 以 97.89/100 的成绩位列第 1 名。

升级与停止：日常运维命令

# 查看容器状态 docker compose -f compose.yaml ps # 升级：拉取新代码后重新构建（数据保留） docker compose -f compose.yaml -f deploy/compose.build.yaml up -d --build --wait # 停止 docker compose -f compose.yaml -f deploy/compose.build.yaml down

常见问题速查

写在最后

到这里，你的 StrikeAgent_AtkBrain-Flash 渗透测试平台已经完整部署：克隆仓库 → 复制.env→ 一条docker compose命令 →panel打印登录地址，全程不超过 3 分钟（首次构建镜像时间视网络而定）。

最后提醒一句：请仅在已获明确授权的环境（如 CTF）中使用本平台。项目内置了对 gov、edu 等重要域名的测试禁令和加强的门卫规则，合规使用是每一位安全从业者的底线。更多架构与功能细节，可阅读 README.md 与 compose.yaml 中的注释。