
PentestGPT
让大模型当你的渗透测试副驾驶,自动规划并执行攻击链路
项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 16331
使用教程
环境要求
- Python 环境(依赖由 uv 管理,make install 会执行 uv sync)
- 已安装 git 与 make 命令行工具
- 本地运行时需要能调用 LLM 后端(README 中示例为 claude / codex)
- 如使用 Docker 方式,需要本机已安装 Docker 并可用 make docker-* 目标
- 一个可测试的授权目标地址(示例 10.10.11.234)
安装与启动步骤
-
1克隆项目仓库
把 PentestGPT 源码拉取到本地,README 给出的官方仓库地址如下。
git clone https://github.com/GreyDGL/PentestGPT.git -
2进入项目目录
后续所有 make 命令都需要在项目根目录下执行。
cd PentestGPT -
3安装依赖
make install 实际执行 uv sync,负责创建环境并同步 Python 依赖。
make install -
4本地运行一次测试
使用 pentestgpt 命令对目标发起测试,README 示例默认走 CTF 模式。
pentestgpt --target 10.10.11.234 -
5构建 Docker 镜像
可选方式:镜像内置工具链以及 Claude Code 和 Codex 两个 CLI,装一次即可复用。
make docker-build -
6登录并检查登录状态
docker-login 为一次性且幂等,只登录缺失的部分;登录态保存在命名卷中。
make docker-login make docker-auth-status -
7用 Docker 跑流水线
通过 TARGET / BACKEND / MODEL / MODE 参数选择目标、后端、模型和模式。
make docker-run TARGET=10.10.11.234 BACKEND=claude MODEL=opus MODE=pentest
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
TARGET | 是 | 指定渗透测试目标,可以是 IP 或 URL | 10.10.11.234 |
BACKEND | 否 | 选择底层 LLM 后端,README 示例为 codex 或 claude | codex |
MODEL | 否 | 指定使用的模型名称,随后端不同而不同 | gpt-5.5 |
MODE | 否 | 运行模式,可选 ctf 或 pentest 等阶段化流程 | ctf |
ROUNDTRIP | 否 | docker-auth-status 的开关,置 1 时做一次真实 token 校验 | 1 |
如何确认成功
本地执行 pentestgpt --target 后能看到分阶段流程输出;Docker 方式下 make docker-auth-status 显示 Claude 与 Codex 均已登录。
常见问题
Q:不想在本机装 Python 依赖可以吗?
A:可以。README 提供 Docker 方式:make docker-build 构建镜像,镜像中已打包工具和 Claude Code、Codex 两个 CLI。
Q:Docker 里每次运行都要重新登录吗?
A:不需要。make docker-login 是幂等的,登录会话持久化在命名卷里,容器重建后依然有效。
Q:怎么强制重新登录或更换 token?
A:执行 make docker-nuke 会删除登录卷,从而强制下一次重新登录、轮换凭证;make docker-down 则保留登录态。
Q:如何确认登录真的有效?
A:运行 make docker-auth-status,加上 ROUNDTRIP=1 会做一次真实的 1-token 校验。
Q:支持哪些模型后端?
A:README 示例中演示了 codex 与 claude 两种后端,配合 MODEL 参数切换具体模型。
注意事项
- make install 内部执行的是 uv sync,请先确保 uv 可正常使用。
- Docker 方式中 Codex 的凭据不会被预置,因为 ChatGPT 刷新令牌是一次性的。
- 本项目仅供授权范围内的安全测试与研究使用,请勿对未授权目标执行测试。
核心亮点
- 基于 LLM 的智能任务规划,能自动拆解复杂渗透目标为可执行步骤
- 内置多种渗透测试工具和知识库,支持命令生成与执行,提升效率
- 交互式会话管理,允许用户干预和调整测试策略,兼顾自动化与灵活性
不足之处
- 依赖 LLM 的推理质量,复杂目标下可能产生误判或遗漏
- 文档和社区生态相对薄弱,新手上手需要一定安全基础
适用场景
- 安全团队对内部系统进行自动化渗透测试和漏洞排查
- 红队演练中快速生成攻击路径和验证漏洞利用
- 安全学习者通过 AI 引导实践渗透测试流程
替代项目
AutoGPT、MetaGPT、SecurityGPT
上一篇:Partlawyer-LAA
下一篇:TaxHacker
同类项目推荐
Easydict
开源
Mac 上查词翻译,一键搞定,支持离线 OCR 和多种引擎。
一个简洁优雅的词典翻译 macOS App。开箱即用,支持离线 OCR 识别,支持有道词典, 苹果系···
Awesome-LLMs-meet-genomes
开源
基因组+大模型论文与任务一网打尽,快速找方向。
Explore a comprehensive collection of basic theories, applications, papers, and best···
FenixAI_tradingBot
开源
用本地大模型驱动你的自动交易策略,实现智能决策。
Fenix Ai Trading Bot with LangGraph and ollama and multipe providers
cx-core
开源
用大白话管 Linux,说人话就干活
CX Linux — AI-powered Linux OS. Natural language system administration for Ubuntu &···
PyHealth
开源
统一临床数据与模型,快速跑通医疗 AI 实验
A deep learning toolkit for healthcare AI: EHR (MIMIC, eICU, OMOP), clinical text, s···
InPactAI
开源
用AI给达人营销做数据撮合,帮品牌找对人、帮创作者接对单
Inpact is an open-source AI-powered platform designed to connect content creators, b···
blatant-why
开源
对话式多智能体,自动搞定抗体与蛋白质设计
AI-powered biologics design campaign agent — multi-agent orchestration with BoltzGe···
ai-collection
开源
一张图看遍生成式AI应用,快速找到灵感
The Generative AI Landscape - A Collection of Awesome Generative AI Applications
CyberStrikeAI
开源
让 AI 智能体自动执行渗透测试,安全操作越用越聪明
The system of action for AI-native cybersecurity—where intent becomes governed exec···