radare/radare2

radare2 Docker镜像文档

镜像概述与主要用途

radare2（简称r2）是一个完整的***工程与二进制分析框架，由一系列可独立或协同使用的命令行工具组成。该框架围绕反汇编器构建，支持从机器可执行代码生成汇编语言源码，兼容多种处理器和操作系统的可执行格式，同时提供静态分析、调试及模拟功能。其模块化架构允许通过插件扩展对新文件格式、架构及分析特性的支持。

radare2 Docker镜像提供了预配置的运行环境，封装了radare2核心及多个关键插件，便于快速部署和使用，无需手动配置依赖。镜像分为稳定版（基于Ubuntu）和GIT开发版（本地构建，基于Debian），满足不同场景需求。

核心功能与特性

包含的关键项目组件

• radare2：框架核心，提供基础***分析能力
• r2ghidra：集成Ghidra反编译器，提升高级语言伪代码生成能力
• r2frida：集成Frida动态 instrumentation工具（仅支持部分平台）
• r2dec：JavaScript实现的反编译器
• r2yara：集成YARA规则引擎，支持***代码特征匹配
• r2ai：AI辅助分析插件
• r2pipe：Python绑定，支持通过脚本自动化分析流程
• r2book：radare2官方文档（作为info页面集成）

其他特性

• 多平台支持：兼容Docker、Podman、nerdctl等容器运行时
• 安全验证：支持通过cosign验证镜像完整性（由GitHub Actions构建）
• 灵活部署：支持交互式终端、一次性使用、调试模式及Web服务模式

使用场景与适用范围

适用用户

• ***工程师
• 安全研究员
• 二进制漏洞分析人员
• 软件开发人员（二进制调试与验证）

适用场景

• 稳定版：生产环境、日常***分析、教学演示
• GIT开发版：需要最新功能、自定义插件测试、框架开发

使用方法与配置说明

稳定版镜像使用

基本运行

通过以下命令启动交互式终端：

sh
# Docker
docker run -ti radare/radare2

# Podman
podman run -ti docker.io/radare/radare2

# Nerdctl
nerdctl run -ti radare/radare2

一次性使用（自动清理容器）

添加--rm参数，容器退出后自动删除：

sh
docker run --rm -ti radare/radare2

调试模式配置

如需在容器内调试二进制文件，需添加特权及安全选项：

sh
docker run --tty --interactive \
  --privileged \
  --cap-add=SYS_PTRACE \
  --security-opt seccomp=unconfined \
  --security-opt apparmor=unconfined \
  radare/radare2

访问r2book文档

容器内通过info命令查看官方文档：

sh
info r2book

镜像完整性验证

验证镜像是否由GitHub Actions构建：

sh
cosign verify docker.io/radare/radare2 \
  --experimental-oci11=true \
  --certificate-oidc-issuer=https://token.actions.githubusercontent.com \
  --certificate-identity-regexp='https://github\.com/radareorg/radare2-snap/.*@refs/heads/main'

GIT开发版（r2docker）

GIT版基于Debian，包含radare2最新开发代码，需本地构建。

本地构建步骤

sh
# 克隆源码仓库
git clone https://github.com/radareorg/radare2.git
cd radare2

# 构建镜像（默认包含r2ghidra、r2frida、r2dec）
make -C dist/docker

自定义构建参数

• 添加额外组件：通过R2PM变量指定需安装的r2pm包

  sh
  make -C dist/docker R2PM=radius2  # 示例：添加radius2组件
  

• 指定架构：通过ARCH变量选择目标架构（amd64/arm64）

  sh
  make -C dist/docker ARCH=arm64
  

r2web服务器部署

通过容器启动radare2 Web UI（r2web）：

基础部署

sh
docker run -p 9090:9090 radare/radare2 r2 -c '=h' -

Docker Compose配置

基础版（docker-compose.yml）：

yaml
version: "3.8"
services:
  radare2:
    image: radare/radare2
    command: r2 -c '=h' -
    network_mode: bridge
    ports:
      - "9090:9090"

调试增强版（支持容器内调试）：

yaml
version: "3.8"
services:
  radare2:
    image: radare/radare2
    command: r2 -c '=h' -
    network_mode: bridge
    ports:
      - "9090:9090"
    privileged: true
    cap_add:
      - SYS_PTRACE
    security_opt:
      - "seccomp=unconfined"
      - "apparmor=unconfined"

参考链接

• 官方网站：<[***]>
• GitHub仓库：https://github.com/radareorg/radare2
• 镜像构建源码（稳定版）：https://github.com/radareorg/radare2-snap