Infection Monkey 开发环境搭建指南:Monkey Island 服务端手动配置与运行实战

原创2026-10-07 17:53:332,136 阅读
文章标签:网络安全应用安全

Infection Monkey 开发环境搭建指南:Monkey Island 服务端手动配置与运行实战

本文围绕仓库内 monkey/monkey_island/readme.md 展开,系统讲解 Infection Monkey 中 C&C 服务端 Monkey Island 的完整开发环境搭建流程,覆盖 Windows 与 Linux 双平台下的 Python 3.11 依赖安装、MongoDB 与 OpenSSL 配置、SSL 证书生成、Agent 二进制放置、前端构建以及最终的服务端启动方式,并结合仓库源码(如 server_setup.py、create_certificate.sh)剖析启动链路与配置项含义,帮助开发者从零建立起一套可运行、可调试的 Monkey Island 开发环境。

Monkey Island 是 Infection Monkey 的指挥与控制(C&C)服务器,承载着 Web 管理界面、Agent 配置下发、仿真结果存储等核心职责。对希望参与二次开发或本地调试的工程师而言,手动搭建其开发环境是理解整套系统的最佳起点。本文档以原 readme 为骨架,逐条展开 Windows、Linux 两条搭建路径,并补充源码级佐证,确保每一步都有据可查、可直接复现。

一、搭建前概览:Monkey Island 的技术栈与两种搭建路线

Monkey Island 服务端并非单一进程,而是一套组合:

  • Python 3.11 提供后端服务,通过 gevent 的 WSGIServer 承载 HTTP 请求(见 server_setup.py),监听 HTTPS 端口;
  • MongoDB 6.0 负责持久化 Agent 事件、机器信息、仿真状态等数据,可通过 MONKEY_MONGO_URL 环境变量指向外部实例,也可由服务端自动拉起本地进程;
  • Node.js 前端 提供 Web 交互界面(旧版 UI 位于 cc/ui,新版 Next.js UI 位于 cc/next_ui,由 NEXT_JS_UI_FEATURE 特性开关控制);
  • OpenSSL 生成的 HTTPS 证书 保障管理界面与 Agent 通信的安全。

原文档给出了两种环境准备路线:

  1. 一键脚本(推荐先试):直接使用仓库根目录的 deployment_scripts 目录,其中包含 deploy_linux.sh、deploy_windows.ps1 及配套的 config / config.ps1 配置文件,可自动化完成大部分环境装配;
  2. 手动搭建(本文主体):当脚本不适用于你的系统、或希望逐步骤理解依赖关系时,按 readme 的指引手动安装。

需要特别提醒的是:请务必在隔离的虚拟机、容器或专门的安全环境中搭建,因为后续运行 Agent 本身会执行横向移动、凭据收集等攻击行为模拟,切不可在真实生产网络直接演练。

二、Windows 环境手动搭建

以下步骤均在 Windows 命令提示符(cmd)中执行,且除特殊说明外,当前工作目录均为 monkey_island。

2.1 排除杀毒软件干扰

Monkey 会以攻击模拟的方式运行,杀毒软件(AV)极可能拦截甚至删除其安装目录中的文件。搭建前务必先将计划安装 Monkey 的文件夹加入 AV 白名单,否则后续步骤可能莫名失败,且问题难以定位。

2.2 准备目录与 Python 3.11.2

  1. 在 monkey\monkey_island 下创建 bin 目录(后续 MongoDB、OpenSSL 便携版均存放于此);
  2. 下载并安装便携版(portable)Python 3.11.2,版本需与项目锁定的依赖兼容——monkey_island/Pipfile 中的依赖约束即基于该 Python 版本解析。

2.3 安装 pipx 与 pipenv

pipx 用于在隔离环境中安装 Python 命令行工具,pipenv 则负责按 Pipfile.lock 精确还原项目依赖:

pip install --user -U pipx
pipx ensurepath
pipx install pipenv

执行 pipx ensurepath 后建议重开终端,确保 pipenv 进入 PATH。

2.4 安装 Python 依赖

在 monkey\monkey_island 目录下运行:

pipenv sync --dev

sync(而非 install)会严格按照 Pipfile.lock 中锁定的版本安装,--dev 同时安装开发期依赖(如 pytest 等测试工具),这是保证多人开发环境一致性的关键。

2.5 配置 MongoDB(二选一)

方案 A:使用便携版 MongoDB

  1. 下载 MongoDB Windows x86_64 6.0.4 归档包(与 install_mongo.sh 锁定的 6.0.4 版本保持一致);
  2. 将压缩包内 bin 目录中的内容解压到 \monkey\monkey_island\bin\mongodb。

方案 B:复用已有 MongoDB 实例

set MONKEY_MONGO_URL="mongodb://<SERVER ADDR>:27017/monkey_island"

将 <SERVER ADDR> 替换为实际 MongoDB 服务地址。该环境变量会覆盖默认连接串,服务端启动时读取它来决定连接目标(见下文"配置要点"一节)。文档同时保留了 windows/install_mongo.ps1 脚本,可辅助自动化安装。

2.6 安装便携版 OpenSSL

下载 OpenSSL 1.0.2p(Windows 32 位便携版),将内容解压到 monkey_island\bin\openssl,供后续生成 HTTPS 证书使用。

2.7 安装 Microsoft Visual C++ Redistributable

安装 Visual Studio 2017 的 Microsoft Visual C++ Redistributable。许多 Python 扩展(尤其涉及二进制编译的部分)依赖 VC++ 运行库,缺失会导致导入模块时 DLL 加载失败。

2.8 生成 SSL 证书

证书由仓库自带的批处理脚本生成,运行前先 cd 到 monkey_island 目录:

./windows/create_certificate.bat

Windows 版的脚本逻辑与 linux/create_certificate.sh 对应:生成 2048 位 RSA 私钥 server.key、证书签名请求 server.csr,并以自签名方式签发有效期 366 天的 server.crt(证书主体 CN=monkey.com)。生成产物默认落在 cc/ 目录,服务端启动时由 server_setup.py 读取并绑定到 WSGIServer。

2.9 放置 Agent 二进制

在 monkey_island/cc/binaries 目录中放入两种 Agent 可执行文件(可从官方 release 获取或自行从源码构建):

文件名 用途
monkey-linux-64 Linux 64 位 Agent
monkey-windows-64.exe Windows 64 位 Agent

该目录正是 Agent 二进制分发的源头,Monkey Island 会通过 HTTP 将这里的二进制提供给各目标机器执行。目录不存在时需手动创建:mkdir monkey\monkey_island\cc\binaries。

2.10 安装 npm 并构建前端

  1. 安装 npm(Node.js 自带包管理器,安装 Node.js 即包含 npm);
  2. 进入前端源码目录:
cd monkey_island\cc\ui
npm update
npm run dist

npm update 将依赖更新至 package.json 声明范围,npm run dist 则执行 webpack 打包(见 cc/ui/webpack.config.js),产出浏览器可加载的静态资源。

2.11 启动服务端

保持当前工作目录为 monkey_island,执行:

monkey_island\windows\run_server_py.bat

该脚本实际做了两件事(见 run_server_py.bat):

pipenv run windows\run_cc.bat
start https://localhost:5000

先用 pipenv 启动后端(run_cc.bat 内部执行 python monkey_island.py),随后自动打开浏览器访问 https://localhost:5000。由于是自签名证书,浏览器会弹出不受信任提示,选择"继续访问"即可。

三、Linux 环境手动搭建

Linux 路径与 Windows 大同小异,但涉及系统包安装与权限处理,此处逐条展开。

3.1 准备工作目录与 Python 3.11

先将当前工作目录切换到 monkey/(仓库根目录下的 monkey/ 文件夹)。若发行版未内置 Python 3.11(下文以 Ubuntu 系为例),通过 deadsnakes PPA 安装:

sudo add-apt-repository ppa:deadsnakes/ppa
sudo apt-get update
sudo apt install python3.11 python3-pip python3.11-dev python3.11-venv
python3.11 -m pip install pip

文档示例基于 Ubuntu 16 编写,modern 发行版可直接使用系统源或官方 PPA;核心目标是获得 Python 3.11 + pip。

3.2 安装 pipx 与 pipenv

python3.11 -m pip install --user pipx
python3.11 -m pipx ensurepath
source ~/.profile
pipx install pipenv

3.3 安装系统依赖包

sudo apt-get install libffi-dev upx libssl-dev libc++1 openssl

其中 libffi-dev 与 libssl-dev 是部分 Python 原生扩展的编译依赖,upx 用于 Agent 二进制压缩,openssl 提供证书生成工具。

3.4 安装 Python 依赖

cd ./monkey_island
pipenv sync --dev
cd ..

3.5 创建必要目录

在 monkey/ 目录下执行:

mkdir -p ./monkey_island/bin/mongodb
mkdir -p ./monkey_island/cc/binaries

3.6 放置 Agent 二进制

将 monkey-linux-64、monkey-windows-64.exe 放入 ./monkey_island/cc/binaries。若打算在本机直接运行 Linux Agent,还需赋予执行权限:

chmod 755 ./monkey_island/cc/binaries/monkey-linux-64

3.7 配置 MongoDB(二选一)

方案 A:脚本自动下载便携版

./monkey_island/linux/install_mongo.sh ./monkey_island/bin/mongodb

该脚本会根据 /etc/issue 自动识别发行版,为 Ubuntu 18.04/20.04/22.04、Debian 10/11、Kali 分别挑选对应的 MongoDB 6.0.4 归档(用 wget 或 curl 下载),解压后将 mongod 可执行文件复制到指定目录并赋权(详见 install_mongo.sh)。不支持的发行版会直接退出并提示 Unsupported OS。

方案 B:复用已有 MongoDB 实例

set MONKEY_MONGO_URL="mongodb://<SERVER ADDR>:27017/monkey_island"

在 bash 中更规范的写法是 export MONKEY_MONGO_URL="mongodb://<SERVER ADDR>:27017/monkey_island";将 <SERVER ADDR> 替换为实际地址即可。

3.8 生成 SSL 证书

cd ./monkey_island
chmod 755 ./linux/create_certificate.sh
./linux/create_certificate.sh

脚本除生成 server.key / server.csr / server.crt 外,还处理了旧版 OpenSSL 随机种子文件(~/.rnd)的兼容问题,并以 umask 377 保证私钥权限安全。

3.9 安装 Node.js 并构建前端

sudo apt-get install curl
sudo mkdir -p /usr/local/lib/nodejs
curl -sL <官方下载地址> | sudo tar xJf - -C /usr/local/lib/nodejs
echo -e "# Nodejs\nexport PATH=/usr/local/lib/nodejs/node-v20.7.0-linux-x64/bin:\$PATH" >> ~/.profile && source ~/.profile

其中 <官方下载地址> 为 Node.js v20.7.0 Linux x64 二进制包的实际 URL(可从 Node.js 官方发行渠道获取,文件名形如 node-v20.7.0-linux-x64.tar.xz)。随后构建前端:

cd monkey_island/cc/ui
npm install sass-loader node-sass webpack --save-dev
npm update
npm run dist

与 Windows 路径相比,Linux 多了 sass-loader / node-sass / webpack 三个构建期依赖的显式安装步骤,这些是旧版 webpack 构建链的组成部分。

3.10 启动服务端

python3.11 ./monkey_island.py

该命令须在 monkey/ 目录下执行。monkey_island.py 会经由 main.py 初始化日志与 gevent 运行环境,最终调用 server_setup.py 的 run_monkey_island() 完成服务装配。日志中会打印本机可访问 Web 界面的 HTTPS 地址,浏览器打开即可。

四、启动流程与关键配置项解析

4.1 服务端启动链路(源码视角)

python3.11 ./monkey_island.py 之后的实际流程可概括为(见 server_setup.py):

  1. 解析 CLI 参数(parse_cli_args);
  2. 读取并校验服务端配置(get_server_config),非法配置直接退出;
  3. 初始化数据目录并配置日志(setup_data_dir + setup_logging);
  4. 收集本机 IP、部署类型(deployment.json 定义)与版本号;
  5. 初始化 MongoDB 连接:若配置 start_mongodb: true 则拉起本地 mongod 进程,再建立连接(超时/版本异常会记录日志并退出);
  6. 初始化 DI 容器并注册事件处理器;
  7. 以 WSGIServer 在 0.0.0.0:FLASK_PORT 上启动 HTTPS 服务,加载 server.key/server.crt,随后打印访问地址。

4.2 server_config.json 配置说明

默认配置位于 monkey_island/cc/server_config.json:

{
  "island_port": 443,
  "log_level": "DEBUG",
  "mongodb": {
        "start_mongodb": true
  }
}
配置项 含义 说明
island_port 服务监听端口 旧版 Flask UI 实际使用 FLASK_PORT 常量(见 server_utils/consts.py);新版 Next.js UI 则直接使用该端口
log_level 日志级别 开发期建议保持 DEBUG,生产可调为 INFO
mongodb.start_mongodb 是否自动启动本地 MongoDB 为 true 时由 mongo_setup.start_mongodb() 拉起 bin/mongodb/bin/mongod;为 false 时仅连接外部实例(配合 MONKEY_MONGO_URL 使用)

此外,服务端还读取 cc/deployment.json 确定部署形态,并通过 --setup-only 等 CLI 参数支持仅初始化不启动的模式。

4.3 外部 MongoDB 连接

当不启用本地 MongoDB 时,必须预先通过 MONKEY_MONGO_URL 指定连接串,格式为 mongodb://<主机>:27017/monkey_island。注意 27017 是 MongoDB 默认端口,monkey_island 是目标数据库名,需与实际部署一致。

五、常见问题与故障排查

原文档专门针对 pre-commit 钩子报错 给出排查方案:首次提交代码时若抛出依赖缺失类错误,通常是系统级 Python 环境缺少部分开发依赖。解决思路是利用 pipenv 为 infection_monkey/ 与 monkey_island/ 分别导出依赖清单,再用系统 pip 安装:

cd [代码位置]/infection_monkey
python3.11 -m pipenv lock -r --dev > requirements.txt
python3.11 -m pip install -r requirements.txt
cd [代码位置]/monkey_island
python3.11 -m pipenv lock -r --dev > requirements.txt
python3.11 -m pip install -r requirements.txt

pipenv lock -r --dev 会把当前锁定的依赖(含开发依赖)以 requirements 格式输出,从而绕开 pipenv 虚拟环境,直接补齐系统环境缺口。

其他高频问题速查:

  • 浏览器提示证书不受信任:属正常现象(自签名证书),手动放行即可;
  • MongoDB 无法启动:检查 bin/mongodb/bin/mongod 是否存在、是否有执行权限,并查看服务端日志中的数据目录提示(MongoDbProcess.log_file);
  • 端口被占用:server_setup.py 会校验端口占用并给出明确错误,可修改 server_config.json 的 island_port 后重启;
  • 前端页面空白:确认已执行 npm update && npm run dist 完成打包,且构建产物目录完整;
  • 本机运行 Agent 被拒绝:Linux 下检查二进制是否已 chmod 755。

六、验证搭建成果

完成上述步骤后,可以按以下顺序快速验证环境是否就绪:

  1. 浏览器访问服务端日志打印的 HTTPS 地址,确认 Web 界面正常加载;
  2. 在"配置"页面下发一套低风险配置(例如禁用所有 Exploiter),观察 Agent 注册与事件上报是否写入 MongoDB;
  3. 在 monkey_island/cc/binaries 中确认两类 Agent 二进制存在,尝试手动运行 monkey-linux-64,观察 Infection Map 上是否出现新节点。

至此,一套完整的 Monkey Island 开发环境即告建成。后续无论是调试后端事件处理链路(cc/services)、扩展插件机制,还是改造新版 Next.js 前端(cc/next_ui),都可以在本地方便地进行修改与重启验证。若希望跳过手动步骤,也可直接参考 deployment_scripts 中的自动化脚本,快速获得同等环境。

登录后查看全文
monkey