Исходный код книги "Black Hat Python" от Джастина Сейтца. Код полностью конвертирован в 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] В 2021 году No Starch Press выпустило второе издание за авторством Джастина Сейтца и Тима Арнольда, изначально написанное для 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-сокетами это необходимо. Контейнер является песочницей, поэтому добавляйте только те возможности, которые нужны главе. Главы для Windows (8–10) в нём работать не могут.
Используйте значок Open in GitHub Codespaces выше или откройте папку в VS Code или JetBrains с расширением Dev Containers. Контейнер (.devcontainer/devcontainer.json) содержит те же инструменты, что и образ Docker, плюс uv, git и компиляторы, и поставляется с уже предоставленными возможностями raw-сокетов.
| Глава | Тема | Группа uv | Пакеты PyPI | Примечания |
|---|---|---|---|---|
| 02 | Сеть: основы | ch02 | paramiko | test_rsa.key — публичный тестовый ключ Paramiko (из его набора тестов), необходимый для bh_sshserver.py. |
| 03 | Raw-сокеты и сниффинг | - | - | Только стандартная библиотека. Требуются права 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, которая читает импорты в каждой главе. Примечания об ОС и привилегиях взяты из примечаний к конвертации и могут быть неполными; исправления приветствуются.
Полная копия репозитория занимает около 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-образ.
Откройте для себя самые используемые инструменты нашего сообщества.
Данных о популярности пока нет.