端到端执行渗透测试并撰写报告的 AI 智能体。

REDCELL 操作员控制台正在对 DVWA 运行：智能体图谱、严重 RCE 发现、智能体驱动的浏览器，以及捕获到的反弹 shell

[!WARNING] REDCELL 会运行真实的攻击性工具。请仅将其指向你拥有或已获授权测试的系统。保持在授权范围内并遵守法律是你的责任。

它是什么

REDCELL 让一队 LLM 智能体执行渗透测试。编排器规划整个任务，并将目标交给执行器智能体，后者在 Kali 容器内运行真实工具并回报结果。你可以从操作员控制台观察并引导整个运行过程：一个驱动编排器的聊天界面、实时的智能体图谱与活动流、智能体所驱动浏览器的实时视图、针对智能体捕获到的任意反弹 shell 的终端，以及工作完成后可交付的报告。

模型通过 LiteLLM 可插拔，因此你可以将其指向 OpenAI、Anthropic、Google、GLM、DeepSeek、Kimi、本地 Ollama，或它支持的任何其他模型。每次运行都会持续创建检查点，因此崩溃或重启后可以从上次中断处继续。

功能特性

多智能体引擎。 一个 LangGraph 的规划/执行循环。编排器将目标委派给执行器智能体，后者运行 shell 工具并在工作时记录发现、战利品和主机。
结构化工具。 为 nmap、nuclei、目录与 vhost 发现，以及 Metasploit 搜索与运行提供专用工具。每个工具都会将自己的输出解析到攻击面或发现中，因此一次扫描即可记录主机和漏洞，无需后续步骤。run_command 可覆盖任何没有专用工具的场景。
真实执行，本地或远程。 工具通过 docker exec 在 Kali 容器中运行。每个会话可选择 localhost 或已保存的服务器；远程服务器通过 SSH 以主机网络运行同一容器。
智能体浏览器。 对于 shell 工具无法触及的登录流程和重度依赖 JavaScript 的应用，智能体可在 Kali 容器中驱动真实的 Chromium。你可以实时观看，并可接管自行点击操作，然后再交还给它。
反弹 shell。 智能体打开监听器、捕获 shell，并为你提供其上的交互式终端。你也可以自行打开终端并运行命令。
网络跳板。 将工具流量通过捕获到的反弹 shell 路由，以访问仅从被攻陷机器可见的主机。由 chisel 反向 SOCKS 隧道承载，nmap 会自动通过该隧道运行。
聊天驱动运行。 告诉聊天你想要什么，它就会引导正在运行的编排器，或重新打开已完成的运行以承接新工作。它也会回答关于该任务的问题。
代码扫描会话。 将会话指向公共 git 仓库或本地文件夹，进行源代码安全审查，发现会映射回文件和行号。
按会话配置。 为每个会话设置执行服务器、模型和可选的出口代理。服务器和代理都带有真实的连接测试，让你在依赖它们之前确认其可用。
发现分级。 验证或忽略发现，并合并智能体重复记录的重复项。报告会省略被忽略的发现，并标记已验证的发现。
报告。 导出 PDF 以及 JSON 和 SARIF。报告由该会话的模型生成，并经过清理，读起来像人写的，包含执行摘要、方法论、发现和按优先级排序的修复建议。
实时控制台。 活动流、终端和智能体浏览器通过 WebSocket 流式传输；智能体图谱、发现、战利品、攻击面、监听器和代理历史通过短轮询刷新。所有内容都会随运行进展实时更新。
通知。 应用内提示，以及当标签页处于后台时的浏览器通知，这样智能体提出的问题或捕获到的 shell 就不会被忽视。

架构

flowchart LR
  UI["Operator console<br/>React + Vite"] -->|REST + WebSocket| API["FastAPI"]
  API --> PG[(PostgreSQL)]
  API --> RS[(Redis<br/>pub/sub + queue)]
  API --> S3[(MinIO<br/>files & reports)]
  RS --> W["Worker (arq)"]
  W --> ENG["Engine<br/>LangGraph + LiteLLM"]
  ENG -->|docker exec| KALI["Kali container<br/>local or remote over SSH"]
  KALI --> TGT["Targets"]
  W -->|events / chat / shell| RS
  RS -->|stream| API

API 不运行智能体。它将运行任务排队，由 worker 执行，worker 将输出发布到 Redis 频道，API 再通过 WebSocket 转发到浏览器。

技术栈

Python 3.12、FastAPI、async SQLAlchemy + asyncpg、Alembic、arq、LangGraph、LiteLLM、ReportLab、PostgreSQL、Redis、MinIO、asyncssh。前端：React 18、Vite、TypeScript、Tailwind、TanStack Query、xterm。工具链：Python 使用 uv，前端使用 bun。

快速开始

你需要 Docker、uv 和 bun。

# 1. infrastructure (Postgres, Redis, MinIO)
docker compose -f docker-compose.dev.yml up -d

# 2. Python deps, database, and seed data
uv sync --group live
uv run rc db upgrade
uv run rc seed              # admin user, provider catalog, buckets

# 3. copy the env template
cp .env.example .env

# 4. run the three processes (separate terminals)
cd apps/api    && uv run uvicorn app.main:app --host 127.0.0.1 --port 8080
cd apps/worker && uv run arq worker.settings.WorkerSettings
cd apps/web    && bun install && bun run dev

或者使用进程管理器一次性启动全部三个进程（它们已在 Procfile 中声明）：pipx install honcho 然后 honcho start。

打开 http://localhost:5183 并使用 admin / admin 登录。

运行默认会执行真实工具。在 Settings 中添加提供商 API 密钥，并确保 Docker 可以拉取 Kali 镜像（martian56/kali:latest）。若要改为针对预设输出进行试运行，请在 .env 中设置 REDCELL_RUN_MODE=sim。

练习目标

可让 REDCELL 瞄准的故意存在漏洞的应用，全部为本地：

docker compose -f docker-compose.targets.yml up -d
# DVWA http://localhost:8081 · Juice Shop http://localhost:3000 · WebGoat http://localhost:8082

部署（自托管）

在服务器上使用已发布的镜像运行 REDCELL，置于 Caddy 反向代理之后，这样 Web 应用和 API 共享同一源（无 CORS），HTTPS 也为你处理。在全新服务器上：

git clone https://github.com/martian56/redcell.git
cd redcell
./deploy.sh

该脚本会在缺失时安装 Docker，然后询问将如何访问 REDCELL：

直接使用此服务器，无域名 — 在服务器 IP 上使用纯 HTTP。适合快速试用或私有网络。
一个直接指向此服务器的域名 — Caddy 会自动签发 Let's Encrypt 证书（请先将 A 或 AAAA 记录指向该服务器），并通过 https://your-domain 提供服务。
位于 Cloudflare、Coolify 或其他代理或 CDN 之后的域名 — 由代理提供公共 HTTPS 证书并转发到此服务器。源站同时提供纯 HTTP（:80）和自签名 HTTPS（:443），因此既适用于通过 HTTP 连接的代理，也适用于接受源站证书的代理（对于 Cloudflare，SSL 模式为 Full；Full (strict) 需要 Cloudflare Origin Certificate）。

它会将你的回答写入 .env，拉取镜像并启动整个栈。使用 docker compose logs init-secrets 读取生成的管理员密码，然后以 admin 登录并修改密码。若之后要更改访问方式，只需重新运行 ./deploy.sh 并选择不同选项。

仅发布 80 和 443 端口；Postgres、Redis、MinIO、API 和 Web 应用都保留在内部网络中。存储的文件通过 API 流式传输，因此对象存储永不暴露。各模式的详细信息请参见 docs/DEPLOY.md。

配置

后端配置是一个根目录下的 .env（参见 .env.example），由 API 和 worker 共同读取。值得了解的几项：

REDCELL_RUN_MODE：live（默认）或 sim。
REDCELL_DATABASE_URL、REDCELL_REDIS_URL、REDCELL_S3_*：基础设施。
REDCELL_SECRET_KEY：用于加密存储凭据的 Fernet 密钥。在投入生产前请设置一个真实的密钥。

提供商 API 密钥、执行镜像、范围护栏和报告品牌信息位于 Settings 页面，并存储在数据库中，在需要处加密。

项目结构

apps/
  api/                 FastAPI: routers, WebSocket streams, auth
  worker/              arq worker: runs engagements and report generation
  web/                 React operator console
packages/
  core/redcell_core/   engine, models, repositories, storage, bus, reporting
  api-client/          the single typed client the UI talks to (mock + HTTP)
docker/                Kali execution image, web/api images, Caddy config
docker-compose.yml           full stack behind a Caddy reverse proxy (self-host)
docker-compose.dev.yml       Postgres + Redis + MinIO
docker-compose.targets.yml   local vulnerable targets
deploy.sh                    interactive self-host deploy

文档

架构 — 各组件、一次运行的流程、跨进程协调。
加固与威胁模型 — 安全部署、密钥、范围和数据保留。在除自己机器之外的任何地方运行 REDCELL 之前请阅读此文。
预认证攻击面 — 未认证客户端可以观察到什么，以及如何将其降到最低。
成本与 token 核算 — 如何衡量运行开销、价格表，以及 OpenRouter 实际成本。
命令面板与快捷键 — 使用 Cmd/Ctrl+K 搜索会话、服务器和代理，以及键盘导航。
更新 — 应用内 Update 按钮以及从 shell 更新。
控制台外壳 — 侧边栏、菜单和下拉定位规则。
表单控件 — 可搜索的组合框，以及何时应优先于原生 select 使用它。

贡献

欢迎贡献。设置、测试和约定请参见 CONTRIBUTING.md，以及行为准则。请通过 SECURITY.md 私下报告安全问题，而非公开 issue。

负责任的使用

这是面向安全专业人员、CTF 和你自己实验室的防御性及授权攻击性工具。请勿将其用于你未获得书面许可测试的系统。维护者不对滥用负责。

redcell

最受欢迎