Iceman分支 - Proxmark3

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

最新发布	Coverity	贡献者

OSX CI 构建	Ubuntu CI 构建	Windows CI 构建

目录

• Iceman Fork - Proxmark3
• 目录
• PROXMARK3 安装与概述
  • 备注 / 辅助文档
• 如何构建？
  • Proxmark3 RDV4
  • 通用 Proxmark3 平台
• 有何变化？
• 开发
  • 支持的操作系统
  • 预编译二进制文件
  • Proxmark3 图形界面
  • 官方渠道
  • 维护者
  • 引用
  • 版权与许可条款

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 的想法。

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

支持的操作系统

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

• Windows 10 上的 WSL1
• Windows 10/11 上的 WSL2
• Proxspace 环境 release v3.xx
• Windows/MinGW 环境
• Ubuntu、ParrotOS、Gentoo、Pentoo、Kali、NetHunter、Arch Linux、Fedora、Debian、Raspbian
• Android / Termux
• macOS / Homebrew（或 MacPorts，实验性）/ Apple Silicon M1
• iOS（越狱，rootful）
• Docker 容器
  • 基于 Iceman 仓库的 ubuntu 18.04 容器
  • 基于 Iceman 分支的容器 v1.7

预编译二进制文件

请参阅 Proxmark3 预编译构建

Proxmark3 图形界面

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

• Proxmark3 通用 GUI 大致可用。
• Proxmark3 GUI 交叉编译版 近期更新，声称支持此仓库的最新源代码。
• Proxmark3_GUI 用 vb.net 编写的简单 GUI

官方渠道

在哪里可以找到社区？

• RFID 黑客社区 Discord 服务器
• Proxmark3 IRC 频道
• Proxmark3 子版块
• Proxmark3 论坛

维护者

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

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 许可条款兼容的自由许可条款，请参阅各自的说明。