dsh-pentester 0.0.1 → 1.0.0

package/docker/kali/README.md

@@ -0,0 +1,104 @@
+# dsh-pentester/kali —— 镜像内工具清单与路径
+
+Kali Linux（rolling）+ 精选渗透测试工具集。Agent 从不指定镜像名：它通过
+`/pentester/tools.json` 发现工具，一切执行经 `container_exec`
+（契约见 `docs/architecture.md`）。
+
+> **给 Agent 的工具使用 Prompt 在镜像内是 `/pentester/PROMPT.md`
+> （仓库源文件为同目录 [`TOOL_PROMPT.md`](TOOL_PROMPT.md)）**；
+> 本文件是给人看的镜像内容清单。
+>
+> **构建说明见 [`../README.md`](../README.md)**（本文件只描述镜像内容）。
+
+> 分类与 `bin/gen-tools-json.sh` 一一对应；`tools.json` 在构建期用 `command -v`
+> 探测生成，**只有真实装进镜像的工具才会出现在目录里**（装漏的不会进）。
+
+## 产品根目录 `/pentester`
+
+| 路径 | 内容 |
+| --- | --- |
+| `/pentester/tools.json` | 工具目录（构建期探测生成；Agent 的唯一发现入口） |
+| `/pentester/bin/` | `tool-list`（分类清单）· `tool-info`（单工具详情）· `gen-tools-json.sh` · `record-traffic.sh` · `entrypoint.sh` · `clone-kb` |
+| `/pentester/tools/bin/` | Go 工具族 + fscan / kscan / defaulthound + jar 包装脚本 + pipx bin（jc / mitmdump） |
+| `/pentester/tools/jars/` | ysoserial / marshalsec / JNDI-Injection-Exploit |
+| `/pentester/tools/pipx/` | pipx 隔离环境 |
+| `/pentester/kb/` | 离线知识库（`--build-arg WITH_KB=1` 时存在） |
+| `/pentester/VERSION` | 镜像版本（构建期写入） |
+| `/pentester/PROMPT.md` | Agent 工具使用 Prompt（TOOL_PROMPT.md 的镜像内副本） |
+
+## 工具分类
+
+### base —— 基础运行时
+
+- `/usr/bin`（apt）：`bash` · `zsh` · `python3` · `pip` · `pipx` · `git` · `curl` · `wget` · `aria2c` · `jq` · `yq` · `ruby` · `perl` · `go`（golang-go）· `java`（default-jre）· `gcc` · `make` · `unzip` · `7z` · `tar` · `openssl` · `file` · `tree` · `gdb` · `tmux` · `screen` · `vim` · `nano` · `less` · `gawk`
+- `/pentester/tools/bin`（Go）：`red-tldr`（Red Team TL;DR）
+
+### cli-extras —— 现代化 CLI 基础件
+
+- `/usr/bin`（apt）：`rg`（ripgrep）· `fd`（fdfind 符号链接 → `/usr/local/bin/fd`）· `xh` · `hurl` · `sd` · `mlr`（miller）
+- `/pentester/tools/bin`（pipx / Go）：`jc`（任意命令输出 → JSON）· `gron`（JSON flatten）
+
+### traffic —— 全流量记录（只记录，不分析）
+
+- `tcpdump`（/usr/bin，apt）；`mitmdump`（mitmproxy，pipx → `/pentester/tools/bin`）
+- 容器启动时 `entrypoint.sh` 自动执行 `record-traffic.sh`（幂等）：pcap → `/workspace/traffic/pcap/`，HTTP(S) 明文流 → `/workspace/traffic/flows.mitm`（mitmproxy :8080）
+
+### network —— 网络 / 诊断（/usr/bin，apt）
+
+`ip`（iproute2）· `ping` · `dig` / `nslookup` / `host`（dnsutils）· `whois` · `traceroute` · `mtr` · `tcpdump` · `tshark` · `nc`（netcat-openbsd）· `ncat` · `socat` · `telnet` · `ssh`（openssh-client）· `proxychains4`（符号链接 → `/usr/local/bin/proxychains`）· `torsocks`
+
+### network-discovery —— 网络发现 / 端口扫描
+
+- `/usr/bin`（apt）：`nmap` · `masscan` · `arp-scan` · `netdiscover`
+- `/pentester/tools/bin`：`naabu`（Go）· `fscan`（预编译）· `kscan`（预编译）
+
+### dns-osint —— DNS / 子域名 / OSINT
+
+- `/usr/bin`（apt）：`dnsrecon` · `dnsenum` · `fierce` · `amass` · `subfinder` · `theHarvester` · `whatweb` · `wafw00f`
+- `/pentester/tools/bin`（Go）：`dnsx` · `fofax`
+
+### web-discovery —— Web 发现 / fuzz / 爬取
+
+- `/usr/bin`（apt）：`ffuf` · `gobuster` · `feroxbuster` · `dirb` · `dirbuster` · `nikto`
+- `/pentester/tools/bin`（Go）：`httpx` · `katana` · `gospider` · `interactsh-client`
+
+### vulnerability —— 漏洞扫描 / 利用辅助
+
+- `/usr/bin`（apt）：`nuclei` · `sqlmap`
+- `/pentester/tools/bin`（Go）：`usql`（通用 SQL 客户端）
+- `/pentester/tools/bin` 包装脚本 + `/pentester/tools/jars/*.jar`：`ysoserial` · `marshalsec` · `jndi-injection-exploit`（Java 反序列化三件套）
+
+### password —— 密码 / 爆破 / 凭据
+
+- `/usr/bin`（apt）：`hydra` · `john` · `medusa` · `crunch` · `hashid` · `hashcat`
+- `/pentester/tools/bin`（预编译）：`defaulthound`（默认口令扫描）
+
+### smb-ad —— SMB / Windows / AD（/usr/bin，apt）
+
+`smbclient` · `enum4linux-ng` · `impacket-*`（psexec / smbexec / secretsdump 等）· `netexec` · `evil-winrm`
+
+### wordlists —— 字典（apt 数据目录）
+
+- `/usr/share/seclists`（seclists 合集）
+- `/usr/share/wordlists/rockyou.txt.gz`（rockyou）
+
+### misc —— 取证 / 逆向 / 响应（/usr/bin，apt）
+
+`exiftool` · `binwalk` · `foremost` · `radare2`（r2）· `responder` · `bettercap`
+
+### knowledge —— 离线知识库（`--build-arg WITH_KB=1` 时存在）
+
+- `/pentester/kb/vulhub`（漏洞环境复现）
+- `/pentester/kb/PayloadsAllTheThings`（payload 大全）
+- `/pentester/kb/awesome-poc`（POC 集）
+- `/pentester/kb/exphub`（漏洞利用脚本）
+- `/pentester/kb/INDEX.txt`（全库文件索引）
+
+## 运行行为
+
+- **ENTRYPOINT** `/pentester/bin/entrypoint.sh`：启动流量记录（幂等）后 `exec CMD`；**CMD** `sleep infinity`，**WORKDIR** `/workspace`。
+- **proxychains 已预配置**：`/etc/proxychains4.conf` 指向本地 mitmproxy :8080 —— `proxychains curl https://example.com` 即可让明文 HTTP(S) 流进入 `/workspace/traffic/flows.mitm`（不强制，避免影响不兼容代理的工具）。
+- **版本**：写入 `/pentester/VERSION`、`DSH_PENTESTER_KALI_VERSION` env 与 OCI label。
+
+> `wordlists` 与 `knowledge` 的 `dir:` 条目是路径提示（path hint），非可执行工具；
+> 会原样出现在 tools.json 中（如 `/usr/share/seclists`、`/pentester/kb`）。

package/docker/kali/REPORT_TEMPLATE.md

@@ -0,0 +1,333 @@
+# {目标名称} 渗透测试报告
+
+**报告编号**: PT-{YYYY}-{MMDD}-{PROJECT}
+**测试目标**: {目标 IP/域名}
+**测试日期**: {开始日期}
+**报告日期**: {报告日期}
+**报告分类**: 机密
+**测试框架**: PTES (Penetration Testing Execution Standard)
+
+---
+
+## 目录
+
+1. [执行摘要](#1-执行摘要)
+2. [测试范围与授权](#2-测试范围与授权)
+3. [测试方法论](#3-测试方法论)
+4. [技术发现详述](#4-技术发现详述)
+5. [攻击链分析](#5-攻击链分析)
+6. [影响评估](#6-影响评估)
+7. [修复优先级建议](#7-修复优先级建议)
+8. [清理记录](#8-清理记录)
+9. [附录](#9-附录)
+
+---
+
+## 1. 执行摘要
+
+### 1.1 测试概述
+
+{一段话概述测试目标、技术栈、端口/服务范围}
+
+### 1.2 核心结论
+
+**整体风险等级: {CRITICAL / HIGH / MEDIUM / LOW}**
+
+{一句话总结最重要的发现}
+
+### 1.3 关键发现
+
+| 严重性 | 漏洞数量 | 关键漏洞 |
+|--------|----------|----------|
+| 🔴 CRITICAL | {N} | {列出 CRITICAL 漏洞名} |
+| 🟡 HIGH | {N} | {列出 HIGH 漏洞名} |
+| 🟠 MEDIUM | {N} | {列出 MEDIUM 漏洞名} |
+| 🟢 LOW | {N} | {列出 LOW 漏洞名} |
+
+### 1.4 业务影响
+
+- {影响点 1}
+- {影响点 2}
+- {影响点 3}
+
+### 1.5 最快攻击路径
+
+```
+{描述最高效的攻击链，从入口到完全控制}
+```
+
+---
+
+## 2. 测试范围与授权
+
+### 2.1 测试范围
+
+| 属性 | 值 |
+|------|-----|
+| **主要目标** | {IP/域名} |
+| **端口范围** | {端口列表} |
+| **应用范围** | {应用描述} |
+| **排除项** | {排除项，无则填"无"} |
+
+### 2.2 交战规则 (Rules of Engagement)
+
+- ✅ {允许的操作}
+- ❌ {禁止的操作}
+- 范围仅限 {范围}
+
+### 2.3 授权
+
+{授权说明}
+
+---
+
+## 3. 测试方法论
+
+本次渗透测试严格遵循 **PTES (Penetration Testing Execution Standard)** 标准，按七个阶段依次执行：
+
+### 3.1 预参与阶段 (Pre-engagement)
+{预参与阶段做了什么}
+
+### 3.2 情报收集 (Intelligence Gathering)
+{情报收集阶段做了什么，使用了哪些工具和技术}
+
+### 3.3 威胁建模 (Threat Modeling)
+{威胁建模阶段做了什么，使用了什么框架}
+
+### 3.4 漏洞分析 (Vulnerability Analysis)
+{漏洞分析阶段做了什么，验证了哪些攻击路径}
+
+### 3.5 利用 (Exploitation)
+{利用阶段做了什么，实现了哪些攻击}
+
+### 3.6 后利用 (Post-exploitation)
+{后利用阶段做了什么，评估了持久化和横向移动}
+
+### 3.7 报告 (Reporting)
+{报告阶段说明}
+
+---
+
+## 4. 技术发现详述
+
+{每个发现一个独立小节，按严重性从高到低排列}
+
+---
+
+### F-001: {漏洞名称}
+
+| 属性 | 值 |
+|------|-----|
+| **严重性** | {🔴 CRITICAL / 🟡 HIGH / 🟠 MEDIUM / 🟢 LOW} |
+| **CVSS 3.1 评分** | **{X.X}** |
+| **CVSS 向量** | `CVSS:3.1/{向量}` |
+| **CWE** | {CWE-XXX: 描述} |
+| **发现阶段** | {阶段名称} |
+| **利用验证** | {阶段名称} |
+
+#### 漏洞描述
+
+{清晰描述漏洞原理}
+
+#### CVSS 向量解析
+
+| 度量 | 值 | 说明 |
+|------|-----|------|
+| AV:N | {值} | {说明} |
+| AC:L | {值} | {说明} |
+| PR:N | {值} | {说明} |
+| UI:N | {值} | {说明} |
+| S:C | {值} | {说明} |
+| C:H | {值} | {说明} |
+| I:H | {值} | {说明} |
+| A:H | {值} | {说明} |
+
+#### 复现步骤
+
+{详细复现步骤，包含具体命令和参数}
+
+#### 影响
+
+- {影响点 1}
+- {影响点 2}
+- {影响点 3}
+
+#### 证据
+
+- {证据文件路径 1}
+- {证据文件路径 2}
+
+#### 修复建议
+
+1. {修复建议 1}
+2. {修复建议 2}
+3. {修复建议 3}
+
+---
+
+### F-002: {漏洞名称}
+
+{同上结构}
+
+---
+
+{继续添加更多发现...}
+
+---
+
+## 5. 攻击链分析
+
+### 5.1 最快攻击路径
+
+```
+{描述最高效攻击路径}
+```
+
+### 5.2 完整攻击链
+
+```
+{描述完整攻击链，分阶段展示}
+```
+
+### 5.3 攻击链组合
+
+{使用 mermaid 流程图描绘攻击链组合}
+
+```mermaid
+flowchart LR
+    A[匿名攻击者] --> B{选择入口}
+    B -->|路径 A| C[入口A]
+    B -->|路径 B| D[入口B]
+    C --> E[权限]
+    D --> E
+    E --> F[目标]
+```
+
+---
+
+## 6. 影响评估
+
+### 6.1 数据泄露统计
+
+| 数据类型 | 数量 | 敏感度 | 详情 |
+|----------|------|--------|------|
+| {数据类型} | {数量} | {🔴 高 / 🟡 中 / 🟢 低} | {详情} |
+
+### 6.2 泄露的 PII 详情
+
+| 用户 | 邮箱 | 手机号 | 收货地址 |
+|------|------|--------|----------|
+| {用户名} | {邮箱} | {手机号} | {地址} |
+
+### 6.3 CIA 三元组评估
+
+| 维度 | 等级 | 说明 |
+|------|------|------|
+| **机密性** (Confidentiality) | {等级} | {说明} |
+| **完整性** (Integrity) | {等级} | {说明} |
+| **可用性** (Availability) | {等级} | {说明} |
+
+### 6.4 合规风险
+
+- {合规风险 1}
+- {合规风险 2}
+
+### 6.5 持久化评估
+
+| 持久化方式 | 可行性 | 隐蔽性 | 持久性 | 说明 |
+|-----------|--------|--------|--------|------|
+| {方式} | {✅/❌} | {高/中/低} | {高/中/低} | {说明} |
+
+### 6.6 横向移动
+
+{横向移动评估}
+
+---
+
+## 7. 修复优先级建议
+
+### 7.1 P0 — 立即修复（24 小时内）
+
+| # | 修复项 | 关联漏洞 | 修复方法 |
+|---|--------|---------|---------|
+| 1 | **{修复项}** | {漏洞ID} | {具体修复方法} |
+
+### 7.2 P1 — 尽快修复（1 周内）
+
+| # | 修复项 | 关联漏洞 | 修复方法 |
+|---|--------|---------|---------|
+
+### 7.3 P2 — 计划修复（1 月内）
+
+| # | 修复项 | 关联漏洞 | 修复方法 |
+|---|--------|---------|---------|
+
+---
+
+## 8. 清理记录
+
+### 8.1 已完成的清理
+
+| 操作 | 目标 | 状态 |
+|------|------|------|
+| {操作} | {目标} | ✅ |
+
+### 8.2 无法清理的项目
+
+| 项目 | 数量 | 原因 |
+|------|------|------|
+| {项目} | {数量} | {原因} |
+
+### 8.3 建议的后续清理
+
+1. {建议 1}
+2. {建议 2}
+
+---
+
+## 9. 附录
+
+### 9.1 技术栈总览
+
+```
+{技术栈架构图}
+```
+
+### 9.2 API 端点汇总
+
+**公开端点** ({N} 个):
+{列出公开端点}
+
+**需认证端点** ({N} 个):
+{列出需认证端点}
+
+**管理员端点** ({N} 个):
+{列出管理员端点}
+
+### 9.3 漏洞汇总表
+
+| ID | 漏洞名称 | 严重性 | CVSS | CWE | 阶段 |
+|----|---------|--------|------|-----|------|
+| F-001 | {名称} | {严重性} | {CVSS} | {CWE} | {阶段} |
+
+### 9.4 交付物路径
+
+| 阶段 | 路径 |
+|------|------|
+| 预参与 | `/workspace/stages/01-pre-engagement/summary.md` |
+| 情报收集 | `/workspace/stages/02-intelligence-gathering/` |
+| 威胁建模 | `/workspace/stages/03-threat-modeling/` |
+| 漏洞分析 | `/workspace/stages/04-vulnerability-analysis/` |
+| 利用 | `/workspace/stages/05-exploitation/` |
+| 后利用 | `/workspace/stages/06-post-exploitation/` |
+| 报告 | `/workspace/report/report.md` |
+
+### 9.5 测试账号
+
+{列出测试期间创建的账号，建议后续清理}
+
+---
+
+**报告结束**
+
+*本报告为 {目标名称} 渗透测试的最终交付物，包含全部确认漏洞的详细分析、攻击链演示、影响评估和修复建议。报告仅供授权人员查阅，请勿外传。*