reverse-skills-max: initial public release (restored, redacted, hardened)

vendor-new/rev-skills/.claude/skills/re-sandbox/references/commands.md

@@ -0,0 +1,105 @@
+# 沙箱环境搭建命令速查与操作序列
+
+工具族按隔离级别组织：firejail（用户态轻量）、docker（容器）、VirtualBox/VMware（虚拟机+快照）、INetSim（网络模拟）。命令与参数以官方文档为准（firejail man、docker 文档、VBoxManage 手册、INetSim 手册）。
+
+## 命令族速查
+
+### firejail（用户态轻量隔离）
+
+- `firejail <程序>` 默认沙箱运行；`firejail --private <程序>` 临时 home/root（退出即弃）
+- `firejail --net=none <程序>` 断网（仅回环）；`firejail --dns=127.0.0.1 <程序>` DNS 指向本机
+- `firejail --private-etc=hosts,resolv.conf <程序>` 只带指定 /etc 文件进沙箱
+- `firejail --list` 列出活动沙箱（`PID:USER:Name:Command`）；`firejail --tree` 树形
+- `firejail --shutdown=<name|pid>` 关停指定沙箱——注意没有 `--clean` 选项（0.9.80 实测报 invalid option）
+- `firejail --version` 验证；`--help` 全参数清单
+
+### docker（容器隔离）
+
+- `docker pull ubuntu:22.04` / `docker run --rm -it ubuntu:22.04 bash` 一次性容器
+- `docker run --rm -d --network none --name sand <镜像>` 断网后台容器（`--network none` 无网卡）
+- `docker cp <样本> sand:/tmp/` 传入；`docker cp sand:/out/ ./out/` 取出产物
+- `docker commit <container> sandbox-image:v1` 把运行中容器提交为镜像（快照替代）
+- `docker rm -f <container>` 销毁容器；`docker images` / `docker ps -a` 查看
+- 验证: `docker --version`；`docker run --rm hello-world` 跑通
+
+### VirtualBox（VM + 快照）
+
+- `VBoxManage list vms` 列虚拟机；`VBoxManage startvm <vm> --type headless` 无头启动
+- `VBoxManage snapshot <vm> take clean` 建快照；`VBoxManage snapshot <vm> restore clean` 恢复
+- `VBoxManage snapshot <vm> list` 快照清单；`VBoxManage modifyvm <vm> --nic1 hostonly` 改 Host-only 网卡
+- `VBoxManage guestcontrol <vm> run --exe /bin/ls --username <u> --password <p>` 客户机执行（需 Guest Additions）
+- `VBoxManage sharedfolder add <vm> --name in --hostpath <路径> --readonly` 只读共享（传入通道）
+- 验证: `VBoxManage --version`
+
+### VMware Workstation（vmrun）
+
+- `vmrun start <vmx> nogui`；`vmrun snapshot <vx 路径> clean` 快照
+- `vmrun revertToSnapshot <vx> clean` 恢复；`vmrun list` 运行中 VM
+- 验证: `vmrun list`
+
+### INetSim（网络模拟）
+
+- `inetsim` 默认配置启动（HTTP/SMTP/DNS/FTP 等全模拟）；`inetsim --session <名>` 命名会话
+- `inetsim --version` 验证；日志在 `/var/log/inetsim/`（报告 `/var/log/inetsim/report/`）
+- 配置: `/etc/inetsim/inetsim.conf`（bind 地址、启停服务）
+
+### 网络隔离验证
+
+- `ping 8.8.8.8`（断网应不通）；`curl http://example.com`（应命中 INetSim 模拟响应）
+- `dig @127.0.0.1 example.com`（fake DNS 应答）；`ss -tlnp` 看沙箱内监听
+
+## 常用操作序列（组合套路）
+
+### 1. VM 快照分析闭环（建快照 → 隔离 → 传样本 → 跑 → 恢复）
+
+```
+VBoxManage snapshot <vm> take clean                 # 干净基线
+VBoxManage startvm <vm> --type headless
+# 网络隔离（Host-only + INetSim）→ 只读共享传入样本（sha256 先存证）
+# 沙箱内运行样本、观察行为、导出产物到专用输出目录
+VBoxManage snapshot <vm> restore clean              # 分析完恢复
+VBoxManage snapshot <vm> list                       # 确认回到 clean
+```
+
+### 2. firejail 快速隔离跑样本（轻量场景）
+
+```
+firejail --private --net=none --dns=127.0.0.1 ./sample
+# 断网 + 临时 home；退出后临时目录自动清理
+firejail --list                                     # 确认沙箱状态
+firejail --shutdown=<name|pid>                      # 需要时按名关停
+```
+
+### 3. Docker 容器分析闭环（低风险样本快速测试）
+
+```
+docker run --rm -d --network none --name sand ubuntu:22.04 sleep 3600
+docker cp ./sample sand:/tmp/
+docker exec sand /tmp/sample                        # 容器内运行（无网）
+docker cp sand:/tmp/out ./out/                      # 取出产物
+docker rm -f sand
+```
+
+### 4. INetSim fake 网络环境（C2 观察标准做法）
+
+```
+inetsim --session c2obs                              # 沙箱宿主起模拟服务
+# 沙箱 VM DNS 指向宿主 INetSim（Host-only 网段 IP）
+# 样本外连被模拟服务接管并记录全部请求 → 配合 [[re-netcap]] 抓包
+curl http://example.com                              # 验证命中模拟响应
+# 日志与报告在 /var/log/inetsim/ 取回存档
+```
+
+## 实现教训（内化）
+
+- 完整性从高到低：VM 快照 > 容器 > firejail——按样本威胁等级选层，决策与理由写入记录（SKILL.md 步骤 1）
+- 网络隔离三档先定好再跑：断网 / fake DNS / INetSim——验证命令（ping/curl 落点）先跑通再放样本
+- 传入传出走专用通道：只读共享进、专用输出目录出，样本与产物分离存证（sha256 双端）
+- 恢复快照是分析的一部分：步骤 1 就写下恢复命令，分析完立即执行并验证无残留（SKILL.md 坑 1）
+- INetSim 环境里 DNS 解析与 HTTP 服务都指向同一宿主，样本请求全落本地——抓包与日志对照还原 C2 行为
+
+## 使用注意
+
+- 本技能是 [[re-analyze/platform-tips]] 最高原则（默认沙箱）的执行者——动态分析一律先过这里
+- 高威胁样本用 VM 快照而非容器/firejail（内核共享面与隔离深度差异，SKILL.md 坑 3）
+- 时间/硬件/输入类环境指纹是另一层问题：隔离 ≠ 伪装，检测点应对见 [[re-evasion]]（SKILL.md 坑 6-8）

vendor-new/rev-skills/.claude/skills/re-sandbox/references/gotchas.md

@@ -0,0 +1,46 @@
+# 沙箱工具特有坑与边界
+
+## 网络隔离坑组
+
+- **NAT 不等于断网**：VM 默认 NAT 允许出站外联——断网必须显式 Host-only/Internal（或 `--net=none`），并验证 `ping 8.8.8.8` 不通（SKILL.md 坑 2）
+- **fake DNS 只劫持解析**：样本用 IP 直连或硬编码 IP 时 fake DNS 无效——配合防火墙/INetSim 绑住目标端口，或观察连接落点
+- **INetSim 只模拟常用服务**：样本连的端口不在 INetSim 服务表里会连接失败（TCP RST）——先看样本要连什么端口（静态 [[re-netcap]]/动态抓包），按需补模拟服务；DNS 指向错误时样本静默等待超时，先验证 `curl` 落点再放样本
+- **systemd-resolved 与 `--dns` 冲突**：firejail man 页注明 `--dns` 在 systemd-resolved 环境不受支持——该环境改用 `--net=none` 或 VM 内独立 DNS
+
+## 快照/回滚坑组
+
+- **快照只建不恢复 = 环境污染**：样本持久化残留（进程/文件/注册表）污染下次分析——恢复命令提前写好、分析完立即执行、恢复后验证无残留（SKILL.md 坑 1）
+- **快照建在样本运行后**：忘了先建基线，样本已经改过系统才想起——基线快照必须早于任何样本运行；中途才建的快照含污染状态，别当干净基线
+- **VBoxManage 与 VirtualBox 版本行为**：`snapshot take/restore` 语法长期稳定，但新版本对 headless/guestcontrol 有改动——自动化脚本先 `VBoxManage --version` 确认版本；VMware 侧 `vmrun` 命令兼容性以官方文档为准
+
+## 容器坑组
+
+- **容器共享内核 ≠ 完全隔离**：Docker 与宿主机共享内核，内核漏洞利用/全局 sysctl 影响宿主——高威胁样本用 VM 快照，容器只用于低风险快速测试（SKILL.md 坑 3）
+- **`--network none` 后 docker cp 仍可用**：断网只影响容器网络栈，`docker cp`/`docker exec` 走守护进程通道不受影响——隔离与文件交互不冲突
+- **镜像带样本残留**：容器删了但 commit 出的镜像还留着样本痕迹——分析完 `docker rmi` 清理镜像；复用基线镜像前重新拉取干净层
+
+## firejail 坑组
+
+- **`--clean` 不存在**：0.9.80 实测报 `invalid --clean command line option`，官方 man 页（0.9.72 起）无此选项——清理用 `firejail --list` + `firejail --shutdown=<name|pid>`（SKILL.md 坑「清理选项被讹传」）
+- **用户态隔离不是安全边界**：firejail 是 namespace/seccomp 组合——不防内核漏洞利用与提权（`--net=none` 下用户态逃逸面仍在），高威胁样本用 VM；`--net=none` 在部分平台可致应用崩溃（man 页注明），备选 `--protocol=unix`
+- **`--private` 只隔离 home/root 路径**：`--private-etc` 之外的 /etc 全局可见（读）——敏感配置先 `--private-etc=hosts,resolv.conf` 等白名单
+- **firejail 检测面**：样本可查沙箱特征（firejail 环境变量/挂载特征）——与 VM 逃逸检测同理，识别后按 [[re-evasion]] 应对
+
+## 环境指纹坑组（隔离 ≠ 伪装）
+
+- **隔离与伪装是两个问题**：隔离防样本外联/污染宿主；伪装防样本因环境指纹不触发——时间（RDTSC/GetTickCount）、硬件（核数/内存）、交互（鼠标/窗口）检测都要单独应对（SKILL.md 坑 6-8）
+- **命名与资源阈值**：`sample.exe`/`malware` 目录名、CPU/内存/磁盘阈值、交互缺失都会触发 T1497.001 类检测——命名规范化、资源充足、交互按人类分布模拟
+- **统计级交互校验**：新样本对鼠标轨迹做统计判别（采样频率/欧氏距离/前台窗口数）——固定像素移动会被识破，按真实行为分布模拟并拉长观测窗（SKILL.md 坑 8）
+
+## 版本差异
+
+- **firejail**：0.9.72（Debian bookworm）与 0.9.80（Arch 实测）选项集稳定，`--clean` 均不存在；`--net=none` 的崩溃警告自老版本就有——发行版打包版本差异大（0.9.6x-0.9.8x），脚本化前 `firejail --version` 确认
+- **VirtualBox**：snapshot 命令语法跨 6.x/7.x 稳定；Guest Additions 版本需与主版本匹配（不匹配剪贴板/共享目录失效，且是 VM 逃逸检测特征之一）
+- **docker**：`--network none`、`docker cp` 行为长期稳定；commit 出的镜像不可复现依赖（分层含中间状态）——基线用 Dockerfile 重建而不是 commit 产物
+- **INetSim**：Debian 包 `inetsim`（bookworm 1.3.2）；`--version`/`--session` 选项稳定；日志路径随发行版打包略有差异（以 `/etc/inetsim/inetsim.conf` 为准）
+
+## 使用注意
+
+- 动态分析一律先过本技能（[[re-analyze/platform-tips]] 最高原则）；样本/产物 sha256 双端存证（[[re-triage]]）
+- 分析结论与决策记录（隔离级别、网络方案、恢复验证）写 [[re-analyze/analysis-contract]]
+- 版本相关行为（firejail 选项、VM 工具、INetSim 服务表）以目标版本实际表现为准