开源 C2 框架 AdaptixC2 安装与使用指南

重启终端或执行 source ~/.bashrc 使环境变量生效，运行 go version 确认版本。

Windows 7 支持补丁： 若需编译能在 Windows 7 上运行的代理（gopher agent），需应用特定的 Go 运行时补丁：

git clone https://github.com/Adaptix-Framework/go-win7 /tmp/go-win7
sudo mv /tmp/go-win7 /usr/lib/

4. 编译项目

所有编译输出文件位于 dist 目录。

直接编译

make

这将同时生成服务端（含扩展器）与客户端。

分步编译

服务端与扩展器：

make server-ext
# 或分别编译
make server
make extenders

客户端：

make client
# 快速并行编译
make client-fast

中文版编译注意事项： 若需编译中文版本，需安装 Qt 的本地化翻译工具链，否则可能失败：

sudo apt install qt6-tools-dev qt6-tools-dev-tools qt6-l10n-tools -y

安装后清理旧构建文件并重新编译：

cd ~/AdaptixC2_i18n-0.9
rm -rf build/
make clean
make

二、配置与启动

1. SSL 证书配置

AdaptixC2 支持 HTTPS 通信，需配置证书。

方法一：项目脚本生成

cd dist
chmod +x ./ssl_gen.sh
./ssl_gen.sh

方法二：手动生成

openssl req -x509 -nodes -newkey rsa:2048 -keyout server.rsa.key -out server.rsa.crt -days 3650

生成的 server.rsa.crt 和 server.rsa.key 需放置在 dist 目录（与 adaptixserver 同路径），否则需在 profile.json 中指定绝对路径。

2. 配置文件 (profile.json)

服务端通过 profile.json 启动，必须包含 JSON 格式的配置文件。启动时指定 -profile 参数。

{
  "Teamserver": {
    "interface": "0.0.0.0",
    "port": 4321,
    "endpoint": "/endpoint",
    "password": "pass",
    "only_password": true,
    "operators": {
      "operator1": "pass1",
      "operator2": "pass2"
    },
    "cert": "server.rsa.crt",
    "key": "server.rsa.key",
    "extenders": [
      "extenders/beacon_listener_http/config.json",
      "extenders/beacon_listener_smb/config.json",
      "extenders/beacon_listener_tcp/config.json",
      "extenders/beacon_agent/config.json",
      "extenders/gopher_listener_tcp/config.json",
      "extenders/gopher_agent/config.json"
    ],
    "access_token_live_hours": 12,
    "refresh_token_live_hours": 168
  },
  "ServerResponse": {
    "status": 404,
    "headers": {
      "Content-Type": "text/html; charset=UTF-8",
      "Server": "AdaptixC2",
      "Adaptix Version": "v1.0"
    },
    "page": "404page.html"
  },
  "EventCallback": {
    "Telegram": { "token": "", "chats_id": [] },
    "Slack": { "webhook_url": "" },
    "Webhooks": [ {} ]
  }
}

关键配置项说明：

• Teamserver：端口、端点、密码、认证模式、SSL 证书路径、扩展器列表及 Token 有效期。
• ServerResponse：非法请求时的 HTTP 响应状态码、头部信息及页面内容。

3. Docker Compose 部署

项目提供了 Docker Compose 配置文件，用于快速构建和运行。

清理命令：

• docker-clean：移除构建容器和镜像（保留运行时）。
• docker-clean-all：移除所有 Docker 工件（包括运行时）。

三、客户端构建 (Windows)

1. 安装 Qt 开发环境

从官网下载 Qt 在线安装器，推荐非系统盘安装（如 D:\Qt）。自定义安装时，建议最小化安装，仅勾选必要的组件：

• 保留：Qt Multimedia, Qt Image Formats
• 取消：Qt Charts (Deprecated), Qt Quick 3D, Qt Shader Tools

2. 构建客户端

1. 将项目复制到 Windows 系统。
2. 启动 Qt Creator，打开 AdaptixClient/CMakeLists.txt。
3. 勾选 Release 模式，点击 Configure。若提示缺失包，更新包后重新打开项目。
4. 将构建类型改为 Release，点击 Build Project (Ctrl+B)。

3. 打包客户端

1. 创建发布目录：

   mkdir "C:\Users\Demo\Desktop\AdaptixC2 Client"
   copy "...\AdaptixClient.exe" "C:\Users\Demo\Desktop\AdaptixC2 Client"
   

2. 使用 windeployqt 打包：

   cd "C:\Users\Demo\Desktop\AdaptixC2 Client"
   D:\Qt\6.10.1\mingw_64\bin\windeployqt.exe AdaptixClient.exe
   

   该工具会自动分析并复制所需的动态链接库、插件等，生成独立运行包。

四、使用教程

1. 启动服务与连接

启动服务端：

./adaptixserver -profile profile.json

启动后会在同级目录创建 data 文件夹存放数据库。

启动客户端：

./AdaptixClient

首次运行会在用户主目录创建 .adaptix 文件夹存储配置。

连接配置：

• User：任意名称
• Password：与 profile.json 中的 password 一致（默认 pass）
• URL：https://服务器 IP:4321/endpoint
• Project：自定义项目名称和存储路径

2. 监听器配置

Gopher 协议监听器

1. 点击 Listeners & Sites，创建 GopherTCP 连接。
2. 设置 Host & port 为 C2 服务器绑定的 IP 和端口。
3. CallBack addresses 填入公网 IP:端口，用于 Agent 回连。
4. 选择操作系统生成 Payload。

HTTP/HTTPS 监听器

1. 创建 BeanHTTP 配置。
2. 设置 URI 路径标识。
3. 启用 Use SSL 需配置证书和密钥。
4. 生成 Payload 进行测试。

3. 会话管理

• Sessions Graph/Table：查看上线 Agent 的状态图与列表。
• 交互式控制台：右键点击会话，选择 Console 进入命令行交互。

4. 快捷方式创建

服务端： 创建 start.sh 脚本，动态读取配置并显示访问地址，赋予执行权限后创建 .desktop 快捷方式。

客户端： 创建 .desktop 文件指向 AdaptixClient 可执行文件，验证语法无误后即可使用。

五、扩展套件 (Extension Kit)

Extension Kit 提供了丰富的内网渗透测试工具（仅限 Windows 环境）。

1. 构建模块

# Ubuntu/Kali
apt install g++-mingw-w64-x86-64-posix gcc-mingw-w64-x86-64-posix mingw-w64-tools
# Arch
pacman -Syu mingw-w64-x86_64-gcc mingw-w64-x86_64-gcc-libs

git clone https://github.com/Adaptix-Framework/Extension-Kit
cd Extension-Kit
make

2. 加载扩展

在客户端菜单中选择 AxScript -> Script manager，加载 .kit.axs 文件即可使用。

3. BOF 功能组

框架内置多种 BOF (Beacon Object Files) 模块，涵盖以下场景：

• AD-BOF：活动目录查询、账户接管、DCSync 等。
• ADCS-BOF：证书服务枚举、ESC3 攻击、Shadow Credentials 等。
• Kerberos-BOF：AS-REP 烘焙、TGT/TGS 获取、票据伪造等。
• SQL-BOF：SQL Server 信息收集、命令执行、权限提升等。
• LDAP-BOF：ACL 管理、对象属性读写、委派配置修改等。
• Creds-BOF：凭据转储、LSASS 内存读取、Cookie 提取等。
• Elevation-BOF：SYSTEM 提权、UAC 绕过、Potato 系列攻击等。
• Execution-BOF：.NET 程序集执行、非托管代码注入等。
• Injection-BOF：Shellcode 注入、进程劫持等。
• LateralMovement-BOF：PsExec、WinRM、令牌窃取等横向移动。
• PostEx-BOF：防火墙规则管理、截图、文件搜索等后渗透。
• Process-BOF：进程句柄查找、网络连接监控等。
• SAL-BOF：系统信息枚举、ARP/DNS/路由表查询等。
• SAR-BOF：智能端口扫描、计划任务收集、NetBIOS 扫描等。

注：本文档仅供技术研究与授权测试使用，请严格遵守相关法律法规。