搭建 AI Agent 驱动的二进制分析与 Fuzz Docker 镜像

1
FROM ubuntu:22.04
2

3
ENV DEBIAN_FRONTEND=noninteractive
4
ENV LANG=C.UTF-8
5
ENV LC_ALL=C.UTF-8
6

7
# ------------------------------------------------------------------------------
8
# 1. 替换清华镜像源并安装基础编译、Java 与系统工具链
9
# ------------------------------------------------------------------------------
10
RUN sed -i 's/archive.ubuntu.com/mirrors.tuna.tsinghua.edu.cn/g' /etc/apt/sources.list && \
11
    sed -i 's/security.ubuntu.com/mirrors.tuna.tsinghua.edu.cn/g' /etc/apt/sources.list
12

13
RUN apt-get update && apt-get install -y \
14
    build-essential gcc g++ clang lld llvm \
15
    afl++ \
16
    gdb \
17
    file binutils strace ltrace tmux ripgrep jq curl wget git unzip \
18
    python3 python3-pip python3-dev \
19
    nodejs npm \
20
    openjdk-17-jdk openjdk-17-jre \
21
    cmake pkg-config libssl-dev libffi-dev libgmp-dev sudo \
22
    && rm -rf /var/lib/apt/lists/*
23

24
# 配置 pip 与 npm 国内镜像（仅加快 PyPI/NPM 包下载）
25
RUN pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple && \
26
    npm config set registry https://registry.npmmirror.com
27

28
# ------------------------------------------------------------------------------
29
# 2. 安装 Python 工具库与 Claude-Code Agent
30
# ------------------------------------------------------------------------------
31
RUN pip3 install --progress-bar on \
32
    pwntools==4.14.0 \
33
    ROPgadget \
34
    ropper
35

36
RUN npm install -g --loglevel info @anthropic-ai/claude-code@2.1.98
37

38
# ------------------------------------------------------------------------------
39
# 3. 从本地压缩包安装 Ghidra Headless
40
# ------------------------------------------------------------------------------
41
COPY ghidra.zip /tmp/ghidra.zip
42
RUN unzip -q /tmp/ghidra.zip -d /opt && \
43
    mv /opt/ghidra_11.1.2_PUBLIC /opt/ghidra && \
44
    rm /tmp/ghidra.zip
45

46
ENV GHIDRA_INSTALL_DIR=/opt/ghidra
47
ENV PATH="${GHIDRA_INSTALL_DIR}/support:${PATH}"
48

49
# ------------------------------------------------------------------------------
50
# 4. 从本地 zip 包安装 Pwndbg（无任何 Git 代理，直连 GitHub）
51
# ------------------------------------------------------------------------------
52
COPY pwndbg.zip /tmp/pwndbg.zip
53
RUN mkdir -p /opt/pwndbg && \
54
    unzip -q /tmp/pwndbg.zip -d /opt/pwndbg && \
55
    rm /tmp/pwndbg.zip && \
56
    if [ -d "/opt/pwndbg/pwndbg" ]; then mv /opt/pwndbg/pwndbg/* /opt/pwndbg/ 2>/dev/null || true; fi && \
57
    if [ -d "/opt/pwndbg/pwndbg-dev" ]; then mv /opt/pwndbg/pwndbg-dev/* /opt/pwndbg/ 2>/dev/null || true; fi && \
58
    cd /opt/pwndbg && \
59
    ./setup.sh
60

61
# ------------------------------------------------------------------------------
62
# 5. 创建无密码 analyst 用户并解压离线知识库
63
# ------------------------------------------------------------------------------
64
RUN useradd -m -s /bin/bash analyst && \
65
    echo "analyst ALL=(ALL) NOPASSWD:ALL" > /etc/sudoers.d/analyst && \
66
    chmod 0440 /etc/sudoers.d/analyst
67

68
USER analyst
69
WORKDIR /home/analyst
70

71
COPY --chown=analyst:analyst hacktricks.zip /tmp/hacktricks.zip
72
COPY --chown=analyst:analyst how2heap.zip /tmp/how2heap.zip
73

74
RUN mkdir -p /home/analyst/knowledges && \
75
    unzip -q /tmp/hacktricks.zip -d /home/analyst/knowledges/ && \
76
    if [ -d "/home/analyst/knowledges/hacktricks-master" ]; then mv /home/analyst/knowledges/hacktricks-master /home/analyst/knowledges/hacktricks; fi && \
77
    unzip -q /tmp/how2heap.zip -d /home/analyst/knowledges/ && \
78
    if [ -d "/home/analyst/knowledges/how2heap-master" ]; then mv /home/analyst/knowledges/how2heap-master /home/analyst/knowledges/how2heap; fi && \
79
    rm /tmp/*.zip
80

81
WORKDIR /workspace
82

83
CMD ["/bin/bash"]

1
# 环境介绍
2
* 你在 Ubuntu 24.04 二进制安全分析容器中，当前用户 analyst（非 root），需要 root 权限时用 sudo（已免密）
3
* 当前目录 /home/analyst/workspace 是工作空间：exploit 脚本、扫描输出、日志都放这里，宿主机会直接读取该目录
4

5
# 工具清单
6
* 静态分析：r2（radare2，已装 r2ghidra 插件）
7
    * r2 -q -A -c "pdf @ main" ./bin          # 快速反汇编
8
    * r2 -q -A -c "pdg @ sym.main" ./bin      # Ghidra 质量反编译（超 50 行写入文件）
9
    * r2 -q -A -c "ii; iz" ./bin              # 导入表 / 字符串
10
* 动态调试：gdb + pwndbg（非交互用 batch 模式：gdb -batch -ex 'b main' -ex run -ex 'info registers' -ex quit ./bin）
11
* fuzz：AFL++（afl-clang-fast 插桩编译目标）、clang -fsanitize=fuzzer,address（libFuzzer）
12
* exploit：pwntools（含 checksec）、ROPgadget、ropper
13
* 编译：gcc / clang（ASan：-fsanitize=address）
14

15
# 本地知识库（先 grep 再动手，不要联网）
16
* /home/analyst/knowledges/hacktricks      # 综合利用技术，二进制在 binary-exploitation 目录
17
* /home/analyst/knowledges/how2heap        # 堆利用技术代码全集，代码即文档
18
* /home/analyst/knowledges/CTF-pwn-tips    # pwn 常用技巧速查
19

20
# 练手靶标
21
* /home/analyst/targets/vuln_demo      # 栈溢出 demo（无保护，源码同目录 vuln_demo.c）
22
* /home/analyst/targets/fuzz_target    # AFL++ 插桩的崩溃 demo（源码 fuzz_target.c）
23

24
# 长时任务约定（重要）
25
* fuzzing 是小时级任务，禁止前台等待。必须放 tmux 后台：
26
    tmux new-session -d -s fuzz-1 'AFL_SKIP_CPUFREQ=1 afl-fuzz -i seeds -o out -- ./target'
27
* 启动后立即返回结论："fuzzer 在 tmux 会话 fuzz-1，进度文件 out/default/fuzzer_stats"
28
* 后续只读取 fuzzer_stats 和 out/default/crashes/ 判断进度与产出，不要 attach 干等
29

30
# 输出落盘
31
* 反编译结果、长输出写入文件再引用，不要整段贴进结论
32
* 结论只讲确认的事实与证据位置（文件路径、寄存器、崩溃地址）
33

34
# AFL++ 常用环境变量（容器内直接带，不要问为什么）
35
AFL_SKIP_CPUFREQ=1 AFL_I_DONT_CARE_ABOUT_MISSING_CRASHES=1

1
#!/usr/bin/env bash
2
# 一键构建 + 自检
3
# 用法: bash build.sh
4
set -euo pipefail
5
cd "$(dirname "$0")"
6

7
IMAGE="${IMAGE:-fuzz-lab}"
8

9
echo ">>> 构建镜像 $IMAGE（首次约 10~15 分钟，国内源）"
10
docker build -t "$IMAGE" .
11

12
echo
13
echo ">>> 构建完成，运行自检"
14
docker run --rm "$IMAGE" verify.sh
15

16
echo
17
echo ">>> 全部通过。下一步: 复制 .env.example 为 .env 填入 API 配置，然后 bash run_agent.sh"