Cyberbro是什么?开源IoC威胁情报批量查询工具的完整入门指南

原创2026-11-02 16:31:522,300 阅读

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/ 目录下有逐篇说明。

实际使用:从粘贴到报告

  1. 打开首页,把原始日志、告警文本或一堆 IoC 粘贴进输入框;
  2. 勾选要使用的引擎(或全选),点击分析;
  3. 结果页支持按 IoC 类型、引擎结果过滤,每个 IoC 可展开查看各情报源的详细返回(页面模板见 templates/results.html);
  4. 支持导出 CSV/Excel,导出逻辑位于 utils/export.py;
  5. 历史页可回看所有分析记录,图谱页(graph)实验性地展示 IoC 之间的关联。

API 用法:把 Cyberbro 接入你的自动化流程

Cyberbro 提供三个 REST API 端点,方便脚本化批量查询(详见 docs/quick-start/API-usage-and-engine-names.md):

  • POST /api/analyze — 提交文本,返回 analysis_id
  • GET /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"]}'

此外还有三种生态扩展,可按需使用:

进阶部署与常见问题

生产环境注意事项 🛡️:官方特别提醒,若部署在生产环境,务必配置好反向代理 + WAF 来防范安全风险;Caddy 反向代理配置示例见 docs/integrations/Reverse-Proxy-configuration-‐-Caddy.md。

总结

Cyberbro 是威胁情报入门与日常研判的高性价比选择:开源免费、Docker 一键部署、免费引擎开箱即用、多源并行查询、结果可搜索可导出。如果你想部署一个不复杂的 CTI 查询平台,它就是"简单"与"功能全"之间难得的平衡点。

📚 官方文档首页:docs/index.md;项目简介与完整特性列表:README.md

登录后查看全文
cyberbro