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

REDCELL 操作员控制台运行中：多智能体图、已验证的关键发现、运行 sqlmap 的实时终端、捕获到的反弹 shell，以及智能体在导出用户表之前向操作员询问

[!WARNING] REDCELL 仅用于教育、研究以及合法的授权安全测试。请仅用它测试你拥有或已获得明确书面许可进行测试的系统，并且仅在约定的范围内使用。未经授权访问或干扰计算机系统在阿塞拜疆（《刑法典》第 271 至 273 条）以及大多数其他国家的法律下均属犯罪。你如何使用它以及是否遵守法律，完全由你自行负责。

它是什么

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 镜像（ghcr.io/martian56/redcell-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。

redcell

最受欢迎