《Black Hat Python》一书(作者Justin Seitz)的源代码。代码已完全转换为Python 3,按照PEP8标准重新格式化,并重构以消除涉及已弃用库实现的依赖问题。
Justin Seitz 所著 Black Hat Python: Python Programming for Hackers and Pentesters(No Starch Press,2014)第一版的源代码,已从 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 或更新版本时,你也可以直接从 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 身份运行,因为大多数原始套接字章节都需要它。容器本身就是沙箱,因此只需添加章节所需的 capabilities。Windows 章节(8-10)无法在其中运行。
使用上方的 Open in GitHub Codespaces 徽章,或在 VS Code 或 JetBrains 中通过 Dev Containers 扩展打开该文件夹。容器(.devcontainer/devcontainer.json)拥有与 Docker 镜像相同的工具,外加 uv、git 和编译器,并且已预先授予原始套接字 capabilities。
| 章节 | 主题 | 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 | Web 黑客技巧 | - | - | 仅使用标准库。包含词表 all.txt 和 cain.txt。 |
| 06 | 扩展 Burp Proxy | - | - | 在 Jython 2.7 下运行的 Burp Suite 扩展(包含 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 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 镜像。
本代码包含木马、键盘记录器、凭据窃取工具和权限提升工具。请仅在您拥有或已获得书面许可进行测试的系统上运行它。某些文件(例如 chapter10/bhvulnservice.zip、chapter11/cmeasure.bin 以及第 8 章的键盘记录器)可能会被杀毒软件标记。这是预期行为;请参阅 SECURITY.md。
欢迎提交错误修复、针对较新库的兼容性修复以及文档改进。有关范围、开发工作流程以及发布方式的说明,请参阅 CONTRIBUTING.md。请按照 SECURITY.md 中所述的方式报告安全问题。
turkish-language 分支本代码源自 Justin Seitz 所著、由 No Starch Press 出版的 Black Hat Python。未授予任何开源许可证;有关其含义以及随附第三方文件的条款,请参阅 NOTICE。Python 3 转换由 EONRaider 和贡献者完成,其中包括来自 Enraged 的修复。
如果您在学术工作中引用此仓库,GitHub 的 Cite this repository 按钮会使用 CITATION.cff。