# NFCX
**Repository Path**: Hackerpro/NFCX
## Basic Information
- **Project Name**: NFCX
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-20
- **Last Updated**: 2026-09-20
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# NFCX
跨平台、开源、简单易用的 NFC 图形化桌面工具。
English | 简体中文
NFCX 将读卡器发现、卡片信息、读取写入等功能集中到一个 macOS、Windows 与 Linux 桌面应用中，适用于你拥有或获准测试的 MIFARE Classic 卡片。
NFCX 坚持开源，并用清晰、直接的 GUI 让 NFC 操作不再依赖零散的命令行工具。
官网：[nfcx.tools](https://nfcx.tools) · 下载：[GitHub Releases](https://github.com/BennyThink/NFCX/releases)
# NFCX 能做什么
- 发现并连接 NFC 读卡器
- 检测卡片并显示 UID、ATQA、SAK 与卡片类型。
- 操作 MIFARE Classic 1K：使用 Key A/Key B 认证、读取编辑数据及写入变更。
- 保存和加载兼容的原始 dump（`.bin` / `.mfd`）及并列元数据；恢复时执行容量、BCC、访问控制位和逐块回读检查。
- 扫描常见密钥，并管理本地密钥目录。
- 在已验证的 PN532 UART 读卡器上运行集成恢复流程：常见密钥、Darkside、Nested、Hardnested 与读取验证。
- 对支持的 CUID/Gen2 和 Gen1A 卡片执行受保护的 4-byte UID/block 0 写入。
# 支持的读卡器
| 读卡器 | 连接 / 后端 | 状态 | 平台 |
| --- | --- | --- | --- |
| PN532 + FT232RL | 串口，通过 libnfc `pn532_uart` | **已测试**：发现、Classic 读写、dump/restore 与密钥恢复 | macOS、Windows、Linux 构建 |
| 其他 PN532 UART 适配器 | 串口，通过 libnfc `pn532_uart` | **预期兼容**，尚未由本项目硬件测试 | 取决于适配器驱动和串口权限 |
| ACR122U | USB / PC/SC 或 libnfc | **当前版本不支持**：未完成 NFCX 硬件验证，也未启用发布配置 | — |
| ACR1552U | USB / 厂商 PC/SC 驱动 | **当前版本不支持**：未完成 NFCX 硬件验证，也未启用发布配置 | — |
| 其他 libnfc 设备 | 因设备而异 | 在获得明确 NFCX 验证配置前均为**不支持** | — |
# 驱动和运行要求
NFCX 自带 NFC 运行时；不需要另外安装 libnfc、mfoc、mfcuk 或命令行 NFC 工具。
- Linux：当前账户通常需要获得串口读写权限（常见为 `dialout` 组）。例如：`sudo usermod -aG dialout $USER`；重新登录后生效。也可以在明确了解风险的前提下，以 `sudo` 运行。
- macOS：未签名版本可能显示 Gatekeeper 警告；可在“系统设置 → 隐私与安全性”中按提示允许打开。
- Windows：启动 NFCX 可能需要先安装请安装 [FTDI 虚拟串口驱动](https://ftdichip.com/drivers/)
# 下载和安装
1. 打开 [GitHub Releases](https://github.com/BennyThink/NFCX/releases)。
2. 下载适合你操作系统的安装包或压缩包。
3. 安装或解压；必要时安装读卡器驱动。
4. 连接读卡器并启动 NFCX。
# 快速开始
1. 连接 NFC 读卡器并启动 NFCX。
2. 刷新读卡器列表，或输入 PN532 UART connstring。
3. 将获授权卡片放在读卡器上，选择 **Scan Card**。
4. 查看卡片信息，按需使用对应功能。
备注：PN532的UART/HSU模式示意图
# 常见问题
还需要读卡器吗？
需要。NFCX 通过兼容的外接读卡器与实体 NFC 卡通信。
支持什么设备？
已测试的组合是 PN532 + FT232RL。其他串口适配器理论上也可使用，但建议选用 FT232RL。请将 PN532 调至 UART/HSU 模式，并交叉连接数据线（PN532 RX 接串口 TX）。建议焊接连接，避免杜邦线接触不良。
能把门禁卡写入 iPhone 吗？
NFCX 可以操作实体门禁卡，但 iPhone 中的卡不像普通白卡一样可任意写入。可考虑购买 NFC 卡贴，写入后贴在手机背面使用。
建议买什么卡片？
建议准备 CUID 卡用于已获授权的测试；它通常支持修改 UID，且全 F 的 Key A 和 Key B 便于测试。
能复制门禁卡吗？
取决于卡片类型和门禁系统的设计。请只对你拥有或获明确授权测试的卡片和系统操作。
为什么 NFCX 找不到读卡器？
请检查串口位置、适配器驱动、设备是否被其他程序占用，以及当前系统账户是否拥有串口访问权限。
推荐买什么硬件？
PN532 + FT232RL，再配多张 CUID 测试卡，是当前已验证的入门组合。
macOS、Linux 和 Windows 都支持吗？
支持。NFCX 面向 macOS、Windows 和 Linux 构建；具体读卡器仍以已测试的硬件配置为准。
为什么能读 UID 但是修改不了？
UID 所在的 block 0 默认不能写入。只有部分特殊的 Gen1/Gen2 卡，例如 CUID Magic Card 或部分复旦卡，才允许修改；普通卡不应尝试修改。
为什么 UID 一样还是开不了门？
系统可能不仅验证 UID，还会验证其他扇区的数据，甚至使用滚动码。因此相同 UID 并不一定具有相同的访问权限。
什么是 Key A 和 Key B？
它们是 MIFARE Classic 每个扇区使用的两把认证密钥。访问控制位决定各自可以读取或写入哪些数据；它们不是通用密码，也不应随意公开。
Darkside 和 Nested 是什么？
它们是针对部分 MIFARE Classic 卡片已知弱点的密钥恢复方法。NFCX 仅在你拥有或获明确授权的测试场景中提供相应工作流。
能复制车钥匙吗？
需要看厂商的具体设计。部分系统可能使用 NFC，但许多车钥匙采用其他无线协议、加密或滚动码；请仅处理你拥有或获授权测试的设备。
软件会上传我的数据吗？
不会上传卡片 UID、密钥、dump、卡片内容或个人信息。匿名遥测仅在首次启动时由你选择开启，之后可随时关闭。
免费开源吗？
是。NFCX 源码以 MIT License 发布；随发行版提供的第三方组件按各自许可证分发。
可以商用吗？
NFCX 自身采用 MIT License，通常允许商用。若重新分发应用或其运行时组件，请同时遵守其中第三方组件各自的许可证义务。
可以赞助吗？
可以。你可以通过 [GitHub Sponsors 赞助 NFCX](https://github.com/sponsors/BennyThink)。