RFID 분석, 에뮬레이션 및 침투 테스트를 위한 하드웨어 도구. 키 복구, 스니핑 및 보안 연구용 스크립팅을 지원하는 125kHz, 13.56MHz 프로토콜(MIFARE, iClass, ISO14443/15693)을 지원합니다.
# Iceman 포크 - Proxmark
Proxmark는 RFID의 만능 도구로, 전 세계적으로 대부분의 RFID 태그와 상호 작용할 수 있습니다. 원래 Jonathan Westhues가 제작한 이 장치는 이제 애호가들을 위한 RFID 분석의 필수 도구입니다.
Iceman 저장소는 기능과 성능의 정점으로 여겨지며, 칩 식별, 침투 테스트, 프로그래밍을 자동화하는 매우 유용하고 편리한 명령과 Python/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 포크 - Proxmark](#iceman-fork---proxmark)
- [목차](#table-of-contents)
- [PROXMARK3 설치 및 개요](#proxmark3-installation-and-overview)
- [참고 사항 / 유용한 문서](#notes--helpful-documents)
- [빌드 방법](#how-to-build)
- [Proxmark5](#proxmark5)
- [Proxmark3 RDV4](#proxmark3-rdv4)
- [일반 Proxmark3 플랫폼](#generic-proxmark3-platforms)
- [무엇이 변경되었나요?](#what-has-changed)
- [개발](#development)
- [지원되는 운영 체제](#supported-operating-systems)
- [사전 컴파일된 바이너리](#precompiled-binaries)
- [GUI](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Use_of_Proxmark/Promark-GUIs.md)
- [공식 채널](#official-channels)
- [유지 관리자](#maintainers)
- [인용](#citation)
- [저작권 및 라이선스 조건](#copyright-and-licensing-terms)
# PROXMARK3 설치 및 개요
| 설치 | Proxmark3 사용법 |
| :------------------: | :------------------: |
| [Linux - 설정 및 빌드](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Installation_Instructions/Linux-Installation-Instructions.md) | [컴파일 지침](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Use_of_Proxmark/0_Compilation-Instructions.md)|
| [Linux - ModemManager에 관한 중요 사항](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Installation_Instructions/ModemManager-Must-Be-Discarded.md) | [Proxmark3 클라이언트 기능 검증](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Use_of_Proxmark/1_Validation.md)|
| [macOS - Homebrew 및 HomeBrew Tap Formula 업그레이드](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Installation_Instructions/macOS-Homebrew-Installation-Instructions.md) | [최초 사용 및 검증](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Use_of_Proxmark/2_Configuration-and-Verification.md)|
| [macOS - MacPorts](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Installation_Instructions/macOS-MacPorts-Installation-Instructions.md) | [명령어 및 기능](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Use_of_Proxmark/3_Commands-and-Features.md)|
| [macOS - 설정 및 빌드](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Installation_Instructions/macOS-Compile-From-Source-Instructions.md) |[독립 실행 모드](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/standalone)|
| [Windows - 설정 및 빌드](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Installation_Instructions/Windows-Installation-Instructions.md) ||
| [Termux / Android - 설정 및 빌드](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/termux_notes.md) ||
| [iOS - 설정 및 빌드](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Installation_Instructions/iOS-Installation-Instructions.md)
| [Blue Shark 매뉴얼](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/bt_manual_v10.md) | [명령어 치트 시트](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/cheatsheet.md)|
| [고급 컴파일 매개변수](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Use_of_Proxmark/4_Advanced-compilation-parameters.md) | [추가 치트 시트](https://github.com/RfidResearchGroup/proxmark3/wiki/More-cheat-sheets)|
| [문제 해결](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Installation_Instructions/Troubleshooting.md) | [전체 클라이언트 명령어 세트](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/commands.md) |
| [JTAG](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/jtag_notes.md) | [T5577 소개 가이드](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/T5577_Guide.md)|
## 참고 사항 / 유용한 문서
| 참고 사항 |||
| ------------------- |:-------------------:| -------------------:|
|[UART 관련 참고 사항](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/uart_notes.md)|[Termux / Android 관련 참고 사항](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/termux_notes.md)|[경로 관련 참고 사항](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/path_notes.md)|
|[프레임 형식 관련 참고 사항](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/new_frame_format.md)|[tracelog / wireshark 관련 참고 사항](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/trace_notes.md)|[EMV 관련 참고 사항](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/emv_notes.md)|
|[외부 플래시 관련 참고 사항](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/ext_flash_notes.md)|[loclass 관련 참고 사항](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/loclass_notes.md)|[Coverity Scan 구성 및 실행 관련 참고 사항](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Development/Coverity-Scan-Config-and-Run.md)|
|[Proxmark3에서 사용되는 파일 형식 관련 참고 사항](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/extensions_notes.md)|[MFU 바이너리 형식 관련 참고 사항](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/mfu_binary_format_notes.md)|[FPGA 및 ARM 관련 참고 사항](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/fpga_arm_notes.md)|
|[독립 실행 모드 개발](https://github.com/rfidresearchgroup/proxmark3/blob/master/armsrc/Standalone/readme.md)|[독립 실행 모드에 관한 Wiki](https://github.com/RfidResearchGroup/proxmark3/wiki/Standalone-mode)|[Magic UID 카드 관련 참고 사항](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/magic_cards_notes.md)|
|[색상 사용 관련 참고 사항](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/colors_notes.md)|[Makefile vs CMake](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Development/Makefile-vs-CMake.md)|[Cloner gun 관련 참고 사항](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/cloner_notes.md)|
|[cliparser 사용 관련 참고 사항](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/cliparser.md)|[클록 관련 참고 사항](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/clocks.md)|[MIFARE DESFire 관련 참고 사항](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/desfire.md)|
|[CIPURSE 관련 참고 사항](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/cipurse.md)|[NDEF type4a 관련 참고 사항](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/ndef_type4a.md)|[비공식 MIFARE DESFire 바이블](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/unofficial_desfire_bible.md)|[iClass legrec-legbrute 키 복구 관련 참고 사항](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/iclass_legrec_legbrute_key_recovery.md)|[다운그레이드 공격 관련 참고 사항](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/hid_downgrade.md)|||
# 빌드 방법
## Proxmark5
마지막 하드웨어 세대는 Proxmark5라고 불립니다. 구성은 다음과 같습니다.
- MCU: AT32F435, 288 MHz Artery Cortex-M4
- Gowin FPGA
- TypeC Extended Port (CEP)
- ESp32c2를 통한 BLE / Wifi / 배터리 애드온
- 교체 가능한 안테나 (LF, HF, UHF)
- 125, 134, 250, 375, 500 KHz 저주파 안테나 (LF)
- 13.56 MHz 고주파 안테나 (HF)
- 애드온으로: 860-960 MHz 초고주파 안테나 (UHF), ** 아직 개발되지 않음 **
현재 Proxmark5 전용 안내는 모두 [단일 시작 가이드](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/PM5_Start_Here/Getting_Started_With_PM5.md)에 정리되어 있습니다.
이 문서를 읽고 Proxmark5 장치를 빌드, 플래시 및 실행하십시오. 컴파일 환경을 구성하려면 위 표의 안내 링크를 참조하십시오.
- ⚠ 현재 펌웨어는 안정적이지 않으며 활발히 개발 중입니다.
## Proxmark3 RDV4
Proxmark3 RDV4 장치를 빌드, 플래시 및 실행하려면 위 표의 안내 링크를 참조하십시오.
## 일반 Proxmark3 플랫폼
일반 Proxmark3 플랫폼용으로 이 저장소를 빌드하려면 [고급 컴파일 매개변수](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Use_of_Proxmark/4_Advanced-compilation-parameters.md)를 읽어 보시기 바랍니다.
일반 Proxmark3 플랫폼은 다음 장치로 정의합니다.
**지원됨**
- RDV1, RDV2, RDV3 easy
- Ryscorp green PCB 버전
- Radiowar black PCB 버전
- 다수의 중국에서 개조된 RDV3 easy 버전 (kkmoon, PiSwords 등)
- Proxmark3 SE (Special Edition) (BLE 지원)
- Proxmark3 X
- **참고**: 커뮤니티에서 테스트됨
- **참고**: 장치 하드웨어 미상
- iCopy-X
- **참고**: [iCopy-X 오픈 소스 펌웨어](https://github.com/lab-401/icopy-x) 설치 후에만 호환됨
- 공장 펌웨어는 **호환되지 않음** (클라이언트 명령이 다름 / 공장 UI는 클로즈드 소스 / 공장 펌웨어는 태그 DRM을 강제함)
**지원되지 않음**
- ⚠ Proxmark Evolution (EVO)
- **참고**: 핀 할당 미상.
- ⚠ Ryscorp Proxmark3 Pro
- **참고**: 장치의 FPGA가 다르고 핀 할당이 미상임.
- **참고**: 회사가 사라져 고객들을 어둠 속에 남겨둠.
**실험적 지원**
- ⚠ Proxmark3 Ultimate
- **참고**: 장치 하드웨어 미상
- **참고**: 이를 위한 FPGA 이미지가 빌드되고 있음. 사용은 본인 책임하에 하십시오.
**지원 상태 미상**
- ⚠ VX
- **참고**: 장치 하드웨어 미상
이러한 새로운 미상 모델과 관련해서는 이 저장소가 작동하는지, 작동시키기 위해 무엇을 했는지 커뮤니티가 보고해 주기를 기대하고 있습니다.
**일반 Proxmark3 플랫폼의 256KB 플래시 메모리 크기**
> ⚠ **참고**:
> ARM 칩에 내장된 플래시 메모리의 크기를 주의 깊게 살펴야 합니다.
> 512KB라면 문제없지만 256KB라면 이 저장소를 더 적은 기능으로 컴파일해야 합니다.
> 이 저장소의 부트로더가 설치되어 있다면 `./pm3-flash-all`을 실행할 때 장치의 크기를 확인할 수 있습니다.
> 그렇지 않으면 Proxmark3 클라이언트 `./pm3`를 실행할 때 시작 메시지에 보고되는 크기를 확인할 수 있습니다.
>
> [주의! 256KB 플래시 메모리 관련 권고 사항을 읽으십시오](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Use_of_Proxmark/4_Advanced-compilation-parameters.md#256KB-versions)
# 무엇이 변경되었나요?
최신 상태로 유지하려고 노력하는 [변경 로그 파일](https://github.com/rfidresearchgroup/proxmark3/blob/master/CHANGELOG.md)을 참조하십시오.
# 개발
> ⚠ **참고**: 이 저장소는 최신 개발 버전(bleeding edge)입니다. 유지 관리자들은 이 저장소에서 활발히 작업하고 있으며 코드를 더 쉽게 이해하고 탐색하고 빌드하고 테스트하고 기여할 수 있도록 주기적으로 코드를 재구성할 것입니다. 따라서 **정기적으로 코드 레이아웃에 상당한 변경이 있을 것으로 예상하십시오**.
> 👉 **기억하십시오!** 코드에 기여할 의향이 있다면 먼저 [코딩 스타일 노트](https://github.com/rfidresearchgroup/proxmark3/blob/master/CONTRIBUTING.md)를 읽어 주십시오.
우리는 Proxmark3에 기능을 추가하고 나중에 버그를 제거하는 방식을 좋아하기 때문에 여러분의 기여를 보통 빠르게 병합합니다.
기여에 관심이 있다면 [공개 로드맵](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 repo 기반 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/)를 참조하세요.
## 공식 채널
커뮤니티는 어디에서 찾을 수 있나요?
- [RFID Hacking 커뮤니티 디스코드 서버](https://t.ly/d4_C)
- [Proxmark3 IRC 채널](https://web.libera.chat/?channels=#proxmark3)
- [Proxmark3 서브레딧](https://www.reddit.com/r/proxmark3/)
## 유지관리자
모든 배포판 및 패키지 유지관리자 여러분, 여러분의 작업을 더 쉽게 만들기 위해 노력했습니다.
이제 `make install`을 사용할 수 있으며, 더 자세히 알고 싶다면
이 문서가 도움이 될 것입니다
- [유지관리자를 위한 노트](https://github.com/rfidresearchgroup/proxmark3/blob/master/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](https://github.com/rfidresearchgroup/proxmark3/blob/master/AUTHORS.md)를 참조하십시오.
Proxmark3 소스 코드는 일반적으로 **GPLv3 이상**으로 지칭되는 다음 라이선스 조건의 적용을 받습니다.
이 프로그램은 자유 소프트웨어입니다: 귀하는 자유 소프트웨어 재단이 발행한
GNU 일반 공중 사용 허가서의 조건에 따라, 라이선스 버전 3 또는
(귀하의 선택에 따라) 이후 버전에 따라 이를 재배포 및/또는 수정할 수 있습니다.
이 프로그램은 유용하게 사용될 수 있기를 바라는 희망에서 배포되지만,
어떠한 보증도 제공하지 않습니다. 상품성 또는 특정 목적에 대한 적합성에 대한
묵시적 보증도 포함되지 않습니다. 자세한 내용은
GNU 일반 공중 사용 허가서를 참조하십시오.
GPLv3의 사본은 [LICENSE](https://github.com/rfidresearchgroup/proxmark3/blob/master/LICENSE.txt)에서 확인할 수 있습니다.
일부 종속성은 Proxmark3 라이선스 조건과 호환되는 다른 자유 라이선스 조건의 적용을 받을 수 있으며, 각각의 설명을 참조하십시오.