Cyberbro是什么?开源IoC威胁情报批量查询工具的完整入门指南
Cyberbro是什么?开源IoC威胁情报批量查询工具的完整入门指南
Cyberbro 是一款开源的 IoC 威胁情报批量查询工具:你只需把一段"杂乱"的原始日志或文本直接粘贴进去,它就能自动从中提取出 IP、域名、URL、文件哈希等 IoC(失陷指标),并调用 VirusTotal、Shodan、AbuseIPDB 等数十个 CTI 服务并行查询它们的信誉,最后生成可搜索、可导出 CSV/Excel 的分析报告。对新手来说,它是"轻量级、免复杂部署"的威胁情报入门利器 🚀。
30秒了解Cyberbro:它解决什么问题?
安全分析师日常最繁琐的工作之一,就是把从邮件、告警、日志里收集到的一个个 IP 和域名,挨个贴进不同的威胁情报网站查询。Cyberbro 把这件事自动化了:
| 传统做法 | 使用 Cyberbro |
|---|---|
| 手动复制每个 IoC | 粘贴整段"垃圾文本",自动解析提取 |
| 挨个登录不同网站查询 | 一次查询并行调用多个情报源 |
| 手动记录结果 | 结果入库(SQLite),支持搜索、过滤、导出 |
| 部署复杂平台 | 一条 docker compose up 即可运行 |
一句话概括:输入是"乱糟糟的文本",输出是"结构化的威胁情报报告"。
核心功能清单:Cyberbro 能做什么?
Cyberbro 的核心功能覆盖了威胁情报研判的主要环节:
- Easy Input(易输入):粘贴原始日志或 IoC,自动解析提取,支持精确的根域名识别(TLD 提取)
- Multi-Service Checks(多服务查询):对 IP、哈希、域名、URL、Chrome 扩展 ID 批量查询信誉
- Comprehensive Reports(综合报告):高级搜索、筛选,一键导出 CSV/Excel
- Fast Processing(快速处理):基于多线程并发分析,每个可观测对象独立开线程(见 utils/analysis.py)
- Automated Pivoting(自动透视):通过 reverse DNS 和 RDAP/Whois 自动发现关联的域名、URL、IP
- History & Graphs(历史与图谱):分析历史记录 + 实验性图谱视图
- Integrations(安全工具集成):对接 Microsoft Defender for Endpoint、CrowdStrike、OpenCTI、MISP 等,可直接比对你自家 EDR 中的记录
- Cache(缓存加速):重复查询走缓存,默认缓存 24 小时
💡 没有 API Key 也能用:Cyberbro 内置多个免费、免密钥的引擎(如
urlscan、rdap_whois、reverse_dns、crtsh、phishtank、shodan的免费版等),空着.env也能跑起来。
支持的 IoC 类型:一次粘贴全都能查
Cyberbro 会自动识别以下类型的可观测对象(Observable):
| 类型 | 示例 | 典型用途 |
|---|---|---|
| IP 地址 | 203.0.113.42 |
恶意 IP 信誉、VPN/代理识别 |
| 域名 / FQDN | example.com |
域名信誉、证书子域名挖掘 |
| URL | http://bad.example/x.php |
钓鱼站点识别 |
| 文件哈希 | a1b2c3...(MD5/SHA1/SHA256) |
恶意文件检测 |
| 邮箱地址 | user@domain.com |
钓鱼发件人分析、Microsoft 租户检测 |
| Chrome 扩展 ID | nfcfigpa... |
恶意浏览器扩展排查(社区少见的功能) |
快速部署:Docker 一键安装步骤
部署是 Cyberbro 上手最快的部分,官方文档称之为"懒人路线"(详见 docs/quick-start/Quick-start-&-Installation.md):
第 1 步:克隆仓库
git clone https://gitcode.com/gh_mirrors/cy/cyberbro
cd cyberbro
第 2 步:创建配置文件
cp .env.sample .env
然后把你的 API Key 填进 .env(可选,留空则只启用免费引擎)。⚠️ 注意:.env 包含敏感密钥,切勿提交到 Git;生产环境建议使用 SOPS、Vault 等密钥管理方案。
第 3 步:启动应用
docker compose up # 加 -d 后台运行,加 --build 重新构建镜像
第 4 步:打开浏览器访问
浏览器访问 http://127.0.0.1:5000 即可开始使用。
⚠️ 小提示:请确认你安装的是
docker compose(compose 插件)而不是旧版的docker-compose。部署的端口映射与全部环境变量定义在 docker-compose.yml 中,镜像构建细节见 Dockerfile。
如果没有 Docker,也可以"传统方式"运行:pip install -r requirements.txt 安装依赖后,用 gunicorn -c prod/gunicorn.conf.py app:app 以生产模式启动,或直接 python3 app.py 开发模式运行(入口为 app.py)。
引擎全景:Cyberbro 接入了哪些威胁情报源?
所有查询引擎位于 engines/ 目录,采用插件式设计:每个引擎是一个独立 Python 文件,通过 utils/load_engines.py 在启动时统一加载。部分代表性引擎:
| 引擎 | 名称 | 查询对象 | 密钥要求 |
|---|---|---|---|
| VirusTotal | virustotal |
IP/域名/URL/哈希 | 免费 Key |
| Shodan | shodan |
IP、开放端口 | 免费 Key |
| AbuseIPDB | abuseipdb |
IP 滥用评分 | 免费 Key |
| Alienvault OTX | alienvault |
IP/域名/URL/哈希 | 免费 Key |
| urlscan | urlscan |
IP/域名/URL/哈希 | 免费,无需 Key |
| crt.sh | crtsh |
域名(证书子域名挖掘) | 免费,无需 Key |
| RDAP / Whois | rdap_whois |
域名注册与滥用联系方式 | 免费,无需 Key |
| Bad ASN Check | bad_asn |
IP 所属 ASN 恶意风险 | 免费,无需 Key |
| Phishtank | phishtank |
钓鱼域名/URL | 免费,无需 Key |
| CrowdStrike Falcon | crowdstrike |
IP/域名/URL/哈希 | 付费 |
| MDE | mde |
IP/域名/URL/哈希(自家 EDR 比对) | 付费(Azure) |
| OpenCTI | opencti |
IP/域名/URL/哈希 | 需要 Key |
完整清单(含每个引擎的说明)见 docs/quick-start/API-usage-and-engine-names.md。各服务的 API Key 申请教程在 docs/api-keys/ 目录下有逐篇说明。
实际使用:从粘贴到报告
- 打开首页,把原始日志、告警文本或一堆 IoC 粘贴进输入框;
- 勾选要使用的引擎(或全选),点击分析;
- 结果页支持按 IoC 类型、引擎结果过滤,每个 IoC 可展开查看各情报源的详细返回(页面模板见 templates/results.html);
- 支持导出 CSV/Excel,导出逻辑位于 utils/export.py;
- 历史页可回看所有分析记录,图谱页(graph)实验性地展示 IoC 之间的关联。
API 用法:把 Cyberbro 接入你的自动化流程
Cyberbro 提供三个 REST API 端点,方便脚本化批量查询(详见 docs/quick-start/API-usage-and-engine-names.md):
POST /api/analyze— 提交文本,返回analysis_idGET /api/is_analysis_complete/<analysis_id>— 轮询分析是否完成GET /api/results/<analysis_id>— 获取结果(JSON)
示例:
curl -X POST "http://localhost:5000/api/analyze" \
-H "Content-Type: application/json" \
-d '{"text": "cyberbro.net", "engines": ["reverse_dns", "rdap_whois"]}'
此外还有三种生态扩展,可按需使用:
- 浏览器扩展(Cyberbro Analyzer):网页上选中 IoC 一键查询,见 docs/integrations/Cyberbro-browser-extension.md
- Cyberbro CLI:命令行批量提交、支持从文件读取 IoC,见 docs/integrations/Cyberbro-CLI.md
- MCP 集成:通过 Model Context Protocol 让 LLM 直接调用 Cyberbro 生成定制报告,见 docs/integrations/Use-Cyberbro-MCP-for-LLM.md
进阶部署与常见问题
- 高级部署选项(自定义 API 前缀、可见引擎、gunicorn/supervisord 调优):docs/quick-start/Advanced-options-for-deployment.md
- 热更新密钥与配置(免重启):docs/quick-start/Reload-secrets-and-configuration.md
- 版本升级流程:docs/quick-start/Upgrade-Cyberbro.md
- 常见问题排查:docs/troubleshooting/Common-Issues.md
- 旧版本使用
secrets.json配置的用户,可用 scripts/secrets_json_to_env.py 一键转换为.env格式(v0.13.0 起不再支持旧格式)
生产环境注意事项 🛡️:官方特别提醒,若部署在生产环境,务必配置好反向代理 + WAF 来防范安全风险;Caddy 反向代理配置示例见 docs/integrations/Reverse-Proxy-configuration-‐-Caddy.md。
总结
Cyberbro 是威胁情报入门与日常研判的高性价比选择:开源免费、Docker 一键部署、免费引擎开箱即用、多源并行查询、结果可搜索可导出。如果你想部署一个不复杂的 CTI 查询平台,它就是"简单"与"功能全"之间难得的平衡点。
📚 官方文档首页:docs/index.md;项目简介与完整特性列表:README.md