radare2

<a href="https://radare.org/"><img border=0 src="https://assets.kitploit.com/production/public/readmes/3006/3a698148c5a0a1bc714cb3ac4439316f08cf2349b8cd75366bc1b9d2bf7f9c22.png" alt="screenshot" align="left" width="128px"></a>

## Radare2：面向 Unix 极客的自由逆向框架

[![Tests Status](https://github.com/radareorg/radare2/actions/workflows/ci.yml/badge.svg?branch=master)](https://github.com/radareorg/radare2/actions/workflows/ci.yml?query=branch%3Amaster) [![build](https://github.com/radareorg/radare2/actions/workflows/build.yml/badge.svg?branch=master)](https://github.com/radareorg/radare2/actions/workflows/build.yml?query=branch%3Amaster) [![tcc](https://github.com/radareorg/radare2/actions/workflows/tcc.yml/badge.svg?branch=master)](https://github.com/radareorg/radare2/actions/workflows/tcc.yml)
[![CII Best Practices](https://bestpractices.coreinfrastructure.org/projects/741/badge)](https://bestpractices.coreinfrastructure.org/projects/741) [![Build Status](https://scan.coverity.com/projects/416/badge.svg)](https://scan.coverity.com/projects/416) [![Discord](https://badgen.net/discord/members/YBey7CR9jf)](https://discord.gg/YBey7CR9jf)

当前 git `master` 分支为 `6.2.5`，下一个版本将是 `6.2.6`。

### 描述

r2 是 radare 的完全重写版本。它提供了一套库、工具和插件，以简化逆向工程任务。在 LGPLv3 下分发，尽管每个插件可以有不同的许可证（详情请参见 `r2 -Lj`）

**radare** 项目最初是一个专注于取证工作的简单命令行十六进制编辑器。如今，r2 是一个功能齐全的底层命令行工具，支持使用嵌入式 Javascript 解释器或通过 r2pipe 进行脚本编写。

r2 可以编辑本地硬盘上的文件、查看内核内存，并在本地或通过远程 gdb/windbg 服务器调试程序。r2 广泛的架构支持允许您分析、模拟、调试、修改和反汇编任何二进制文件。

<p align="center">
<a href="https://www.radare.org/"><img src="https://assets.kitploit.com/production/public/readmes/3006/c19b136adc5b00ffa9e295f2624beea0f7fb78e36cfa8081c31116b9a5723a85.png" alt="screenshot" align="center" border=0 width="600px"></a>
</p>

## 安装

下载最新的[发布版](https://github.com/radareorg/radare2/releases)二进制文件。

安装 radare2 的推荐方式是从 Git 仓库源码安装：

```sh
git clone https://github.com/radareorg/radare2
radare2/sys/install.sh
```

* 运行 `sys/install.sh` 进行默认的 acr+make+symlink 安装
* 支持 meson/ninja（muon/samu 也可用）和 make 构建。

### Nix

radare2 在 [`dist/nix`](https://github.com/radareorg/radare2/blob/master/dist/nix/README.md) 下提供了 Nix 打包。

### 源码构建

* r2 可以通过 `git` 安装，或使用 `r2env` 通过 `pip` 安装。
* Windows 构建需要 meson 和 msvc 或 mingw 作为编译器
* 要卸载当前构建的 r2，请运行 `make uninstall`
* 要卸载系统中所有 r2 安装，请执行：`sudo make purge`

在 Windows 上使用 .bat 脚本和 msvc：

```bat
preconfigure.bat       REM setup python, meson, ninja
configure.bat          REM run meson b + vs project
make.bat               REM run ninja -C b
prefix\bin\radare2.exe
```

## 热门插件：

使用 `r2pm` 工具，你可以浏览并安装许多使用 radare2 的插件和工具。

* [iaito](https://github.com/radareorg/iaito)：官方 Qt 图形界面
* [keystone](https://github.com/radareorg/radare2-extras/tree/master/keystone) 使用 Keystone 库的汇编指令
* [decai](https://github.com/radareorg/r2ai) 基于 AI 的反编译器
* [r2ai](https://github.com/radareorg/r2ai) 在 r2 内部使用 Llama 在本地主机上运行语言模型！
* [r2dec](https://github.com/wargio/r2dec-js)：基于 r2 用 JS 编写的反编译器，通过 `pdd` 命令访问
* [r2diaphora](https://github.com/FernandoDoming/r2diaphora)：基于 radare2 的 [Diaphora](https://github.com/joxeankoret/diaphora) 二进制差异比对引擎
* [r2flutter](https://github.com/trufae/r2flutter)：针对 Android 和 iOS 应用的 Dart/Flutter AOT 快照分析
* [r2frida](https://github.com/nowsecure/r2frida)：frida io 插件。使用 `r2 frida://0` 启动 r2 即可使用
* [r2ghidra](https://github.com/radareorg/r2ghidra)：可通过 `pdg` 访问的独立原生 ghidra 反编译器
* [r4ghidra](https://github.com/radareorg/r4ghidra)：在你的 Ghidra 中感受 radare 的乐趣
* [r2papi](https://github.com/radareorg/radare2-r2papi) 基于 r2pipe 的高级 API
* [r2pipe](https://github.com/radareorg/radare2-r2pipe) 使用任意编程语言为 radare2 编写脚本
* [r2poke](https://github.com/radareorg/radare2-extras/tree/master/r2poke) 与 GNU/Poke 集成，提供扩展的二进制解析能力
* [goresym](https://github.com/hanemile/radare2-GoReSym)：将 GoReSym 符号导入为标志
* [r2yara](https://github.com/radareorg/r2yara) 从 r2 运行 Yara，或从 Yara 使用 r2 原语
* [radius2](https://github.com/radareorg/radius2)：基于 boolector 和 esil 的快速符号执行引擎
* [r2sarif](https://github.com/radareorg/r2sarif) 导入/扩展/导出 SARIF 文档
* [r2hermes](https://github.com/radareorg/r2hermes) 用于 React Native Hermes 字节码的反汇编器和分析器
* [r2renef](https://github.com/Ahmeth4n/r2renef) 用于 Radare2 的 Renef IO 插件 - 动态 Android 插桩
* [r2unity](https://github.com/radareorg/r2unity)：从 radare2 检查 Unity IL2CPP 元数据和原生二进制文件
* [warrp](https://github.com/radareorg/warrp) 用于 binary ninja 的 WARP 格式的原生 radare2 插件

## 用法

以下是使用 r2 的第一步，阅读本书或查找教程以了解更多细节

```sh
$ r2 /bin/ls   # open file in read-only
> aaa          # analyse the program (r2 -A)
> afl          # list all functions (try aflt, aflm)
> px 32        # print 32 byte hexdump current block
> s sym.main   # seek to main (using flag name)
> f~foo        # filter flags matching 'foo' (internal |grep)
> iS;is        # list sections and symbols (rabin2 -Ss)
> pdf; agf     # disassembly and ascii-art function graph
> oo+;w hello  # reopen in read-write and write a string
> ?*~...       # interactive filter in all command help
> q            # quit
```

许多插件已默认包含在 r2 中。但你也可以通过使用 [r2pm](https://github.com/radareorg/radare2-pm) 包管理器来扩展其功能。

```sh
r2pm -s <word>  # search packages matching a word
r2pm -Uci <pkg> # update database and clean install a package
r2pm -u <pkg>   # uninstall the given package
r2pm -l <pkg>   # list installed packages
```

## 资源

* [官方书籍](https://book.rada.re)：了解 r2 的使用方法
* [COMMUNITY.md](https://github.com/radareorg/radare2/blob/master/COMMUNITY.md)：社区参与和宽松指南
* [CONTRIBUTING.md](https://github.com/radareorg/radare2/blob/master/CONTRIBUTING.md)：关于报告问题和贡献的信息。另请参阅[贡献](#contributing)
* [DEVELOPERS.md](https://github.com/radareorg/radare2/blob/master/DEVELOPERS.md)：r2 的开发指南
* [SECURITY.md](https://github.com/radareorg/radare2/blob/master/SECURITY.md)：报告漏洞的说明
* [USAGE.md](https://github.com/radareorg/radare2/blob/master/USAGE.md)：一些示例命令
* [INSTALL.md](https://github.com/radareorg/radare2/blob/master/INSTALL.md)：使用 make 或 meson 的安装说明

## 文档

通过观看来自 [r2con](https://rada.re/con) 的 [youtube 演讲](https://www.youtube.com/c/r2con) 来了解更多关于 r2 的信息。还有许多博客文章、幻灯片和[官方 radare2 书籍](https://book.rada.re)，但加入任何官方聊天并在那里提出您的问题或反馈始终是个好主意。

## 社区

* 网站：[https://www.radare.org/](https://www.radare.org/)
* Discord：[服务器](https://discord.gg/YBey7CR9jf)
* Mastodon：[@radareorg](https://infosec.exchange/@radareorg)
* Telegram：[主](https://t.me/radare)和[副](https://t.me/radare_side)频道
* [irc.libera.chat](https://libera.chat)：`#radare`、`#radare_side`
* [Matrix](https://matrix.to/#/#radare:matrix.org)：`#radare:matrix.org`

# 支持的平台

## 操作系统

Windows（自 XP 起支持 x86/x64/arm64）、Linux、Darwin、GNU/Hurd、Apple 的 {Mac,i,iPad,watch}OS、
Android、Wasmer、[Dragonfly, Net, Free, Open] BSD、Z/OS、QNX、SerenityOS、Solaris、AIX、
Haiku、Vinix、FirefoxOS。

## 架构

i386、x86-64、Alpha、ARM、AVR、BPF、sBPF、MIPS、PowerPC、SPARC、RISC-V、SH、m68k、
S390、XCore、CR16、HPPA、ARC、Blackfin、Z80、H8/300、V810、PDP11、m680x、V850、
CRIS、XAP (CSR)、PIC、LM32、8051、6502、i4004、i8080、Propeller、EVM、OR1K
Tricore、CHIP-8、LH5801、T8200、GameBoy、SNES、SPC700、MSP430、Xtensa、xcore、
NIOS II、Java、Dalvik、Pickle、WebAssembly、MSIL、EBC、TMS320 (c54x、c55x、
c55+、c64x)、Hexagon、Brainfuck、Malbolge、whitespace、DCPU16、LANAI、lm32、
MSIL、InfernoDis、UXN、Cosmac、PythonBytecode、Sharp sm5xx MCPus、FreeScale QIQa、
MCORE、mcs96、RSP、SuperH-4、VAX、KVX、Am29000、LOONGARCH、JDH8、s390x、STM8。

## 文件格式

ELF、Mach-O、Fatmach-O、PE、PE+、MZ、COFF、XCOFF、OMF、TE、XBE、SEP64、BIOS/UEFI、BFLT、Pebble 应用、
Apple Dyldcache、Kernelcache、MCLF trustlets、DEX、ART、Java class、Android boot image、Plan9 可执行文件、Amiga HUNK、
ZIMG、MBN/SBL bootloader、ELF coredump、MDMP（Windows minidump）、PDP11、XTAC、CGC、DotNet、
WASM（WebAssembly 二进制）、Commodore VICE 模拟器、DOL、QNX、WAD、OFF、TIC-80、
GB/GBA、PSX、PRG (C64)、Apple Classic PEF、NDS、z64 和 N3DS
...

## 文件系统

在用户空间挂载多种文件系统，如 NTFS、FAT、HFS+、EXT、APFS、BeosFS、BFS、MINIX、ReiserFS、SFS、ubifs、ufs、jfs、ISO9660、UDF、xfs

## 打包状态

* [![Snap 软件包](https://snapcraft.io/radare2/badge.svg)](https://snapcraft.io/radare2)
* [![Termux 软件包](https://repology.org/badge/version-for-repo/termux/radare2.svg)](https://repology.org/project/radare2/versions)
* [![Alpine Linux 3.23 软件包](https://repology.org/badge/version-for-repo/alpine_3_23/radare2.svg)](https://repology.org/project/radare2/versions)  [![Alpine Linux 3.22 软件包](https://repology.org/badge/version-for-repo/alpine_3_22/radare2.svg)](https://repology.org/project/radare2/versions) 
* [![Arch 软件包](https://repology.org/badge/version-for-repo/arch/radare2.svg)](https://repology.org/project/radare2/versions)
* [![Fedora 42](https://repology.org/badge/version-for-repo/fedora_42/radare2.svg)](https://repology.org/project/radare2/versions) [![Fedora 41](https://repology.org/badge/version-for-repo/fedora_41/radare2.svg)](https://repology.org/project/radare2/versions)
* [![Homebrew 软件包](https://repology.org/badge/version-for-repo/homebrew/radare2.svg)](https://repology.org/project/radare2/versions) [![MacPorts 软件包](https://repology.org/badge/version-for-repo/macports/radare2.svg)](https://repology.org/project/radare2/versions)
* [![Haiku Ports](https://repology.org/badge/version-for-repo/haikuports_master/radare2.svg)](https://repology.org/project/radare2/versions) [![Void Linux](https://repology.org/badge/version-for-repo/void_x86_64/radare2.svg)](https://repology.org/project/radare2/versions)