Decepticon

环境要求

• 已安装 Docker（Docker Desktop 或 docker engine）
• 已安装 Docker Compose v2
• 支持 macOS（Apple Silicon 与 Intel）、Linux（amd64 与 arm64）、Windows（amd64 与 arm64，原生 Po
• 需要一个可用的模型服务商账号与 API Key（onboard 向导中填写）
• 自托管需本机能访问外网以下载安装脚本和镜像

安装与启动步骤

1. 1安装 Docker 环境

   先按官方文档装好 Docker 和 Docker Compose v2，确认 docker 命令可用再继续；Windows 用户可选择原生 PowerShell 或 WSL2。

2. 2运行安装脚本

   macOS / Linux / WSL2 下执行官方一键安装脚本，脚本会拉取 Decepticon 安装内容，执行前请确认网络可访问 decepticon.red。

   curl -fsSL https://decepticon.red/install | bash

   复制

3. 3Windows 安装

   Windows 原生 PowerShell 中改用 PowerShell 版安装脚本，以 irm 下载并直接执行；若用 WSL2 则改走上一段 bash 命令。

   irm https://decepticon.red/install.ps1 | iex

   复制

4. 4完成交互式配置

   运行 onboard 向导，按提示依次填写模型服务商（provider）、API Key 和模型 profile，这是后续代理能否正常推理的关键。

   decepticon onboard

   复制

5. 5启动核心栈

   执行 decepticon 启动核心管理平面（LiteLLM、PostgreSQL、Neo4j、Skillogy、LangGraph、sandbox），并直接进入终端 CLI 交互界面。

   decepticon

   复制

6. 6按需拉起专家组件

   在 CLI 中通过编排器按需启动专业负载，例如输入 ops_start("ad") 拉起 BloodHound CE 等，不用时不启动以省资源。

7. 7打开 Web 面板

   如需图形化界面，在 CLI 内输入 /web 拉起 Web dashboard；默认启动不包含面板，属于按需启动的组件。

   /web

   复制

关键配置

如何确认成功

执行 decepticon 后能进入终端 CLI，且核心栈（LiteLLM、PostgreSQL、Neo4j 等）正常拉起，即启动成功。

常见问题

注意事项

• 必须使用 Docker Compose v2，版本过低可能无法启动核心栈。
• 默认启动的核心组件包括 LiteLLM、PostgreSQL、Neo4j、Skillogy、LangGraph 和 sandbox，首次拉取镜像耗时较长。
• onboard 中的 API Key 属于敏感凭据，请勿提交到公开仓库或截图外发。
• 本工具用于授权范围内的红队与渗透测试，请确保对目标拥有合法测试授权。