BlackBerryC2 2.0.0-beta

BlackBerryC2 是一个加密远程管理和 C2 框架，专为教育用途、安全研究和受控实验环境设计。

该项目展示了如何构建一个自定义命令与控制服务器，具备应用层加密、会话管理和安全客户端通信，无需依赖外部 TLS 协议栈。

⚠️ 重要声明

本项目不是恶意软件，也不用于未经授权的访问。

BlackBerryC2：

• 不会自我传播
• 不会自动利用漏洞
• 不包含持久化机制
• 不会尝试规避反病毒软件

请仅在您拥有或已获得明确授权测试的系统与网络上使用。

Python 依赖：

pip install cryptography prompt_toolkit zstandard

zstandard 为可选依赖，建议在传输大于 1 GB 的文件时使用。

主要特性

• 基于自定义 TCP 的加密 C2 服务器（v2.0）
• ECDHE（secp256r1）密钥交换 —— 临时或持久
• 每个会话使用 AES-256-GCM 认证加密
• 每数据包 HMAC-SHA256 认证 + 反重放序列号
• 多并发客户端会话
• 交互式操作员控制台，支持 Tab 补全（prompt_toolkit）
• 加密远程命令执行
• 加密文件传输，支持 zlib / Zstandard 压缩
• 递归目录上传/下载（get -r，put -r）
• 后台传输（-b 标志）—— 非阻塞，可取消
• 传输断点续传支持（.partial + .resume 文件）
• 客户端载荷生成器（generate-payload）
• IP 封锁：持久黑名单 + 临时自动封禁
• 扫描/洪水检测：连接扫描、服务标识获取、握手失败、心跳洪水
• 可选的 HTTP(S)/TLS 代理支持（BlackBerryHTTPs_TLSProxyGUI）
• SPA（单包授权）和端口敲门预认证
• BerryTransfer 模式 —— 专用的纯文件传输服务器（无 shell）
• 加密会话日志（AES-256-GCM + PBKDF2，60 万次迭代）
• 加密服务器日志，支持 shell 内查看（log 命令）
• 启动配置保存至 logs/last_start.json

加密设计

BlackBerryC2 v2.0 按以下步骤建立安全通信：

1. 客户端通过 TCP 连接；服务器发送服务横幅。
2. 客户端发送 REQUEST_PUBKEY。
3. 服务器发送其临时 ECDHE 公钥（secp256r1）。
4. 客户端发送其 ECDHE 公钥 + HMAC-SHA256 认证标签。
5. 服务器根据预共享密钥（HMAC_PRE_SHARED_SECRET）验证 HMAC。
6. 双方通过共享密钥，利用 HKDF-SHA256 派生出一个 256 位的 AES 会话密钥。
7. 后续所有通信均使用 AES-256-GCM，每数据包带有 HMAC-SHA256 和反重放序列号。

每个会话维护：

• 自己的 AES-256 密钥和 HMAC 密钥
• 独立的一次性随机数（每条消息 12 字节随机）
• 隔离的反重放跟踪器（序列窗口 ±100）
• 洪水保护速率限制器（可配置的每秒命令数）

所有加密密钥在运行时生成，重启后不会重复使用（除非设置了 --persistente）。

运行服务器

python3 BlackBerryC2_server.py

默认配置：

• 主机：0.0.0.0
• 端口：9949

命令行参数

示例：

# 基本启动（提示输入日志密码短语）
python3 BlackBerryC2_server.py

# 持久 ECDHE 密钥 + 详细日志
python3 BlackBerryC2_server.py -p -vv

# 自定义端口，不进行 HMAC 检查
python3 BlackBerryC2_server.py -P 8080 --no-secure

# 自定义端口上的端口敲门
python3 BlackBerryC2_server.py --spa --spa-mode knock --knock-seq 9001,9002,9003

# BerryTransfer 模式 + 自动确认
python3 BlackBerryC2_server.py --berrytransfer --auto-confirm

# 查看/解密日志而不启动服务器
python3 BlackBerryC2_server.py --logs

操作员控制台命令

服务器管理

代理

会话命令（在 select <ID> 内部）

通用

文件传输

BerryTransfer 模式

BerryTransfer 是一种专用的纯文件传输服务器模式，灵感来自 scp。激活后，服务器拒绝所有 shell 访问，仅接受 BT:* 协议命令。

启动：

python3 BlackBerryC2_server.py --berrytransfer
python3 BlackBerryC2_server.py --berrytransfer --auto-confirm  # GET 请求无需操作员提示

BerryTransfer shell 命令：

传输日志写入 logs/bt_transfer.jsonl（可选择 AES-256-GCM 加密）。

SPA / 端口敲门

当激活 --spa 时，客户端必须在 TCP 连接被接受前通过 UDP 进行认证。

SPA 模式（默认）：客户端向 SPA_UDP_PORT 发送一个 32 字节的 HMAC-SHA256 令牌。

token = HMAC-SHA256(HMAC_SECRET, "{ip}:{time_window_30s}")

敲门模式：客户端按顺序向一个 UDP 端口序列敲门，必须在超时窗口内完成。

python3 BlackBerryC2_server.py --spa --spa-mode knock --knock-seq 7001,7002,7003 --knock-timeout 10

授权 IP 在 --spa-ttl 秒内有效（默认 60）。

安全特性

日志记录

使用内置查看器查看日志：

BlackBerry> log

或者独立查看（不启动服务器）：

python3 BlackBerryC2_server.py --logs

预期用途

本项目仅适用于：

• 教育演示
• 安全研究
• 受控实验室环境
• 授权渗透测试

严禁在未经许可的系统上未经授权使用。

许可证

完整的许可证详情请见 LICENSE 文件。

免责声明

本软件按“原样”提供，不附带任何形式的担保。
作者对因使用本软件而产生的任何滥用或损害概不负责。