《Violent Python》(TJ O'Connor著)一书的源代码。该代码已完全转换为Python 3,按照PEP8标准重新格式化,并经过重构以消除涉及已废弃库实现中的依赖问题。
TJ O'Connor 所著 Violent Python: A Cookbook for Hackers, Forensic Analysts, Penetration Testers and Security Engineers(Syngress,2012)的源代码, 已从 Python 2 转换为 Python 3,并经过重构以在当前解释器和库上运行。
这些脚本尽量贴近书中的印刷清单,以便与书籍对照阅读。 转换过程中所做的每一处更改都记录在 docs/CONVERSION_NOTES.md 中。
[!NOTE] Justin Seitz 所著 Black Hat Python 的配套转换版本位于 EONRaider/blackhat-python3。
需要 Python 3.11 或更高版本。从以下设置中选择一种。
uv 会在你尚未安装时
安装正确的 Python 版本,并根据 uv.lock 复现 CI 中测试过的确切依赖版本。
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 或更新版本时,你也可以通过 pip install --group ch04 直接从 pyproject.toml 安装某一章的依赖组。
每个发布版都会发布一个适用于 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 身份运行,因为大多数原始套接字章节都需要它。仅使用上述能力时,容器仍会将这些脚本与主机隔离,因此只需添加章节所需的能力即可。蓝牙(第 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 和编译器,并且已预先授予原始套接字能力。
某些章节会调用外部程序或需要原生库。Docker 镜像和开发容器已包含它们;在主机上请自行安装:
| 所需用途 | 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 文件和 2020 年的 GeoLite2 City 数据库;使用前请用最新下载的数据库替换它(参见 NOTICE)。实时嗅探需要 root / NET_RAW。 |
| 05 | 无线混乱 | ch05、ch05-bluetooth | scapy、pybluez(Linux,可选) | Wi-Fi 脚本需要处于监听模式的网卡。ninja_print.py 需要 ObexFTP 的 Python 2 绑定,而它没有 Python 3 移植版。 |
| 06 | Web 侦察 | ch06 | beautifulsoup4、mechanicalsoup | Google 和 Twitter 脚本针对的 API 已不存在;请参阅转换说明。 |
| 07 | 反病毒规避 | - | - | 仅使用标准库。 |
PyPI 列由 python tools/deps_scan.py report 生成,该命令会读取每个章节中的导入。操作系统和权限说明来自转换说明,可能不完整;欢迎指正。
完整检出约 100 MB,主要是示例数据:chapter04/ 中一个 63 MB 的 GeoLite2 数据库,以及 chapter02/ 中一个 30 MB 的弱 Debian SSH 密钥归档。浅克隆(--depth 1)节省的空间非常有限,因为这些文件属于当前树的一部分。要仅下载你想要的章节:
git clone --filter=blob:none --sparse https://github.com/EONRaider/violent-python3.git
cd violent-python3
git sparse-checkout set chapter01 chapter03 # any chapters you want
或者完全跳过克隆,直接使用 Docker 镜像。
此代码会执行真实攻击:密码破解、SSH 暴力破解、数据包注入、无线和蓝牙漏洞利用。仅可针对你拥有或已获得书面许可进行测试的系统运行。
欢迎提交错误修复、针对较新库的兼容性修复以及文档改进。有关范围、开发工作流程以及发布方式的说明,请参阅 CONTRIBUTING.md。请按照 SECURITY.md 中所述的方式报告安全问题。
turkish-language 分支本代码源自 TJ O'Connor 所著的 Violent Python,由 Elsevier, Inc. 旗下的 Syngress 出版。未授予任何开源许可证;有关这意味着什么以及捆绑的第三方文件条款,请参阅 NOTICE。Python 3 转换由 EONRaider 和贡献者完成。
如果你在学术工作中引用此仓库,GitHub 的 Cite this repository 按钮会使用 CITATION.cff。