Исходный код книги "Violent Python" от TJ O'Connor. Код полностью переведён на Python 3, отформатирован в соответствии со стандартами PEP8 и реорганизован для устранения проблем с зависимостями, связанными с использованием устаревших библиотек.
Исходный код из книги Violent Python: A Cookbook for Hackers, Forensic Analysts, Penetration Testers and Security Engineers автора TJ O'Connor (Syngress, 2012), переведённый с Python 2 на Python 3 и переработанный для работы на современных интерпретаторах и библиотеках.
Скрипты максимально приближены к печатным листингам, чтобы их можно было читать параллельно с книгой. Все изменения, внесённые в ходе конвертации, задокументированы в docs/CONVERSION_NOTES.md.
[!NOTE] Сопутствующая конвертация книги Black Hat Python авторства Justin Seitz доступна по адресу EONRaider/blackhat-python3.
Python 3.11 или новее. Выберите одну из следующих конфигураций.
uv устанавливает нужную
версию Python, если она у вас отсутствует, и воспроизводит точные версии зависимостей,
протестированные в CI, из uv.lock.
git clone https://github.com/EONRaider/violent-python3.git
cd violent-python3
uv sync # every chapter
uv run python chapter04/geo_ip.py -h
Каждая глава — это отдельная группа зависимостей, поэтому вы можете установить только то, что читаете:
uv sync --only-group ch04 # just chapter 4
uv sync --group ch05-bluetooth # add the opt-in Bluetooth extras (Linux)
git clone https://github.com/EONRaider/violent-python3.git
cd violent-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 (и requirements-lock-bluetooth.txt для опциональной группы)
из последнего релиза.
С pip 25.1 или новее вы также можете установить группу главы напрямую из
pyproject.toml с помощью pip install --group ch04.
Каждый релиз публикует
образ для linux/amd64 и linux/arm64 со всеми зависимостями каждой главы, nmap,
tcpdump и предустановленной средой выполнения BlueZ:
docker run --rm -it ghcr.io/eonraider/violent-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/violent-python3
# Or build it yourself:
docker build -t violent-python3 . && docker run --rm -it violent-python3
Образ запускается от имени root, поскольку большинству глав с raw-сокетами это необходимо. Имея только перечисленные выше возможности, контейнер по-прежнему изолирует эти скрипты от хоста, поэтому добавляйте лишь то, что нужно конкретной главе. Bluetooth (глава 5) — другое дело: ему требуется сетевое пространство имён хоста для доступа к адаптеру, например с помощью --net=host --cap-add=NET_RAW --cap-add=NET_ADMIN. Это устраняет сетевую изоляцию, поэтому контейнер сможет видеть весь трафик хоста и воздействовать на него. Избегайте --privileged, который также даёт контейнеру доступ ко всем устройствам хоста.
Используйте значок Open in GitHub Codespaces выше или откройте папку в VS Code или JetBrains с расширением Dev Containers. Контейнер
(.devcontainer/devcontainer.json) содержит те же инструменты,
что и образ Docker, плюс uv, git и компиляторы, и поставляется с уже предоставленными
возможностями raw-сокетов.
Некоторые главы вызывают внешние программы или нуждаются в нативных библиотеках. Образ Docker и dev-контейнер уже включают их; на хосте установите их самостоятельно:
| Для чего нужно | Debian / Ubuntu / Kali | macOS (Homebrew) |
|---|---|---|
chapter02/nmap_scan.py, conficker.py | apt install nmap | brew install nmap |
| Захват пакетов (главы 4-5) | apt install libpcap0.8 tcpdump | встроено |
Группа ch05-bluetooth | apt install libbluetooth-dev | не поддерживается |
| Глава | Тема | Группа uv | Пакеты PyPI | Примечания |
|---|---|---|---|---|
| 01 | Введение | ch01 | standard-crypt (не Windows, Python 3.13+) | crypt был удалён из стандартной библиотеки в 3.13 (PEP 594); бэкпорт сохраняет работоспособность passwd_crack.py. Как и исходный модуль, он оборачивает libc crypt(3), поэтому passwd_crack.py не работает в Windows. |
| 02 | Тестирование на проникновение | ch02 | pexpect, python-nmap | Требуется бинарник nmap. Использует SSH и FTP против контролируемых вами хостов. |
| 03 | Криминалистические исследования | ch03 | beautifulsoup4, pillow, pypdf4, requests | discover_networks.py и dump_recyclebin.py читают реестр Windows и требуют Windows с правами администратора. Включены образцы баз данных Firefox/Skype и PDF-файл. |
| 04 | Анализ сетевого трафика | ch04 | dpkt, geoip2, ipy, scapy | Включены образцы файлов .pcap и база данных GeoLite2 City 2020 года; перед использованием замените базу на актуальную загрузку (см. NOTICE). Живой перехват требует root / NET_RAW. |
| 05 | Беспроводной хаос | ch05, ch05-bluetooth | scapy, pybluez (Linux, по желанию) | Скриптам Wi-Fi нужна карта в режиме мониторинга. ninja_print.py требует привязок ObexFTP для Python 2, у которых нет порта на Python 3. |
| 06 | Веб-разведка | ch06 | beautifulsoup4, mechanicalsoup | Скрипты для Google и Twitter нацелены на API, которых больше не существует; см. заметки о конвертации. |
| 07 | Обход антивирусов | - | - | Только стандартная библиотека. |
Столбец PyPI генерируется командой python tools/deps_scan.py report, которая читает
импорты в каждой главе. Примечания об ОС и привилегиях взяты из заметок о конвертации
и могут быть неполными; исправления приветствуются.
Откройте для себя самые используемые инструменты нашего сообщества.
Данных о популярности пока нет.