cybersecnatlab/socaz

SoCaz - socat的替代品，专为CTF设计的特殊功能工具

镜像概述和主要用途

SoCaz是一款替代socat的工具，专为CTF（夺旗赛）场景开发，提供比传统socat更丰富的CTF特定功能。它支持端口绑定、命令执行、动态标志生成、连接控制、权限管理及DoS防护等，适用于CTF竞赛中服务部署、动态flag生成和安全连接管理等需求。

核心功能和特性

• 端口绑定与命令执行：支持绑定指定地址和端口，执行自定义命令并将输出通过TCP连接返回
• 输出重定向：可将stderr重定向到TCP连接或工具自身stderr
• 连接控制：支持超时设置、最大连接数限制、IP级连接数限制及连接丢弃策略
• 权限管理：支持降级到指定UID/GID（仅Unix系统），提升运行安全性
• 动态标志生成：支持生成含随机字符串、客户端IP的自定义flag，可通过哈希、Base64、截取、加密、签名等过滤器处理
• DoS防护：集成Proof of Work（PoW）机制，基于Hashcash防止连接

使用场景和适用范围

• CTF竞赛中需要动态生成含客户端信息的flag的服务部署
• 需限制单IP连接数或总连接数的场景
• 需要执行命令并通过网络返回结果的服务（如交互式题目）
• 需对服务进程进行权限隔离的场景
• 需防止DoS***的公开CTF服务

详细使用方法和配置说明

基本使用示例

bash
# 通过--cmd参数指定执行命令
./socaz --bind 1337 --cmd "python3 ./test.py"

# 直接将命令作为位置参数传递（--后为命令）
./socaz --bind 1337 -- python3 ./test.py

命令参数详解

Usage: socaz [OPTIONS] --bind <BIND> [CMD]...

位置参数

• [CMD]...：要执行的命令（例如 "run.sh", "python ./script.py"）

选项说明

Flag格式

Flag模板支持嵌入指令，指令用方括号[]包围，由命令和0个或多个过滤器组成，过滤器间用竖线|分隔，支持链式处理。

命令

• random N：生成N位[0-9a-f]随机字符串（N为正整数）
• ip：获取客户端IP地址

过滤器

• hash：对字符串进行SHA256哈希，返回十六进制结果
• base64：对字符串进行Base64编码
• cut N：截取字符串前N个字符（N为正整数）
• encrypt KEY [NONCE_LENGTH]：使用ChaCha20加密，KEY为密钥，NONCE_LENGTH为随机nonce长度（默认：4字节，详见“加密与签名”）
• sign KEY [SIGNATURE_LENGTH]：使用HMAC-SHA256签名，KEY为密钥，SIGNATURE_LENGTH为签名长度（默认：4字节，详见“加密与签名”）

示例

• Flag模板：flag{[random 16|hash|cut 8]_[ip|base64]}
• 输出示例：flag{9598f995_MTI3LjAuMC4x}（假设客户端IP为127.0.0.1）

加密与签名

加密（ChaCha20）

使用ChaCha20算法加密数据，随机nonce前置到密文中，nonce长度可指定（默认4字节）。

步骤：

1. 生成长度为NONCE_LENGTH的随机“小nonce”（前置到输出）
2. 用SHA256从用户提供的“小密钥”派生32字节“真实密钥”
3. 用SHA256从“小nonce”派生12字节“真实nonce”
4. 使用“真实nonce”和“真实密钥”加密数据
5. 输出格式：小nonce + 密文

签名（HMAC-SHA256）

使用HMAC-SHA256生成签名，签名长度可指定（默认4字节）。

步骤：

1. 用密钥和数据通过HMAC-SHA256生成完整签名
2. 截取前SIGNATURE_LENGTH字节作为输出签名

其他特性：Proof of Work（PoW）

PoW用于防止DoS***，基于Hashcash实现，每个连接生成随机“资源”，客户端需计算满足难度的Hashcash值。

PoW提示示例

Do Hashcash for 20 bits with resource "WXm98Mz89uQb"
https://pow.cybersecnatlab.it/?data=WXm98Mz89uQb&bits=20
or
hashcash -mCb20 "WXm98Mz89uQb"
Result: 

（客户端需输入计算出的Hashcash结果才能建立连接）