x-glacier/kali-pentest / kali-pentest-zh
kali-pentest-zh
Flagged通过 SSH 或 Docker 使用 Kali Linux CLI 工具执行授权渗透测试。 覆盖:信息收集、漏洞分析、嗅探与欺骗、Web/API 渗透、漏洞利用、密码攻击、无线、云原生安全、RFID/NFC、VoIP/ICS、逆向工程、取证分析、后渗透/C2、报告生成。
references/information-gathering/tools/gowitness.md
View on GitHub# gowitness
- **Category**: Information Gathering / Web Service Screenshots
- **Risk Level**: 🟢 Low
---
## 描述
高速 Web 截图工具,使用 Chrome/Chromium 无头浏览器对大量 URL 批量截图并生成可搜索的 HTML 报告。比 eyewitness 速度更快,适合大规模 Web 资产记录和报告生成。
## 安装
```bash
sudo apt install gowitness
# 或通过 Go 安装:
go install github.com/sensepost/gowitness@latest
```
> 当前 Kali 中附带的版本为 **v3.x**,采用 `scan`/`report` 子命令结构,与 v2.x 有显著差异。下方所有示例均针对 **v3**(已安装版本)编写;v2 等效命令以注释形式作为遗留说明给出。
## 参数说明
### 命令结构(v3)
| 参数 | 说明 |
|------|------|
| `scan single -u <url>` | 对单个 URL 截图 |
| `scan file -f <file>` | 对文件中的 URL 截图(使用 `-f -` 从 stdin 读取) |
| `scan cidr -c <cidr>` | 对 CIDR 范围内的主机截图 |
| `scan nmap -f <xml>` | 对 Nmap XML 文件中的 Web 服务截图 |
| `scan nessus -f <xml>` | 从 Nessus XML 文件截图 |
| `report server` | 启动 Web UI 以浏览结果 |
| `report generate` | 生成静态 HTML 报告 |
| `report list` | 打印已存储结果的摘要 |
| `report migrate` | 将 v2 SQLite 数据库迁移到 v3 |
| `version` | 打印 gowitness 版本 |
### 常用 scan 标志(v3)
| 参数 | 说明 |
|------|------|
| `-t, --threads <n>` | 并发线程数(默认 6) |
| `-T, --timeout <s>` | 页面加载超时秒数(默认 60) |
| `-s, --screenshot-path <dir>` | 截图存储位置(默认 `./screenshots`) |
| `--chrome-proxy <proto://host:port>` | Chrome 的 HTTP/SOCKS5 代理 |
| `--chrome-path <path>` | 指定 Chrome/Chromium 二进制路径 |
| `--delay <s>` | 导航后截图前等待的秒数(默认 3) |
| `--write-db` | **将结果保存到 SQLite**(报告服务器显示数据所必需) |
| `--write-db-uri <uri>` | 数据库 URI(sqlite/mysql/postgres;默认 `sqlite://gowitness.sqlite3`) |
| `--write-jsonl` / `--write-csv` | 将结果保存为 JSON lines / CSV |
> **关键(v3 行为变更):** 默认情况下 v3 **仅保存截图**,不保存元数据。要使用 `report server`/`report generate`,扫描时必须添加 `--write-*` 标志之一(通常为 `--write-db`),否则报告将为空。
## 常用命令
```bash
# 单个 URL 截图(v3)
gowitness scan single -u http://target.com --write-db
# v2.x 遗留:gowitness single http://target.com
# 从文件批量截图 URL(v3)——将元数据保存到 SQLite 以便报告可用
gowitness scan file -f urls.txt --write-db
# v2.x 遗留:gowitness file -f urls.txt
# 从 stdin 批量截图 URL
cat urls.txt | gowitness scan file -f - --write-db
# 自定义截图输出目录
gowitness scan file -f urls.txt -s /tmp/screenshots/ --write-db
# 扫描 CIDR 范围(内网)
gowitness scan cidr -c 192.168.1.0/24 --write-db
# v2.x 遗留:gowitness scan --cidr 192.168.1.0/24
# 对 Nmap XML 文件中的 Web 服务截图
gowitness scan nmap -f /tmp/nmap_scan.xml --write-db
# v2.x 遗留:gowitness nmap -f /tmp/nmap_scan.xml
# 启动报告 Web UI 以浏览结果(v3)
gowitness report server --host 127.0.0.1 --port 7171 --db-uri sqlite://gowitness.sqlite3
# v2.x 遗留:gowitness report serve --address 127.0.0.1:7171
# 访问 http://127.0.0.1:7171
# 生成静态 HTML 报告而非运行服务器
gowitness report generate --db-uri sqlite://gowitness.sqlite3
# 并发数(v3 默认 6 个线程)
gowitness scan file -f urls.txt --threads 20 --write-db
# 页面加载超时(v3 使用 -T/--timeout,单位秒)
gowitness scan file -f urls.txt -T 15 --write-db
# 使用代理(v3 使用 --chrome-proxy;v2 使用 --proxy)
gowitness scan file -f urls.txt --chrome-proxy http://127.0.0.1:8080 --write-db
```
## 注意事项
1. gowitness v3 对所有子命令进行了重组——`scan single`、`scan file`、`scan cidr`、`scan nmap` 是 v2 顶层命令的 v3 等效形式。浏览/报告功能已移至 `report server`/`report generate`。
2. 生成的报告(通过 `report server`)支持按 HTTP 状态码、标题和技术栈过滤——非常适合对大型资产列表进行快速分类。
3. 使用 `--threads 20` 或更高值加速批量扫描;v3 默认仅 6 个线程。
4. 配合 nmap XML 输出(`gowitness scan nmap -f scan.xml --write-db`)可自动对端口扫描发现的所有 Web 服务截图。
5. **v3 默认不保存元数据**——扫描时务必添加 `--write-db`(或 `--write-jsonl`/`--write-csv`),然后让 `report server --db-uri` 指向同一个 SQLite 文件。若不加 `--write-db`,则仅生成 PNG 截图,报告 UI 将为空。
6. 从 v2 迁移?使用 `gowitness report migrate` 将现有 v2 SQLite 数据库升级到 v3 schema。
---
## 官方参考
- [gowitness(GitHub)](https://github.com/sensepost/gowitness)
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |