卡片计算器及Proxmark3插件，用于写入和/或模拟Doppelgänger Community、Pro、Stealth 和 MFAS 所支持的每一种卡类型。
一款专业的GUI应用程序，用于计算卡片数据并自动执行Proxmark3针对Doppelgänger Core和Stealth所支持的所有卡片类型的操作。该工具通过提供具有双输出显示、视觉分隔符和一键剪贴板复制的直观界面，简化了物理渗透测试中的卡片写入流程，无需记忆复杂的Proxmark3语法或翻阅笔记。
自动安装程序将安装Doppelganger Assistant、所需依赖项以及最新的Iceman分支版Proxmark3。安装过程中，系统会提示您选择Proxmark3设备类型以实现最佳配置。
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/tweathers-sec/doppelganger_assistant/main/installers/doppelganger_install_macos.sh)"
### Linux```bash
curl -sSL https://raw.githubusercontent.com/tweathers-sec/doppelganger_assistant/main/installers/doppelganger_install_linux.sh | sudo bash
以管理员身份打开 PowerShell 并运行：```powershell irm https://raw.githubusercontent.com/tweathers-sec/doppelganger_assistant/main/installers/doppelganger_install_windows.ps1 | iex
**注意：**安装程序会提示您在 **Ubuntu 24.04 LTS (Noble)**（推荐）或 **Kali Linux** 之间进行选择。它将自动检测现有安装并提示您更新。如果需要重启以启用 WSL 功能，您将收到提示。重启后只需再次运行相同的命令即可。
⚠️ 重要提示：WSL2 不支持在嵌套虚拟机中运行。安装程序会自动检测并阻止在此类环境中安装。要继续，请在物理硬件上安装。
## Doppelgänger Assistant 的功能
Doppelgänger Assistant 提供了完整的卡片分析和克隆工作流程，从初始检测到成功的写入操作。该应用程序自动识别卡片技术、提取凭证数据、恢复加密密钥，并带有验证功能写入克隆卡片。
### 智能卡片检测
卡片发现功能自动扫描低频和高频芯片，识别双芯片卡，并确定具体卡片技术，包括 HID Prox、iCLASS、PicoPass、MIFARE 等。结果包含已解码的 Wiegand 数据，包括设施代码和卡号（如可用）。
### 酒店门卡分析
酒店门禁控制区域提供了针对基于 MIFARE 的酒店钥匙系统的专用工具。卡片信息检索会自动识别 Saflok 酒店钥匙卡，并显示详细信息，包括 UID、卡片类型、魔术功能以及 PRNG 检测。原始的 Proxmark3 输出包含完整的 Saflok 元数据（如可用）。
### 自动密钥恢复
MIFARE 攻击工具包括多种恢复方法：Autopwn（自动多方法）、Darkside、Nested、Hardnested、Static Nested、Bruteforce 和 NACK 漏洞测试。Autopwn 根据卡片特性自动选择最佳攻击方法。结果以全面的恢复摘要显示，包含恢复的扇区数、找到的密钥总数、使用的恢复方法以及自动生成的转储文件，用于立即克隆卡片。
### 企业门禁卡操作
企业门禁控制区域支持读取和写入 iCLASS、PicoPass、AWID、HID Prox、Indala、Avigilon 及其他企业卡片技术。卡片数据会自动从 Proxmark3 输出中解析，提取设施代码、卡号、位长度、格式类型（H10301、C1k35s 等）、CSN 值和原始十六进制数据。集成的工作流程可立即写入空白卡，并可选择性进行验证。
### 完整克隆工作流程
Doppelgänger Assistant 与 Doppelgänger RFID 硬件和 Proxmark3 设备无缝集成。使用 Doppelgänger 读取器捕获的凭证可直接导入 GUI 进行分析和写入。该应用程序支持从多个制造商读取卡片、解析来自 Web 界面的数据，并执行带有实时状态更新和验证的写入操作。
## 更新日志
### 版本 1.1.2（2025 年 12 月 18 日）
**新功能：**
* 添加了“启动 PM3”按钮，可在独立终端窗口中打开 Proxmark3
* 添加了卡片发现区域，支持自动卡片类型检测
* 为所有支持的卡片类型添加了“读取卡片数据”功能
* 添加了酒店/居住区门禁控制区域，包含 MIFARE 工具
* 添加了双芯片卡片检测，适用于同时具有低频和高频功能的卡片
* 添加了检测到 MIFARE 卡片时的自动卡片信息检索功能
**改进：**
* 改进了卡片检测，可显示具体的 MIFARE 类型和魔术功能
* 增强了卡片验证，提供更清晰的验证成功消息
* 在整个应用程序中优化了错误处理和用户反馈
* 改进了 iCLASS 卡片读取，支持自动解密
### 版本 1.1.1
* 初始版本，包含核心卡片写入、验证和模拟功能
* 支持 PROX、iCLASS、AWID、Indala、Avigilon、EM4100、PIV 和 MIFARE 卡片
## Doppelgänger 设备
您可以从 [Physical Exploitation Store](https://store.physicalexploit.com/) 购买 Stealth 读取器、Doppelgänger Dev Board 或全组装远距离读取器。关于开源固件，请查看 [Doppelgänger Core](https://github.com/mwgroup-io/Doppelganger_Core)。
## 支持的 Proxmark3 设备
Doppelgänger Assistant 与 [Iceman Proxmark3 分支](https://github.com/RfidResearchGroup/proxmark3) 兼容，并支持以下设备类型：
* **Proxmark3 RDV4** - 带或不带 Blueshark 蓝牙附件
* **Proxmark3 Easy (512KB)** - 通用平台支持
安装时会提示您选择设备类型以便进行最佳配置。
## 企业 PACS 卡片类型
以下是基于 Doppelgänger 固件的官方支持的企业 PACS 卡片类型。酒店/Mifare 钥匙卡支持于版本 1.1.2 添加，包括密钥恢复和克隆功能。请注意，酒店钥匙卡 / 详细的 Mifare 分析与使用 Doppelgänger 产品捕获的数据不完全对应。这只是为支持物理渗透测试工作而增加的功能，目前仍在完善中。
| Card Types | Core | Stealth | FC Range | CN Range |
| --------------------------- | ---- | ------- | ----------- | --------------- |
| Keypad PIN Codes | | X | N/A | N/A |
| HID H10301 26-bit | X | X | 0–255 | 0–65,535 |
| Indala 26-bit | X | X | 0–255 | 0–65,535 |
| Indala 27-bit | X | X | 0–4,095 | 0–8,191 |
| 2804 WIEGAND 28-bit | X | X | 0–255 | 0–16,383 |
| Indala 29-bit | X | X | 0–4,095 | 0–32,767 |
| ATS Wiegand 30-bit | X | X | 0–2,047 | 0–32,767 |
| HID ADT 31-Bit | X | X | 0–15 | 0–8,388,607 |
| EM4102 / Wiegand 32-bit | X | X | 0–32,767 | 0–65,535 |
| HID D10202 33-bit | X | X | 0–127 | 0–16,777,215 |
| HID H10306 34-bit | X | X | 0–65,535 | 0–65,535 |
| HID Corporate 1000 35-bit | X | X | 0–4,095 | 0–1,048,575 |
| HID Simplex 36-bit (S12906) | X | X | 0–255 | 0–65,535 |
| HID H10304 37-bit | X | X | 0–65,535 | 0–524,287 |
| HID H800002 46-bit | X | X | 0–16,383 | 0–1,073,741,823 |
| HID Corporate 1000 48-bit | X | X | 0–4,194,303 | 0–8,388,607 |
| AWID 50-bit | X | X | 0–65,535 | 0–8,388,607 |
| Avigilon 56-bit | X | X | 0–1,048,575 | 0–4,194,303 |
| C910 PIVKey | X | X | N/A | N/A |
| MIFARE (Various Types) | X | X | N/A | N/A |
支持的技术包括：
* iCLASS（Legacy/SE/Seos） *注意：捕获的 SE 和 Seos 卡片只能写入 iCLASS 2k 卡片*
* PROX
* Indala
* AWID
* Avigilon
* EM4102
* PIV（仅 UID - 因为这是通过读取器 Wiegand 输出提供的数据）
* MIFARE（仅 UID - 因为这是通过读取器 Wiegand 输出提供的数据）
## 详细安装说明
### MacOS 手动安装
1. 从 [发布页面](https://github.com/tweathers-sec/doppelganger_assistant/releases) 下载适合您架构的 DMG 文件：
- Apple Silicon（M1/M2/M3）：`doppelganger_assistant_darwin_arm64.dmg`
- Intel：`doppelganger_assistant_darwin_amd64.dmg`
2. 打开 DMG 文件，将 `doppelganger_assistant.app` 拖到您的 `/Applications` 文件夹中
3. 移除隔离属性： ```sh
xattr -cr /Applications/doppelganger_assistant.app
~/.zshrc 或 ~/.zprofile）来创建命令行别名: ```sh
alias doppelganger_assistant='/Applications/doppelganger_assistant.app/Contents/MacOS/doppelganger_assistant'
选项1：使用.deb包 (Debian/Ubuntu/Kali - 推荐)
安装依赖项： ```sh sudo apt update && sudo apt upgrade -y sudo apt install libgl1 xterm wget -y
下载并安装适用于你架构的 .deb 包： ```sh
wget https://github.com/tweathers-sec/doppelganger_assistant/releases/latest/download/doppelganger_assistant_linux_amd64.deb sudo dpkg -i doppelganger_assistant_linux_amd64.deb
wget https://github.com/tweathers-sec/doppelganger_assistant/releases/latest/download/doppelganger_assistant_linux_arm64.deb sudo dpkg -i doppelganger_assistant_linux_arm64.deb
修复任何缺失的依赖项（如果需要）： ```sh sudo apt-get install -f -y
选项2：使用 tar.xz 归档（其他发行版）