أداة عتادية لتحليل RFID ومحاكاته واختبار الاختراق. تدعم بروتوكولات 125kHz و13.56MHz (MIFARE وiClass وISO14443/15693) مع استعادة المفاتيح، والتنصت، وكتابة السكربتات لأغراض البحث الأمني.
# Iceman Fork - 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 Fork - 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)
- [واجهات GUIs](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](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)|[ويكي حول الوضع المستقل](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 مقابل CMake](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Development/Makefile-vs-CMake.md)|[ملاحظات حول Cloner guns](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، وهو Artery Cortex-M4 بتردد 288 MHz
- Gowin FPGA
- منفذ TypeC الموسع (CEP)
- إضافة BLE / Wifi / بطارية، عبر ESp32c2
- هوائيات قابلة للتبديل (LF، HF، UHF)
- هوائي التردد المنخفض (LF) بترددات 125، 134، 250، 375، 500 KHz
- هوائي التردد العالي (HF) بتردد 13.56 MHz
- كإضافة: هوائي التردد العالي جدًا (UHF) بتردد 860-960 MHz، ** لم يُطوَّر بعد **
في الوقت الحالي، جميع التعليمات الخاصة بـ Proxmark5 مجمّعة في [دليل واحد للبدء](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/PM5_Start_Here/Getting_Started_With_PM5.md).
اقرأه لبناء جهاز Proxmark5 الخاص بك وبرمجته وتشغيله. راجع روابط التعليمات في الجداول أعلاه للحصول على بيئة الترجمة.
- ⚠ البرنامج الثابت (firmware) غير مستقر في الوقت الحالي ويجري تطويره بنشاط.
## 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 ذات لوحة PCB خضراء
- نسخة Radiowar ذات لوحة PCB سوداء
- العديد من النسخ الصينية المعدّلة من RDV3 easy (kkmoon، PiSwords وغيرها)
- Proxmark3 SE (الإصدار الخاص) (مزوّد بـ BLE)
- Proxmark3 X
- **ملاحظة**: تم اختباره من قِبل المجتمع
- **ملاحظة**: عتاد الجهاز غير معروف
- iCopy-X
- **ملاحظة**: متوافق **فقط** بعد تثبيت [البرنامج الثابت مفتوح المصدر iCopy-X](https://github.com/lab-401/icopy-x)
- البرنامج الثابت من المصنع **غير** متوافق (أوامر العميل مختلفة / واجهة المصنع مغلقة المصدر / البرنامج الثابت من المصنع يفرض DRM على الوسوم)
**غير مدعومة**
- ⚠ Proxmark Evolution (EVO)
- **ملاحظة**: تعيينات المنافذ (pins) غير معروفة.
- ⚠ Ryscorp Proxmark3 Pro
- **ملاحظة**: يحتوي الجهاز على fpga مختلف وتعيينات منافذ غير معروفة.
- **ملاحظة**: اختفت الشركة، تاركةً عملاءها في الظلام.
**دعم تجريبي**
- ⚠ Proxmark3 Ultimate
- **ملاحظة**: عتاد الجهاز غير معروف
- **ملاحظة**: يجري بناء صور FPGA له. استخدمه على مسؤوليتك الخاصة.
**حالة الدعم غير معروفة**
- ⚠ VX
- **ملاحظة**: عتاد الجهاز غير معروف
فيما يتعلق بهذه الطُرز الجديدة غير المعروفة، فإننا نعتمد على المجتمع للإبلاغ عمّا إذا كان هذا المستودع يعمل وما فعلوه لجعله يعمل.
**حجم ذاكرة الفلاش 256KB في منصات Proxmark3 العامة**
> ⚠ **ملاحظة**:
> عليك أن تراقب حجم ذاكرة الفلاش المدمجة في شريحة ARM الخاصة بك.
> مع 512KB أنت بخير، لكن إذا كان الحجم 256KB فستحتاج إلى ترجمة هذا المستودع بوظائف أقل.
> عند تشغيل `./pm3-flash-all` يمكنك رؤية الحجم الذي يمتلكه جهازك إذا كان لديك محمّل الإقلاع (bootloader) من هذا المستودع مثبتًا.
> وإلا فستجد الحجم مذكورًا في رسالة البدء عند تشغيل عميل 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) بداية ممتازة للقراءة إذا كنت مهتمًا بالمساهمة.
## أنظمة التشغيل المدعومة
يُترجم هذا المستودع بشكل جيد على
- WSL1 على Windows 10
- WSL2 على Windows 10/11
- بيئة Proxspace [الإصدار 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 (مخترق، بصلاحيات الجذر)
- حاوية Docker
- [ حاوية ubuntu 18.04 المبنية على مستودع Iceman ](https://hub.docker.com/r/secopsconsult/proxmark3)
- [ حاوية v1.7 المبنية على تفرع Iceman ](https://hub.docker.com/r/iceman1001/proxmark3/)
## الملفات الثنائية المُجمَّعة مسبقًا
راجع [إصدارات Proxmark3 المُجمَّعة مسبقًا](https://www.proxmarkbuilds.org/)
## القنوات الرسمية
أين تجد المجتمع؟
- [خادم Discord لمجتمع اختراق RFID](https://t.ly/d4_C)
- [قناة Proxmark3 على IRC](https://web.libera.chat/?channels=#proxmark3)
- [منتدى Proxmark3 الفرعي على Reddit](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},
}
```
إذا كنت بحاجة إلى الإشارة إلى حالة معينة من المستودع، فاستخدم رقم commit أو تاريخ الوصول، على سبيل المثال:
```
note = {Accessed: commit 12327f71a27da23831901847886aaf20e8ad3ca0}
note = {Accessed: 2021-01-01}
```
## حقوق النشر وشروط الترخيص
كل مساهمة تخضع لحقوق نشر مؤلفها. راجع [AUTHORS](https://github.com/rfidresearchgroup/proxmark3/blob/master/AUTHORS.md).
يخضع الكود المصدري لـ Proxmark3 لشروط الترخيص التالية، والتي يُشار إليها عادةً باسم **GPLv3 أو أحدث**.
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](https://github.com/rfidresearchgroup/proxmark3/blob/master/LICENSE.txt).
قد تخضع بعض التبعيات لشروط تراخيص حرة أخرى متوافقة مع شروط ترخيص Proxmark3، راجع وصف كل منها.