返回更新列表
新发布Sep 19, 2026

proxmark3 v4.23346

硬件工具,用于RFID分析、模拟和渗透测试。支持125kHz、13.56MHz协议(MIFARE、iClass、ISO14443/15693),具备密钥恢复、嗅探和脚本功能,适用于安全研究。

分享

Iceman分支 - Proxmark3

Proxmark3是RFID领域的瑞士军刀,能够与全球绝大多数RFID标签进行交互。该设备最初由Jonathan Westhues开发,现已成为RFID分析领域爱好者的首选工具。Iceman仓库被认为是功能和特性的巅峰,支持大量极其有用且便捷的命令和LUA脚本,用于自动完成芯片识别、渗透测试和编程。

最新发布Coverity贡献者
Latest releaseCoverity StatusGitHub contributors
OSX CI 构建Ubuntu CI 构建Windows CI 构建
MacOS Build and TestUbuntu Build and TestWindows Build and Test

目录

PROXMARK3 安装与概述

备注 / 辅助文档

如何构建?

Proxmark3 RDV4

请参阅上方表格中的安装说明链接,为您的 Proxmark3 RDV4 设备进行构建、刷写和运行。

通用 Proxmark3 平台

为了在此仓库中为通用 Proxmark3 平台进行构建,我们建议您阅读 高级编译参数

我们将以下设备定义为通用 Proxmark3 平台。

支持

  • RDV1、RDV2、RDV3 easy
  • Ryscorp 绿色 PCB 版本
  • Radiowar 黑色 PCB 版本
  • 众多 RDV3 easy 的中国改编版本(kkmoon、PiSwords 等)
  • Proxmark3 SE(特别版)(支持 BLE)
  • Proxmark3 X
    • 注意:社区测试过
    • 注意:未知设备硬件

不支持

  • ⚠ Proxmark Evolution(EVO)
    • 注意:未知引脚分配。
  • ⚠ Ryscorp Proxmark3 Pro
    • 注意:设备具有不同的 FPGA 且未知引脚分配。
    • 注意:公司已消失,用户无从得知。

实验性支持

  • ⚠ iCopy-X
    • 注意:由于 Proxmark 客户端命令使用不同语法,目前与 iCopy-X GUI 不兼容
    • 注意:参见 icopyx-community 仓库 获取上游源码、逆向硬件等
    • 注意:使用 DRM 锁定标签,忽略开源许可证。使用风险自负。
  • ⚠ Proxmark3 Ultimate
    • 注意:未知设备硬件
    • 注意:已为其构建 FPGA 镜像。使用风险自负。

未知支持状态

  • ⚠ VX
    • 注意:未知设备硬件

对于这些新型未知型号,我们依赖社区报告此仓库是否适用以及他们如何使其工作。

通用 Proxmark3 平台的 256KB 闪存大小

注意: 您需要关注 ARM 芯片内置闪存的大小。 如果是 512KB,则无问题;但如果是 256KB,则需要在编译此仓库时进一步减少功能。 运行 ./pm3-flash-all 时,如果已安装此仓库的引导程序,可以看到设备的大小。 否则,可在运行 Proxmark3 客户端 ./pm3 时的启动信息中找到大小报告。

注意!请阅读 256KB 闪存建议

有何变化?

Proxmark3 RDV4 硬件修改:

  • 增加 256KB 闪存
  • 增加智能卡模块
  • 增加用于外设(如蓝牙+电池扩展板)的 FPC 连接器
  • 改进天线
    • 可更换
    • LF Q 因子开关
    • LF 125/134 频率开关
  • 小巧的 PCB 外形
  • ABS 外壳

此仓库与原版 Proxmark3 仓库的区别:

请参阅我们尽力保持更新的 变更日志文件

简而言之,此仓库为您提供了与 Proxmark3 完全不同的用户体验。

  • 支持命令 Tab 补全
  • 更丰富的 CLI,使用颜色/表情符号
  • 各处实现帮助文本系统
  • 提示系统
  • 用户偏好设置
  • 在 Linux、OSX 和 Windows 上通过持续集成构建系统进行广泛测试,并定期使用静态分析工具,例如
    • Coverity Scan
    • Cppcheck(v2.6)
    • GCC 和 Clang 强制启用诊断标志
  • 自动检测串口,并与蓝牙扩展板无缝集成
  • 从客户端内部重新连接到设备
  • 支持扯落攻击
  • 支持 NFC NDEF type1、type2、type4a、type4b、mifare、条码
  • 支持 pm3 客户端脚本、Lua 脚本、Python 脚本
  • 提供最全面的脚本集合
  • Wiegand 编码/解码
  • 支持 EMV
  • 支持 CIPURSE
  • 提供大多数独立模式且易于编译
  • 为客户端和外部工具提供广泛的测试脚本
  • 最全面的编译已知密钥字典
  • 精简的 USB 通信,采用 NG 帧
  • 编译最全面的公开已知密钥恢复软件
  • 该软件的最快速实现
  • 支持多种转储文件格式(BIN/EML/JSON)
  • 这些文件格式与 libnfc、MFC tool app 等的互操作性
  • 支持比以往更多的 RFID 协议
  • 软件包维护者、发行版维护者易于安装
  • 支持 cmake、make
  • 在更多操作系统/平台上无错误或警告地构建
  • 以包形式在 Gentoo、Kali、Termux、Macports、Homebrew 等知名发行版中提供
  • 更多的文档

开发

注意:这是一个前沿仓库。维护者积极在此仓库中工作,并将定期重构代码,使其更易于理解、导航、构建、测试和贡献,因此请预期代码布局会经常发生重大变化

👉 记住! 如果您打算贡献代码,请先阅读编码风格说明。 我们通常会快速合并您的贡献,因为我们喜欢将功能引入 Proxmark3 并在之后修复 bug 的想法。

公开路线图 是如果您有兴趣贡献时的绝佳起点。

支持的操作系统

此仓库可在以下系统上顺利编译:

预编译二进制文件

请参阅 Proxmark3 预编译构建

Proxmark3 图形界面

Gaucho 的官方 PM3-GUI 将无法使用。更不用说它已经相当陈旧且不再维护。

官方渠道

在哪里可以找到社区?

维护者

致所有发行版、软件包维护者:我们尽力让您的工作更轻松。

make install 现已可用,如果您想了解更多信息。

以下文档将对您有帮助:

引用

使用以下 bibtex 引用此仓库:

@misc{proxmark3,
  author = {C. {Herrmann} and P. {Teuwen} and O. {Moiseenko} and M. {Walker} and others},
  title = {{Proxmark3 -- Iceman repo}},
  howpublished = {\url{https://github.com/RfidResearchGroup/proxmark3}},
  keywords = {rfid nfc iceman proxmark3 125khz 134khz 13.56mhz},
}

如需引用仓库的特定状态,请使用提交编号或访问日期,例如:

  note = {Accessed: commit 12327f71a27da23831901847886aaf20e8ad3ca0}
  note = {Accessed: 2021-01-01}

版权与许可条款

每个贡献都归其作者所有。参见 AUTHORS

Proxmark3 源代码遵循以下许可条款,通常称为 GPLv3 或更高版本

本程序是自由软件:您可以重新分发和/或修改它
遵循自由软件基金会发布的 GNU 通用公共许可证,
无论是许可证的第 3 版,还是(根据您的选择)任何更高版本。

分发此程序是希望它有用,
但没有任何保证;甚至没有对适销性或特定用途的隐含保证。
详情请参见 GNU 通用公共许可证。

GPLv3 副本可在 LICENSE 中找到。

某些依赖项可能遵循其他与 Proxmark3 许可条款兼容的自由许可条款,请参阅各自的说明。

分类