
जस्टिन सीट्ज़ द्वारा लिखित पुस्तक "Black Hat Python" का स्रोत कोड। कोड को पूरी तरह से Python 3 में परिवर्तित कर दिया गया है, PEP8 मानकों के अनुरूप पुनः स्वरूपित किया गया है, और पुरानी लाइब्रेरियों के कार्यान्वयन से संबंधित निर्भरता समस्याओं को समाप्त करने के लिए रिफैक्टर किया गया है।
Justin Seitz (No Starch Press, 2014) द्वारा लिखित Black Hat Python: Python Programming for Hackers and Pentesters के पहले संस्करण का स्रोत कोड, जिसे Python 2 से Python 3 में परिवर्तित किया गया है और वर्तमान इंटरप्रेटरों और लाइब्रेरीज़ पर चलाने के लिए पुनर्गठित किया गया है।
स्क्रिप्ट्स मुद्रित लिस्टिंग के करीब रहती हैं ताकि उन्हें पुस्तक के साथ-साथ पढ़ा जा सके। परिवर्तन के दौरान किए गए प्रत्येक बदलाव का दस्तावेज़ीकरण docs/CONVERSION_NOTES.md में किया गया है।
[!NOTE] No Starch Press ने 2021 में Justin Seitz और Tim Arnold द्वारा एक दूसरा संस्करण प्रकाशित किया, जो शुरू से ही Python 3 के लिए लिखा गया था। यह रिपॉज़िटरी पहले संस्करण का अनुसरण करती है। यदि आपके पास दूसरा संस्करण है, तो इसके बजाय प्रकाशक के कोड का उपयोग करें।
TJ O'Connor द्वारा लिखित Violent Python का एक सहयोगी रूपांतरण EONRaider/violent-python3 पर उपलब्ध है।
Python 3.11 या नया। निम्नलिखित सेटअप में से एक चुनें।
uv यदि आपके पास सही
Python संस्करण नहीं है तो उसे इंस्टॉल करता है और uv.lock से CI में परीक्षित सटीक
निर्भरता संस्करणों को पुनः उत्पन्न करता है।
git clone https://github.com/EONRaider/blackhat-python3.git
cd blackhat-python3
uv sync # every chapter
uv run python chapter02/bhnet.py -h
प्रत्येक अध्याय एक अलग dependency group है, इसलिए आप केवल वही इंस्टॉल कर सकते हैं जो आप पढ़ रहे हैं:
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 या नए संस्करण के साथ, आप pip install --group ch04 द्वारा सीधे
pyproject.toml से किसी अध्याय का समूह भी इंस्टॉल कर सकते हैं।
प्रत्येक रिलीज़ 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-socket अध्यायों को इसकी आवश्यकता होती है। कंटेनर ही सैंडबॉक्स है, इसलिए केवल वही क्षमताएँ जोड़ें जिनकी किसी अध्याय को आवश्यकता हो। Windows अध्याय (8-10) इसमें नहीं चल सकते।
ऊपर दिए गए Open in GitHub Codespaces बैज का उपयोग करें, या VS Code या JetBrains में Dev Containers एक्सटेंशन के साथ फ़ोल्डर खोलें। कंटेनर (.devcontainer/devcontainer.json) में Docker इमेज के समान टूल्स हैं, साथ ही uv, git और कंपाइलर भी हैं, और इसमें raw-socket क्षमताएँ पहले से ही प्रदान की गई हैं।
| अध्याय | विषय | uv समूह | PyPI पैकेज | नोट्स |
|---|---|---|---|---|
| 02 | नेटवर्क: मूल बातें | ch02 | paramiko | test_rsa.key Paramiko की सार्वजनिक परीक्षण कुंजी है (इसके परीक्षण सूट से), जिसकी आवश्यकता bh_sshserver.py को है। |
| 03 | Raw sockets और स्निफ़िंग | - | - | केवल मानक लाइब्रेरी। 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 से इंस्टॉल नहीं होता। |
पुस्तक का अध्याय 1 पर्यावरण सेटअप को कवर करता है और इसमें कोई कोड नहीं है। PyPI कॉलम python tools/deps_scan.py report द्वारा उत्पन्न होता है, जो प्रत्येक अध्याय में आयातों को पढ़ता है। OS और विशेषाधिकार नोट्स कन्वर्ज़न नोट्स से आते हैं और अपूर्ण हो सकते हैं; सुधारों का स्वागत है।
पूर्ण चेकआउट लगभग 46 MB और 51 MB इतिहास है। अधिकांश ट्री chapter06/ में 43 MB की Jython JAR है, इसलिए शैलो क्लोन (--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 इमेज का उपयोग करें।