Windows、Linux与Docker部署Cybermes：跨平台安装完整教程与doctor.py环境自修复-平芜编程栈

【免费下载链接】Cybermes

Autonomous Offensive Security, Bug Bounty & Red Teaming Agent Framework powered by Hermes Agent, specialized reasoning skills, and multi-model LLM orchestration.

项目地址：https://gitcode.com/gh_mirrors/cy/Cybermes

点击查看免费下载

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

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

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

部署方式	一键脚本	适合人群	特点
🪟 Windows 原生	setup_windows.ps1	日常 Windows 用户、新手	无需虚拟化，5 分钟搞定
🐧 Linux / macOS	setup.sh	服务器、Kali 用户	完整 Linux 工具兼容性
📦 Docker	docker-compose.yml	追求隔离环境者	零依赖冲突，Apple Silicon 也能跑

无论哪种方式，都先确认这 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 大检查模块：

检查模块	检查内容	`--fix`自动修复行为
1️⃣ Python 环境	版本 ≥3.10、venv 是否激活、requests / yaml / jinja2 / rich / markdown 是否安装	提示缺失包
2️⃣ 工作目录与权限	`reports`、`recon`、`output`、`logs`、`targets`、`skills`、`tools/bin`是否存在且可写	自动创建缺失目录
3️⃣ 配置与凭据	`.env`、`.hermes/config.yaml`、`.hermes/auth.json`是否存在	从`.env.example`生成`.env`；从`config.yaml.example`恢复配置；清除"配置文件变成了目录"的 Docker 挂载陷阱；初始化空 JSON；同步`.hermes/.env`
4️⃣ 安全工具链	`smart_pipe`、`secret_scan`、`search_knowledge`、`aggregate_reports`、`subfinder`、`httpx`、`katana`、`nuclei`是否可用	自动调用 tools/update_tools.sh（Windows 为 tools/update_tools.ps1）下载缺失工具

体检结束会输出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 定义的目标范围内开展评估。

【免费下载链接】Cybermes

Autonomous Offensive Security, Bug Bounty & Red Teaming Agent Framework powered by Hermes Agent, specialized reasoning skills, and multi-model LLM orchestration.

项目地址：https://gitcode.com/gh_mirrors/cy/Cybermes

点击查看免费下载