pentest-harness

这是什么？适合谁？

Pentest Harness（S1N6H/pentest-harness）是一个自托管的 AI Agent 渗透测试平台，面向授权渗透测试、漏洞赏金、安全实验室与 CTF 训练场景。

核心价值：把「AI Agent 编排」用于安全测试——Agent 能自主执行侦察、漏洞验证等步骤，同时会话与数据本地化，避免测试数据外泄。自带模型 API 集成，开箱即可驱动 Agent。

适合人群：

• 授权范围内做渗透测试的安全工程师
• 参与漏洞赏金计划的安全研究员
• 搭建安全实验室 / CTF 训练环境的团队

⚠️ 使用边界：本工具只能用于你有明确授权的目标。对未授权目标进行测试属于违法行为，责任自负。

使用前提：安全测试领域知识；对目标的书面授权；自托管运行环境。

准备工作

1. Python / Node 环境：项目用 TypeScript 编写（GitHub API 实测语言）。
2. 授权确认：确保你对测试目标拥有合法书面授权——这是使用前最重要的「准备」。
3. 成本：MIT 开源，完全免费；模型 API 调用按供应商计费。
4. 时间预算：部署 + 接入模型约 20-30 分钟。
5. 心智准备：AI Agent 会自主执行测试动作，需设定好范围与护栏，防止越界。

快速上手（3 步）

第一步：安装

git clone https://github.com/S1N6H/pentest-harness
cd pentest-harness
npm install   # 具体依赖以 README 为准

第二步：配置模型与目标

配置模型 API，并在授权范围内设置测试目标与测试边界。

第三步：启动 Agent 任务

让 Agent 在授权目标上执行侦察 / 漏洞验证任务，观察本地会话记录。

成功判定：Agent 能在授权目标上自主完成一轮侦察并产出结构化发现，会话数据全部保存在本地。

初级用法

典型场景

• 授权渗透：对自有资产做合规测试
• 漏洞赏金：在平台规则内测试授权目标
• 安全实验室：在隔离环境里研究漏洞
• CTF：辅助解题训练

会话本地化

测试会话、发现记录保存在本地，避免敏感数据外泄。

自带模型 API

内置模型 API 集成，无需自己搭模型网关。

高级玩法

设定测试护栏

给 Agent 设定明确的测试范围、禁用动作与速率限制，防止越界或误伤。

结合人工复核

让 Agent 做初筛与自动化步骤，关键发现由安全工程师人工确认，降低误报。

隔离实验室

在完全隔离的网络环境里运行，用于漏洞研究与训练，避免波及真实资产。

小技巧

1. 先拿授权再动手：无授权测试是红线。
2. 限定范围：明确目标 IP/域名范围，防止 Agent 越界扫描。
3. 限速限流：给 Agent 设置请求速率，避免对目标造成影响。
4. 会话留痕：保留完整会话记录，便于审计与复盘。
5. 发现双人复核：AI 的发现必须人工确认后才下结论。

常见踩坑

踩坑 1：对未授权目标测试

• 现象：图方便对第三方资产直接测试。
• 原因：安全意识不足。
• 解决：只测有书面授权的目标，这是法律底线。

踩坑 2：Agent 越界扫描

• 现象：Agent 超出设定范围扫到了范围外资产。
• 原因：未设定测试护栏或护栏不严。
• 解决：明确范围、设置禁用动作与速率限制，必要时用隔离环境。

踩坑 3：AI 误报

• 现象：Agent 报告了大量「漏洞」，实际多为误报。
• 原因：AI 判断漏洞存在性不可靠。
• 解决：所有发现必须人工验证后再确认。

踩坑 4：测试数据未隔离

• 现象：会话记录与其他系统混存。
• 原因：本地化配置不当。
• 解决：用独立环境 + 独立存储，确保测试数据隔离。

踩坑 5：忽略目标方承受能力

• 现象：高频测试导致目标服务异常。
• 原因：未限速限流。
• 解决：设置请求速率，评估目标承受能力后再加压。

常见问题 FAQ

Q1: 我能对任意网站测试吗？

A: 不能。只能对你有书面授权的目标测试；未授权测试违法，后果自负。

Q2: 和传统渗透测试工具（如 Metasploit）什么区别？

A: Metasploit 是成熟框架；Pentest Harness 侧重「AI Agent 编排」，让 Agent 自主执行测试步骤，适合自动化侦察与初筛。

Q3: 免费吗？

A: MIT 开源免费；模型 API 调用按供应商计费。

Q4: 数据会上传吗？

A: 会话本地化设计，测试数据保存在本机；接云端模型时注意模型侧的隐私政策。

Q5: 能用于生产安全测试吗？

A: 可在授权范围内用于辅助测试，但发现必须人工复核，不能直接当结论。

进阶学习建议

掌握基础后，建议深入：

1. 护栏优先：先建立范围、速率、禁用动作三层护栏，再放开 Agent 自主性。
2. 人机协同：Agent 做侦察初筛，人工做漏洞确认与利用，把自动化关进安全边界。
3. 隔离实验室：搭建完全隔离的靶场环境，用于漏洞研究与 CTF 训练。

参考链接

• 官方仓库

最后更新：2026-08-28 · 作者：MagicNetWorld · 基于公开资料整理，关键数据经 GitHub API 独立实测核验，AI 辅助生成