remnux/radare2

Radare2 Docker镜像技术文档

一、镜像概述

1.1 镜像简介

本镜像封装了Radare2***框架，基于官方https://github.com/radareorg/radare2/blob/master/Dockerfile构建，提供了预配置的Radare2运行环境，可直接用于***分析工作，无需手动部署依赖。

1.2 主要用途

提供隔离、便捷的Radare2运行环境，支持对二进制文件的分析、调试、反汇编及漏洞研究等操作，适用于开发、安全研究及教学场景。

二、核心功能与特性

2.1 核心功能

• 多格式与架构支持：兼容多种可执行文件格式（如ELF、PE、Mach-O等）及处理器架构（x86、ARM、MIPS等）。
• 全功能*工具链**：集成Radare2框架的全套工具（如r2、rabin2、r2ghidra等），支持反汇编、调试、二进制分析、签名识别等操作。

2.2 镜像特性

• 环境隔离：通过Docker容器隔离Radare2运行环境，避免与主机系统依赖冲突。
• 快速部署：无需手动编译安装Radare2及其依赖，拉取镜像后即可使用。
• 官方兼容性：基于官方Dockerfile构建，确保与Radare2最新版本功能同步。

三、适用场景与范围

3.1 适用场景

• 二进制文件分析：对可执行文件、库文件进行静态/动态分析，提取函数、字符串、导入导出表等信息。
• 漏洞研究：调试二进制程序，定位漏洞位置，分析利用链。
• ***分析：***样本，提取行为特征、解密 payload 等。
• 教学：作为教学环境，演示工具使用方法及原理。

3.2 适用人群

• ***师、安全研究员
• ***分析师
• 计算机安全专业师生
• 需要快速使用Radare2进行二进制分析的开发人员

四、使用方法

4.1 前提条件

• 已安装Docker Engine（参考https://docs.docker.com/engine/install/）。
• 本地创建工作目录（用于与容器共享文件），例如~/workdir。

4.2 基本运行命令

通过以下命令启动容器，将本地工作目录挂载到容器内，并启用Radare2所需的调试权限：

bash
docker run --rm -it \
  --cap-drop=ALL --cap-add=SYS_PTRACE \
  -v ~/workdir:/home/nonroot/workdir \
  docker.xuanyuan.run/remnux/radare2

4.3 参数说明

4.4 容器内使用

容器启动后，将自动进入/home/nonroot/workdir目录（即挂载的本地工作目录）。直接运行r2命令即可启动Radare2：

bash
# 示例：分析工作目录中的二进制文件
r2 /home/nonroot/workdir/target_binary

4.5 docker-compose示例

创建docker-compose.yml文件，简化容器启动流程：

yaml
version: '3'
services:
  radare2:
    image: docker.xuanyuan.run/remnux/radare2
    container_name: radare2-analysis
    stdin_open: true  # 对应 -i
    tty: true         # 对应 -t
    cap_drop:
      - ALL
    cap_add:
      - SYS_PTRACE
    volumes:
      - ~/workdir:/home/nonroot/workdir

启动容器：

bash
docker-compose up -d
docker exec -it radare2-analysis bash  # 进入运行中的容器

五、配置说明

5.1 数据持久化

容器内的/home/nonroot/workdir目录为非持久化路径，需通过-v参数挂载主机目录，确保分析文件及结果在容器重启后不丢失。

5.2 权限说明

• 容器默认以非root用户（nonroot）运行，/home/nonroot/workdir目录权限与主机挂载目录一致，需确保主机目录有读写权限。
• SYS_PTRACE权限为调试功能必需，若无需调试可移除该参数（但可能导致部分Radare2功能受限）。

5.3 环境变量

当前镜像未定义额外环境变量，默认使用Radare2的默认配置。如需自定义配置（如插件路径、主题等），可通过挂载配置文件（如~/.radare2rc）到容器内/home/nonroot/.radare2rc实现。

六、注意事项

1. 工作目录创建：启动容器前需确保本地工作目录（如~/workdir）已创建，否则挂载时Docker会自动创建目录，但可能导致权限问题。
2. 调试权限：--cap-add=SYS_PTRACE在部分系统（如启用了seccomp的Linux发行版）可能需要额外配置，若调试功能异常，可尝试添加--security-opt seccomp=unconfined参数。
3. 镜像更新：建议定期拉取最新镜像（docker pull docker.xuanyuan.run/remnux/radare2），以获取Radare2的最新功能及安全更新。

七、参考链接

• Radare2官方网站
• https://github.com/radareorg/radare2
• https://github.com/radareorg/radare2/blob/master/Dockerfile