Cybermes 是一个面向授权渗透测试、Bug Bounty 赏金狩猎与红队演练的自主安全智能体框架，内置 Go 高性能工具链、200+ 攻击技能库与 MCP 协议支持。本文是面向新手的Cybermes 跨平台部署完整教程，手把手讲解 Windows、Linux、Docker 三种环境的一键安装步骤，并重点介绍doctor.py环境体检与--fix自修复能力，帮助你在 10 分钟内完成搭建并跑通第一次安全评估。

部署前准备：选对平台，装好 3 个依赖

Cybermes 支持三大部署方式，按你的使用场景选择即可：

无论哪种方式，都先确认这 3 项依赖：

• Git：用于拉取仓库
• Python 3.10+（推荐 3.11+）：Windows 安装时务必勾选"Add Python to PATH"
• Go 1.22+（可选）：用于编译smart_pipe、secret_scan等 5 个原生 Go 工具

💡 Windows 用户若计划使用 WSL2 或手动安装，可参考官方指南 docs/INSTALL_WINDOWS.md。

Windows 快速安装：一键脚本 7 步走

第 1 步：开启 Git 长路径支持。Cybermes 知识库文件较深，可能超过 Windows 的MAX_PATH限制：

git config --global core.longpaths true

第 2 步：克隆仓库并安装

git clone https://gitcode.com/gh_mirrors/cy/Cybermes cd Cybermes Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser .\setup_windows.ps1

安装脚本会自动完成：校验 Python 版本 → 创建venv虚拟环境 → 安装 Python 依赖 → 初始化reports/、recon/等工作目录 → 生成.env与.hermes/config.yaml。

第 3 步：填写 API 密钥

notepad .env

填入你的 LLM 凭据（如ROUTER_API_KEY或OPENROUTER_API_KEY）。

第 4 步：体检 + 首次运行

python tools\doctor.py --fix .\cybermes.bat "Assess https://example.com"

Linux / macOS 安装：一条命令完成初始化

Linux 与 macOS 的流程更简洁，setup.sh会连 Playwright 浏览器、Node.js MCP 服务、技能库同步一起处理好：

git clone https://gitcode.com/gh_mirrors/cy/Cybermes cd Cybermes ./setup.sh nano .env # 填入 API 密钥 python3 tools/doctor.py --fix ./cybermes "Assess https://example.com"

setup.sh 内部依次执行了 10 步：检查 Python → 创建 7 个工作目录 → 建立venv并安装 requirements.txt 依赖 → 安装 Playwright Chromium → 安装 Node 版 MCP 服务 → 同步skills/技能库 → 初始化.env/.hermes/config.yaml/auth.json→ 若检测到 Go 则编译 5 个原生工具 → 下载 subfinder、httpx、katana、nuclei 安全工具链 → 修正文件权限。

Docker 容器化部署：隔离环境最快方案

Docker 方式把 nmap、ripgrep、Chrome、Node.js、Go 工具链全部打包进 Dockerfile，构建时还会按 CPU 架构自动重编译 Go 二进制（Apple Silicon 无需交叉编译）：

git clone https://gitcode.com/gh_mirrors/cy/Cybermes && cd Cybermes cp .env.example .env && nano .env docker compose up -d docker compose exec cybermes cybermes "Assess https://example.com"

docker-compose.yml 将targets/、recon/、output/、reports/、logs/等目录挂载到宿主机，容器内 entrypoint.sh 每次启动会自动修复权限、清理"目录陷阱"并同步.env与技能库，基本无需人工干预。

doctor.py 环境自修复：4 类体检，--fix 一键修

这是 Cybermes 对新手最友好的设计。doctor.py相当于系统体检中心，输出[OK]/[WARN]/[FAIL]/[FIXED]四色状态：

python tools/doctor.py # 只体检 python tools/doctor.py --fix # 体检 + 自动修复

tools/doctor.py 覆盖 4 大检查模块：

体检结束会输出Passed / Warnings / Failures三项汇总，只要 Failures 为 0，即可放心开跑。遇到 LLM 连接被拒、文件权限报错、Go 工具架构不匹配等进阶问题，可查阅 docs/troubleshooting.md。

部署验证：用内置靶场跑通第一次评估

不确定的目标？Cybermes 自带一个无害的模拟漏洞靶场，适合验证整个流程是否打通：

python examples/mock_vulnerable_app.py # 启动 http://127.0.0.1:8888 ./cybermes "Assess http://127.0.0.1:8888"

Docker 环境下对应：

docker compose exec cybermes cybermes "Assess http://127.0.0.1:8888"

看到reports/目录下生成SUMMARY.md与report.html，就说明从部署到产出的全链路已完全跑通。🎯

⚠️合规提醒：Cybermes 仅可用于已获得授权的安全测试、Bug Bounty 与防御性研究，请始终在 scope.yaml 定义的目标范围内开展评估。