leonjza/gowitness

gowitness

镜像概述和主要用途

gowitness 是一款基于Golang开发的网页截图工具，通过Chrome Headless技术实现网页界面截图功能。支持通过命令行操作生成截图，并提供便捷的报告查看器处理结果。该工具兼容Linux和macOS系统，Windows系统也基本可用。其设计灵感来源于 https://github.com/ChrisTruncer/EyeWitness%EF%BC%8C%E8%8B%A5%E9%9C%80%E6%9B%B4%E5%A4%9A%E6%89%A9%E5%B1%95%E5%8A%9F%E8%83%BD%EF%BC%8C%E5%8F%AF%E5%8F%82%E8%80%83 https://github.com/afxdub/http-screenshot-html 和 https://github.com/breenmachine/httpscreenshot 等相关项目。

核心功能和特性

• 基于Chrome Headless：利用Chrome Headless技术，确保网页渲染效果准确，支持复杂页面截图
• 命令行操作：完全通过命令行完成截图配置与执行，适合自动化脚本集成
• 报告查看器：内置结果处理工具，可直观查看和管理截图报告
• 跨平台支持：兼容Linux、macOS系统，Windows系统基本功能可用
• 轻量高效：基于Golang开发，资源占用低，运行效率高

使用场景和适用范围

• 安全测试：批量截图目标网站，辅助安全评估与漏洞验证
• 网站监控：定期捕获网页状态，监控页面变更或可用性
• 报告生成：为渗透测试、合规审计等场景生成网页可视化报告
• 自动化工作流：集成到CI/CD或脚本中，实现网页截图自动化

使用方法和配置说明

基本使用示例（Docker Run）

通过Docker容器运行gowitness进行单页面截图：

bash
# 本地目录挂载至容器，保存截图结果
docker run --rm -v $(pwd)/screenshots:/screenshots leonjza/gowitness single \
  --url https://example.com \  # 指定目标URL
  --output /screenshots        # 截图输出目录（容器内路径，需映射本地目录）

批量截图示例

对多个URL进行批量截图（需准备包含URL列表的文件urls.txt）：

bash
docker run --rm -v $(pwd):/data leonjza/gowitness file \
  --file /data/urls.txt \      # 包含目标URL的文件（容器内路径）
  --output /data/screenshots   # 输出目录（映射本地目录）

报告生成

截图完成后，可通过报告查看器查看结果：

bash
docker run --rm -v $(pwd)/screenshots:/screenshots -p 8080:8080 leonjza/gowitness report \
  --serve \                    # 启动Web服务
  --port 8080 \                # 服务端口
  --database /screenshots/gowitness.db  # 数据库文件路径（需与截图目录一致）

访问 http://localhost:8080 即可查看截图报告。

更多配置

详细的安装指南和参数说明，请参考项目Wiki：https://github.com/sensepost/gowitness/wiki

许可证

gowitness 采用 GNU General Public v3 License 许可证。超出本许可证范围的权限，可通过 <[***]> 联系获取。