RfidResearchGroup/proxmark3
GitHub: RfidResearchGroup/proxmark3
Proxmark3 Iceman分支是RFID安全研究领域的顶级固件，为门禁卡分析、NFC渗透测试和智能卡研究提供全栈解决方案。
Stars: 5289 | Forks: 1276
# Iceman Fork - Proxmark3
Proxmark3 是 RFID 领域的瑞士军刀，能够与全球绝大多数 RFID 标签进行交互。该设备最初由 Jonathan Westhues 开发，现已成为爱好者进行 RFID 分析的首选工具。Iceman 仓库被认为是功能和实用性的巅峰，它提供了大量极其有用且便捷的命令和 LUA 脚本，用于自动化芯片识别、渗透测试和编程。
| 最新发布版 | Coverity | 贡献者 |
|:--------------:|:--------:|:------------:|
| [](https://github.com/RfidResearchGroup/proxmark3/releases/latest) | [](https://scan.coverity.com/projects/proxmark3-rrg-iceman-repo)|  |
| Actions OSX CI | Actions Ubuntu CI | Actions Windows CI |
|:--------------:|:------------------:|:------------------:|
| [](https://github.com/RfidResearchGroup/proxmark3/actions/workflows/macos.yml) | [](https://github.com/RfidResearchGroup/proxmark3/actions/workflows/ubuntu.yml) | [](https://github.com/RfidResearchGroup/proxmark3/actions/workflows/windows.yml) |
# 目录
- [Iceman Fork - Proxmark3](#iceman-fork---proxmark3)
- [目录](#table-of-contents)
- [PROXMARK3 安装与概述](#proxmark3-installation-and-overview)
- [备注 / 有用的文档](#notes--helpful-documents)
- [如何构建？](#how-to-build)
- [Proxmark3 RDV4](#proxmark3-rdv4)
- [通用 Proxmark3 平台](#generic-proxmark3-platforms)
- [有哪些变化？](#what-has-changed)
- [开发](#development)
- [支持的操作系统](#supported-operating-systems)
- [预编译二进制文件](#precompiled-binaries)
- [Proxmark3 GUI](#proxmark3-gui)
- [官方渠道](#official-channels)
- [维护者](#maintainers)
- [引用](#citation)
- [版权和许可条款](#copyright-and-licensing-terms)
# PROXMARK3 安装与概述
| 安装 | Proxmark3 的使用 |
| :------------------: | :------------------: |
| [Linux - 设置与构建](/doc/md/Installation_Instructions/Linux-Installation-Instructions.md) | [编译说明](/doc/md/Use_of_Proxmark/0_Compilation-Instructions.md)|
| [Linux - 关于 ModemManager 的重要说明](/doc/md/Installation_Instructions/ModemManager-Must-Be-Discarded.md) | [验证 Proxmark3 客户端功能](/doc/md/Use_of_Proxmark/1_Validation.md)|
| [macOS - Homebrew & 升级 HomeBrew Tap Formula](/doc/md/Installation_Instructions/macOS-Homebrew-Installation-Instructions.md) | [首次使用与验证](/doc/md/Use_of_Proxmark/2_Configuration-and-Verification.md)|
| [macOS - MacPorts](/doc/md/Installation_Instructions/macOS-MacPorts-Installation-Instructions.md) | [命令与功能](/doc/md/Use_of_Proxmark/3_Commands-and-Features.md)|
| [macOS - 设置与构建](/doc/md/Installation_Instructions/macOS-Compile-From-Source-Instructions.md) ||
| [Windows - 设置与构建](/doc/md/Installation_Instructions/Windows-Installation-Instructions.md) ||
| [Termux / Android - 设置与构建](/doc/termux_notes.md) ||
| [iOS - 设置与构建](/doc/md/Installation_Instructions/iOS-Installation-Instructions.md)
| [Blue Shark 手册](/doc/bt_manual_v10.md) | [命令速查表](/doc/cheatsheet.md)|
| [高级编译参数](/doc/md/Use_of_Proxmark/4_Advanced-compilation-parameters.md) | [更多速查表](https://github.com/RfidResearchGroup/proxmark3/wiki/More-cheat-sheets)|
| [故障排除](/doc/md/Installation_Instructions/Troubleshooting.md) | [完整客户端命令集](/doc/commands.md) |
| [JTAG](/doc/jtag_notes.md) | [T5577 介绍指南](/doc/T5577_Guide.md)|
## 备注 / 有用的文档
| 备注 |||
| ------------------- |:-------------------:| -------------------:|
|[关于 UART 的备注](/doc/uart_notes.md)|[关于 Termux / Android 的备注](/doc/termux_notes.md)|[关于路径的备注](/doc/path_notes.md)|
|[关于帧格式的备注](/doc/new_frame_format.md)|[关于 tracelog / wireshark 的备注](/doc/trace_notes.md)|[关于 EMV 的备注](/doc/emv_notes.md)|
|[关于外部闪存的备注](/doc/ext_flash_notes.md)|[关于 loclass 的备注](/doc/loclass_notes.md)|[关于 Coverity 扫描配置与运行的备注](/doc/md/Development/Coverity-Scan-Config-and-Run.md)|
|[关于 Proxmark3 使用的文件格式的备注](/doc/extensions_notes.md)|[关于 MFU 二进制格式的备注](/doc/mfu_binary_format_notes.md)|[关于 FPGA & ARM 的备注](/doc/fpga_arm_notes.md)|
|[开发独立模式](/armsrc/Standalone/readme.md)|[关于独立模式的 Wiki](https://github.com/RfidResearchGroup/proxmark3/wiki/Standalone-mode)|[关于 Magic UID 卡的备注](/doc/magic_cards_notes.md)|
|[关于颜色使用的备注](/doc/colors_notes.md)|[Makefile vs CMake](/doc/md/Development/Makefile-vs-CMake.md)|[关于复制器的备注](/doc/cloner_notes.md)|
|[关于 cliparser 使用的备注](/doc/cliparser.md)|[关于时钟的备注](/doc/clocks.md)|[关于 MIFARE DESFire 的备注](/doc/desfire.md)|
|[关于 CIPURSE 的备注](/doc/cipurse.md)|[关于 NDEF type4a 的备注](/doc/ndef_type4a.md)|[非官方 MIFARE DESFire 宝典](/doc/unofficial_desfire_bible.md)|
[关于降级攻击的备注](/doc/hid_downgrade.md)|||
# 如何构建？
## Proxmark3 RDV4
请参阅上表中的说明链接，为您的 Proxmark3 RDV4 设备进行构建、刷写和运行。
## 通用 Proxmark3 平台
为了在通用 Proxmark3 平台上构建此仓库，我们建议您阅读 [高级编译参数](/doc/md/Use_of_Proxmark/4_Advanced-compilation-parameters.md)
我们将通用 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
- **注意**：目前与 iCopy-X GUI 不兼容，因为 Proxmark 客户端命令使用不同的语法
- **注意**：另请参阅 [icopyx-community repos](https://github.com/iCopy-X-Community/) 获取上游源代码、逆向硬件信息等。
- **注意**：使用 DRM 锁定标签，无视开源许可证。使用风险自负。
- ⚠ Proxmark3 Ultimate
- **注意**：未知设备硬件
- **注意**：正在为其构建 FPGA 镜像。使用风险自负。
**未知支持状态**
- ⚠ VX
- **注意**：未知设备硬件
对于这些未知的新型号，我们要依靠社区来报告此仓库是否有效，以及他们做了什么使其工作。
**通用 Proxmark3 平台的 256KB 闪存大小**
# 有哪些变化？
Proxmark3 RDV4 硬件修改：
* 增加了 256KB 闪存
* 增加了智能卡模块
* 增加了用于外围设备的 FPC 连接器，例如蓝牙 + 电池插件
* 改进的天线
* 可更换
* LF Q 因子开关
* LF 125/134 频率开关
* 微型 PCB 外形尺寸
* ABS 外壳
此仓库 vs 官方 Proxmark3 仓库：
请参阅 [更新日志文件](CHANGELOG.md)，我们会尽量保持更新。
简而言之，这个仓库在 Proxmark3 方面为您提供了完全不同的用户体验。
* 支持命令 Tab 补全
* 更丰富的 CLI，使用颜色 / 表情符号
* 到处都实现了帮助文本系统
* 提示系统
* 用户偏好设置
* 在 Linux、OSX 和 Windows 上使用持续集成构建系统进行广泛测试，并定期使用静态分析工具，如
* [Coverity Scan](https://scan.coverity.com/projects/proxmark3-rrg-iceman-repo/)
* Cppcheck (v2.6)
* GCC 和 Clang 严格的诊断标志强制执行
* 自动检测串口并与蓝牙插件无缝集成
* 从客户端内部重新连接到设备
* 支持 Tear-off 攻击
* 支持 NFC NDEF type1, type2, type4a, type4b, mifare, barcode
* 支持 pm3 客户端脚本、lua 脚本、python 脚本
* 可用最全面的脚本集合
* Wiegand 编码、解码。
* 支持 EMV
* 支持 CIPURSE
* 可用最多的独立模式，且易于编译
* 针对客户端和外部工具的广泛测试脚本
* 编译最全面的已知密钥字典
* 精简的 USB 通信，使用 NG-frames
* 编译最多的公共已知密钥恢复软件
* 上述软件的最快实现
* 支持转储文件的多种文件格式 (BIN/EML/JSON)
* 上述文件格式与 libnfc、MFC tool app 等的互操作性
* 支持比以往更多的基于 RFID 的协议
* 方便包维护者、发行版维护者安装
* 支持 cmake, make
* 在比以往更多的操作系统/平台上构建无错误或警告
* 作为已知发行版（如 Gentoo, Kali, Termux, Macports, Homebrew）上的软件包可用
* 更多的文档
# 开发
如果你有兴趣做出贡献，[公开路线图](https://github.com/RfidResearchGroup/proxmark3/wiki/Public-Roadmap) 是一个极好的阅读起点。
## 支持的操作系统
此仓库在以下平台上编译良好
- Windows 10 上的 WSL1
- Windows 10/11 上的 WSL2
- Proxspace 环境 [release v3.xx](https://github.com/Gator96100/ProxSpace/releases)
- 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 的容器 ](https://hub.docker.com/r/secopsconsult/proxmark3)
- [ Iceman fork 基于的容器 v1.7 ](https://hub.docker.com/r/iceman1001/proxmark3/)
## 预编译二进制文件
参见 [Proxmark3 预编译构建](https://www.proxmarkbuilds.org/)
## Proxmark3 GUI
来自 Gaucho 的官方 PM3-GUI 将无法工作。更不用说它相当陈旧且不再维护。
- [Proxmark3 Universal GUI](https://github.com/burma69/PM3UniversalGUI) 或多或少能用。
- [Proxmark3 GUI cross-compiled](https://github.com/wh201906/Proxmark3GUI/) 最近有更新，并声称支持此仓库的最新源代码。
- [Proxmark3_GUI](https://github.com/Phreak87/Proxmark3_GUI) 用 vb.net 编写的简单 GUI
## 官方渠道
你在哪里可以找到社区？
- [RFID Hacking 社区 discord 服务器](https://t.ly/d4_C)
- [Proxmark3 IRC 频道](https://web.libera.chat/?channels=#proxmark3)
- [Proxmark3 sub reddit](https://www.reddit.com/r/proxmark3/)
- [Proxmark3 论坛](http://www.proxmark.org/forum/index.php)
## 维护者
致所有的发行版、包维护者，我们试图让你们的工作更轻松。
`make install` 现在可用，如果你想了解更多。
这份文档对你会有帮助
- [维护者须知](/doc/md/Development/Maintainers.md)
## 引用
使用此 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](AUTHORS.md)。
Proxmark3 源代码受以下许可条款涵盖，通常称为 **GPLv3 or later**。
```
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
```
GPLv3 的副本可在 [LICENSE](LICENSE.txt) 中找到。
某些依赖项可能受与 Proxmark3 许可条款兼容的其他免费许可条款约束，请参阅它们各自的描述。
标签：Bash脚本, Iceman, IoT安全, Lua脚本, NFC, Proxmark3, RFID, rizin, SysWhispers, 低频, 侧信道攻击, 信号分析, 克隆卡, 固件, 客户端加密, 客户端加密, 客户端加密, 射频识别, 嵌入式安全, 攻击路径可视化, 智能卡, 硬件安全, 芯片识别, 逆向工具, 配置审计, 门禁系统, 防御绕过, 高频, 黑客工具