الكود المصدري لكتاب "Black Hat Python" من تأليف Justin Seitz. تم تحويل الكود بالكامل إلى Python 3، وإعادة تنسيقه ليتوافق مع معايير PEP8، وإعادة هيكلته لإزالة مشاكل الاعتماديات المتعلقة بتطبيق المكتبات المهجورة.
الشيفرة المصدرية من الطبعة الأولى من كتاب Black Hat Python: Python Programming for Hackers and Pentesters للمؤلف Justin Seitz (No Starch Press, 2014)، محوّلة من Python 2 إلى Python 3 ومُعاد هيكلتها لتعمل على المفسّرات والمكتبات الحالية.
تبقى السكربتات قريبة من القوائم المطبوعة حتى يمكن قراءتها جنبًا إلى جنب مع الكتاب. كل تغيير أُجري أثناء التحويل موثّق في docs/CONVERSION_NOTES.md.
[!NOTE] نشرت No Starch Press طبعة ثانية في عام 2021، للمؤلفين Justin Seitz وTim Arnold، مكتوبة لـ Python 3 منذ البداية. يتّبع هذا المستودع الطبعة الأولى. إذا كانت لديك الطبعة الثانية، فاستخدم شيفرة الناشر بدلاً من ذلك.
يوجد تحويل مرافق لكتاب Violent Python للمؤلف TJ O'Connor في EONRaider/violent-python3.
Python 3.11 أو أحدث. اختر أحد الإعدادات التالية.
يقوم uv بتثبيت إصدار
Python المناسب إذا لم يكن لديك، ويعيد إنتاج إصدارات الاعتماديات الدقيقة
المختبرة في CI من uv.lock.
git clone https://github.com/EONRaider/blackhat-python3.git
cd blackhat-python3
uv sync # every chapter
uv run python chapter02/bhnet.py -h
كل فصل هو مجموعة تبعيات منفصلة، لذا يمكنك تثبيت ما تقرأه فقط:
uv sync --only-group ch04 # just chapter 4
على Windows، تقوم مجموعات ch08-ch10 أيضًا بتثبيت pywin32 وwmi؛ على المنصات الأخرى يتم تخطيها تلقائيًا.
git clone https://github.com/EONRaider/blackhat-python3.git
cd blackhat-python3
python3 -m venv .venv
source .venv/bin/activate # Windows: .venv\Scripts\activate
pip install -r requirements.txt # every chapter
pip install -r requirements/ch04.txt # or just one chapter
تحتوي ملفات requirements*.txt على نطاقات إصدارات. للحصول على الإصدارات الدقيقة التي تم اختبارها في CI، استخدم
requirements-lock.txt من أحدث إصدار.
مع pip 25.1 أو أحدث، يمكنك أيضًا تثبيت مجموعة فصل معين مباشرةً من
pyproject.toml باستخدام pip install --group ch04.
ينشر كل إصدار صورةً
لـ linux/amd64 وlinux/arm64 مع تثبيت مسبق لتبعيات كل فصل متعدد المنصات
وأدوات الشبكة الشائعة:
docker run --rm -it ghcr.io/eonraider/blackhat-python3
# Chapters that sniff or forge packets need raw-socket capabilities:
docker run --rm -it --cap-add=NET_RAW --cap-add=NET_ADMIN ghcr.io/eonraider/blackhat-python3
# Or build it yourself:
docker build -t blackhat-python3 . && docker run --rm -it blackhat-python3
تعمل الصورة بصلاحيات root لأن معظم فصول المقابس الخام (raw sockets) تحتاج ذلك. الحاوية
هي بيئة العزل (sandbox)، لذا أضف فقط القدرات التي يحتاجها الفصل. لا يمكن تشغيل فصول Windows
(8-10) داخلها.
استخدم شارة Open in GitHub Codespaces أعلاه، أو افتح المجلد في VS Code أو
JetBrains مع إضافة Dev Containers. تحتوي الحاوية
(.devcontainer/devcontainer.json) على الأدوات نفسها
الموجودة في صورة Docker، بالإضافة إلى uv وgit والمترجمات، وتأتي مع
قدرات المقابس الخام ممنوحة مسبقًا.
| الفصل | الموضوع | مجموعة uv | حزم PyPI | ملاحظات |
|---|---|---|---|---|
| 02 | الشبكة: الأساسيات | ch02 | paramiko | test_rsa.key هو مفتاح الاختبار العام الخاص بـ Paramiko (من مجموعة اختباراته)، ويحتاجه bh_sshserver.py. |
| 03 | المقابس الخام والتنصت | - | - | المكتبة القياسية فقط. يحتاج root / Administrator. |
| 04 | امتلاك الشبكة باستخدام Scapy | ch04 | kamene, opencv-python | يستخدم kamene، وهو تفرع لـ Scapy متوافق مع Python 3 من وقت التحويل. يحتاج root / NET_RAW. |
| 05 | القرصنة على الويب | - | - | المكتبة القياسية فقط. قوائم الكلمات all.txt وcain.txt مضمّنة. |
| 06 | توسيع Burp Proxy | - | - | إضافات Burp Suite تعمل تحت Jython 2.7 (jython-standalone-2.7.2.jar مضمّن)، وليس CPython. |
| 07 | التحكم والقيادة عبر GitHub | ch07 | github3.py | يحتاج إلى مستودع GitHub ورمز وصول شخصي. |
| 08 | مهام التروجان الشائعة على Windows | ch08 | pywin32 (Windows) | Windows فقط. لا يعمل keylogger.py على أي إصدار مدعوم من Python حتى الآن: فهو يستورد pyHook، الذي لا توفره أي حزمة قابلة للتثبيت (انظر ملاحظات التحويل). |
| 09 | المرح مع Internet Explorer | ch09 | pycryptodome, pywin32 (Windows) | Windows فقط، باستثناء أدوات التشفير المساعدة. |
| 10 | تصعيد الصلاحيات على Windows | ch10 | pywin32 (Windows), wmi (Windows) | Windows فقط. bhvulnservice.zip هو الخدمة القابلة للاستغلال في الكتاب. |
| 11 | أتمتة الطب الشرعي الهجومي | - | - | يحتاج إلى Immunity Debugger (immlib، Python 2.7) وإطار عمل Volatility 2. لا يمكن تثبيت أي منهما من PyPI. |
يغطي الفصل الأول من الكتاب إعداد البيئة ولا يحتوي على شيفرة. يُنشأ عمود PyPI
بواسطة python tools/deps_scan.py report، الذي يقرأ الاستيرادات في
كل فصل. تأتي ملاحظات نظام التشغيل والصلاحيات من ملاحظات التحويل وقد تكون
غير مكتملة؛ التصحيحات مرحّب بها.
يبلغ حجم النسخة الكاملة حوالي 46 ميغابايت بالإضافة إلى 51 ميغابايت من السجل. معظم
الشجرة عبارة عن ملف JAR الخاص بـ Jython بحجم 43 ميغابايت في chapter06/، لذا لا توفر
النسخ السطحية (--depth 1) الكثير. لتنزيل الفصول التي تريدها فقط:
git clone --filter=blob:none --sparse https://github.com/EONRaider/blackhat-python3.git
cd blackhat-python3
git sparse-checkout set chapter02 chapter03 # any chapters you want
أو تخطَّ الاستنساخ بالكامل واستخدم صورة Docker.
يتضمن هذا الكود أحصنة طروادة ومسجلات لوحة المفاتيح وأدوات جمع بيانات الاعتماد وتصعيد
الصلاحيات. شغِّله فقط ضد الأنظمة التي تملكها أو لديك إذن كتابي باختبارها. قد تكتشف
برامج مكافحة الفيروسات بعض الملفات، مثل chapter10/bhvulnservice.zip وchapter11/cmeasure.bin
ومسجل لوحة المفاتيح الخاص بالفصل الثامن. هذا أمر متوقع؛ راجع
SECURITY.md.