BigBodyCobain/Shadowbroker

项目介绍

ShadowBroker 是一个自托管的开源情报仪表盘，把 60 多个公开数据源汇聚到一张 MapLibre 地图上：商业、私人及军用飞机，AIS 船舶，卫星轨道，冲突事件，交通摄像头，地震、山火、互联网中断，以及 Shodan 设备检索。在地图上右键任意位置，会弹出国家档案和最新 Sentinel-2 影像。

前端是 Next.js + MapLibre GL，后端是 FastAPI。可选能力包括 IP/DNS/WHOIS/制裁名单/BGP 的侦察工具包、供外部 AI Agent 调用的 HMAC 签名命令通道（参考实现为 openclaw-skills/shadowbroker/ 里的 OpenClaw skill）、快照回放，以及实验性的 InfoNet 混淆通信网。README 明确说明该网络是测试网、不保证隐私，且部分隐私原语尚未接通。

快速使用

推荐用 Docker 运行。克隆仓库后直接起预构建镜像：

git clone https://github.com/BigBodyCobain/Shadowbroker.git
cd Shadowbroker
docker compose pull
docker compose up -d

然后打开 http://localhost:3000（需要 Docker Desktop 或 Docker Engine）。API Key 写在仓库根目录的 .env 里。OpenSky 的 OAuth2 凭据被标为航班数据的必需项，船舶图层需要 aisstream.io 的 AIS_API_KEY，Shodan、Sentinel Hub、LTA 的 Key 为可选。不想用 Docker 的话，可以从 Releases 页面下载 zip，在 Windows 上双击 start.bat，在 macOS/Linux 上执行 chmod +x start.sh 和 ./start.sh。

开发模式：Python 3.10–3.12（3.13+ 可能有依赖兼容问题）、Node 18+，先 cd backend && python -m venv venv && pip install . 并填好 backend/.env，再 cd ../frontend && npm ci，在 frontend 目录运行 npm run dev 同时启动前后端。

使用约束

• 自托管意味着会向你启用的每个公开数据源发起外联请求；部分源无需 Key，但 OpenSky 与 aisstream.io 需要免费账号，数据使用仍受各提供方条款约束。
• 把仪表盘暴露到本机之外需谨慎。局域网模式（BIND=0.0.0.0 配合 SHADOWBROKER_LAN_MODE=1）必须设置强 ADMIN_KEY；只绑 0.0.0.0 而不开该模式，任何能访问 3000 端口的人都拿到完整操作员权限。后端开发服务器默认只监听回环地址。
• InfoNet 通信网、Dead Drop 私信和 Sovereign Shell 治理均属实验性：射频通道公开，门聊对持有门密钥的人可读，README 明确要求不要在其中传输敏感内容。
• 项目采用 AGPL-3.0，README 定位为教育与个人研究用途；航母位置是基于公开报道的估算，并非确认坐标。

HotRepo 点评

项目 2026 年 3 月创建，首次 Show HN 获得 312 分、123 条评论，讨论集中在用瓦片还是直接传 GeoJSON，也有评论者指出最初发布的 zip 里泄露了 .env 文件。站内可用的快照显示 5 月中旬约 6.8k Star，19 日涨到约 8k，11 月一个 Python 日榜第 9 名的快照为 11.5k；快照稀疏，只能说明这些日期的量级，不构成连续曲线。更值得注意的是范围变化：最初只是数据聚合看板，如今又加上 Agent 命令协议与治理经济，审计面和成熟度门槛都远高于一张地图。

项目源码与说明