flamingo

Flamingo 🦩

Flamingo 是一个基于 Headless Chrome 的开源浏览器爬虫工具，用于收集 HTTP 请求对象。收集到的请求对象可以提供给漏洞扫描器，以帮助检测网站 Web 漏洞。

⚠️ 重要提示：安装使用之前，请务必阅读并同意 免责声明 中的条款，否则请勿安装使用本工具。

✨ 特性

• 🌐 驱动 Headless Chrome，构建原生浏览器爬虫
• 🔗 遍历 DOM 节点，获取页面中静态链接，包括注释中的链接
• 🎯 使用 Hook 技术收集 DOM 0级和 DOM 2级事件，并自动化触发
• 👀 监控 DOM 变化，发现动态产生的链接
• 📝 遍历表单节点，自动化填充和提交表单

📦 安装

环境要求

• Go 1.25 或更高版本
• Chrome / Chromium 浏览器

从源码编译

# 克隆仓库
git clone https://github.com/phplaber/flamingo.git
cd flamingo

# 编译所有平台
make build_all

编译完成后，二进制文件将生成在 bin/ 目录下：

bin/
├── darwin-amd64/flamingo    # macOS
├── linux-amd64/flamingo     # Linux
└── windows-amd64/flamingo   # Windows

在 Linux 或 macOS 平台上运行，请确保二进制程序具有可执行权限：

chmod +x ./bin/darwin-amd64/flamingo

🚀 使用方法

前置准备

使用 Flamingo 前，请先下载 Chromium 可执行程序，并通过 -chromium_path 参数指定路径。

💡 在已安装 Chrome 的系统上，如果不指定路径，程序将自动从默认安装路径查找并启动 Chrome。

基本用法

./bin/darwin-amd64/flamingo -url http://testphp.vulnweb.com/

命令行参数

./bin/darwin-amd64/flamingo -h

示例

# 基本爬取
./bin/darwin-amd64/flamingo -url https://example.com/

# 带 Cookie 认证
./bin/darwin-amd64/flamingo -url https://example.com/ -cookie "session=abc123"

# 使用图形界面模式调试
./bin/darwin-amd64/flamingo -url https://example.com/ -gui

# 指定 Chromium 路径并增加并发
./bin/darwin-amd64/flamingo -url https://example.com/ \
  -chromium_path /path/to/chromium \
  -tab_concurrent_quantity 5

📸 运行截图

📄 输出格式

爬取完成后，结果将保存到 JSON 文件（默认 requests.json），包含收集到的所有 HTTP 请求对象。

📜 开源许可

本项目基于 GPL-2.0 许可证开源。

🙏 致谢

• chromedp - Go 语言的 Chrome DevTools Protocol 客户端
• goquery - Go 语言的 HTML 解析库