
AIレッドチームプラットフォーム。自律型LLMエージェントがKaliコンテナ内でペネトレーションテストをエンドツーエンドで実行し、レポートを作成します。LangGraphのplan/actエンジン、LiteLLM経由のプロバイダー非依存モデル、PDF/JSON/SARIF出力。FastAPI + React。
ペネトレーションテストをエンドツーエンドで実行し、レポートを作成するAIエージェント。
[!WARNING] REDCELLは教育、研究、および合法的かつ許可されたセキュリティテストのみを目的として提供されています。自身が所有するシステム、またはテストに対する明示的な書面による許可を得たシステムのみを、合意されたスコープ内でのみ使用してください。コンピュータシステムへの不正アクセスや妨害は、アゼルバイジャン(刑法第271条から第273条)およびその他のほとんどの国の法律において犯罪です。どのように使用するか、および法律を遵守することは、完全にあなたの責任です。
REDCELLはLLMエージェントのチームをペネトレーションテストに投入します。オーケストレーターがエンゲージメントを計画し、実行エージェントに目標を渡します。実行エージェントはKaliコンテナ内で実際のツールを実行し、結果を報告します。オペレーターコンソールから実行を監視・操作できます。オーケストレーターを操作するチャット、ライブのエージェントグラフとアクティビティフィード、エージェントが操作するブラウザのライブビュー、エージェントが捕捉したリバースシェル上のターミナル、そして作業完了時に引き渡すレポートが含まれます。
モデルはLiteLLMを通じてプラグイン可能なため、OpenAI、Anthropic、Google、GLM、DeepSeek、Kimi、ローカルのOllama、その他サポートされている任意のものに向けることができます。すべての実行は進行中にチェックポイントを保存するため、クラッシュや再起動が発生しても中断した箇所から再開できます。
run_commandがカバーします。docker execを介してKaliコンテナ内で実行されます。セッションごとにlocalhostまたは保存済みサーバーを選択できます。リモートサーバーはSSH経由でホストネットワーキングを使って同じコンテナを実行します。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 はエージェントを実行しません。実行をキューに登録し、ワーカーがそれを実行し、ワーカーが出力を 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。
# 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
プロセス・マネージャーを使って3つすべてを一度に起動する(Procfile で宣言されている):pipx install honcho を実行してから honcho start。
http://localhost:5183 を開き、admin / admin でサインインする。
実行はデフォルトで実際のツールを実行する。設定でプロバイダーの 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
公開されているイメージを使用し、Caddy リバースプロキシの背後で REDCELL をサーバー上で実行します。これにより、Web アプリと API が同一オリジンを共有し(CORS 不要)、HTTPS が自動的に処理されます。新規サーバー上で:
git clone https://github.com/martian56/redcell.git
cd redcell
./deploy.sh
スクリプトは Docker がインストールされていない場合にインストールし、その後 REDCELL へのアクセス方法を尋ねます:
https://your-domain を提供します。回答は .env に書き込まれ、イメージがプルされ、スタックが起動します。生成された管理者パスワードは docker compose logs init-secrets で確認し、admin としてサインインして変更してください。後でアクセス方法を変更するには、./deploy.sh を再実行して別のオプションを選択するだけです。
公開されるのはポート 80 と 443 のみです。Postgres、Redis、MinIO、API、Web アプリは内部ネットワーク上に留まります。保存されたファイルは API 経由でストリーミングされるため、オブジェクトストレージが公開されることはありません。各モードの詳細については docs/DEPLOY.md を参照してください。
バックエンドの設定は単一のルート .env(.env.example を参照)で、API とワーカーの両方が読み込みます。知っておくべき項目は以下のとおりです:
REDCELL_RUN_MODE: live(デフォルト)または sim。REDCELL_DATABASE_URL、REDCELL_REDIS_URL、REDCELL_S3_*: インフラストラクチャ。REDCELL_SECRET_KEY: 保存された認証情報を暗号化するための Fernet キー。本番環境に移行する前に実際の値を設定してください。プロバイダーの API キー、実行イメージ、スコープのガードレール、レポートのブランディングは設定ページにあり、データベースに保存され、必要な箇所では暗号化されます。