前言：为什么要使用 ShadowBroker？
在当今地缘政治紧张、全球事件瞬息万变的时代，传统新闻和单一追踪工具往往无法满足对实时、多维度情报的需求。ShadowBroker 正是为 OSINT 爱好者、分析师、安全研究者或对全球态势感兴趣的用户而生。它能在一个统一的“上帝之眼”地图中融合飞机（包括私人/军用）、船舶、卫星轨道、地震、冲突区、GPS 干扰、CCTV 摄像头网络、新闻事件等数据层，让你像科幻电影中的情报官一样，一键俯瞰世界实时动态。
核心价值包括：
- 实时性强：数据近实时更新，支持飞机、船舶等动态目标的“闪烁点”追踪。
- 隐私友好：完全自托管，所有数据在本地浏览器与后端处理，不收集用户数据。
- 可扩展：支持 35+ 个可切换图层，右键任意地点即可获取区域档案、国家元首信息或最新 Sentinel-2 卫星照片。
- 开源免费：基于 Next.js 前端、MapLibre GL 地图、FastAPI 后端构建，社区活跃，可自定义扩展。
- 实用场景：追踪私人飞机/游艇、监测 GPS 干扰区（通过飞机信号聚合计算）、查看城市实时 CCTV、分析地震或冲突热点等。
如果你厌倦了分散的追踪网站，想拥有一个统一、专业的本地情报平台，ShadowBroker 是绝佳选择。它不仅实用，还充满赛博朋克式的“全球威胁拦截”氛围。
一：本地 Docker 部署 ShadowBroker
ShadowBroker 推荐使用 Docker 部署，简单高效，支持 Linux、macOS 和 Windows（需 Docker Desktop）。整个过程只需几分钟。
部署流程图
前提条件：
- 安装 Docker 和 Docker Compose（Windows/Mac 用 Docker Desktop，Linux 可通过官方脚本安装）。
- 确保系统有足够资源（推荐 4GB+ 内存）。
部署步骤：
- 克隆仓库：
git clone https://github.com/BigBodyCobain/Shadowbroker.git cd Shadowbroker
- （可选）配置环境变量： 在仓库根目录创建 .env 文件（复制 .env.example 并修改）。部分数据源需要 API Key（如 ADS-B、AIS、N2YO 卫星等），但许多核心图层（如 CCTV、部分新闻）无需 Key 即可使用。示例：
ADSB_API_KEY=your_key_here AIS_API_KEY=your_key_here # 其他 Key 根据需要添加
- 启动容器：
docker compose pull docker compose up -d
访问仪表盘： 打开浏览器，访问 http://localhost:3000（默认端口）。如果一切正常，你会看到暗黑风格的交互地图。
常见问题处理：
- 如果启动失败，检查 Docker 是否运行，并运行 docker compose logs 查看日志。
- 更新版本：docker compose down && git pull && docker compose up -d --build。
- Podman 用户可参考类似命令（项目文档有支持）。
部署后，系统会自动拉取并聚合多个情报源，地图开始实时刷新。
二：基本使用
部署完成后，进入仪表盘界面：
- 地图操作：
- 使用鼠标滚轮缩放、拖拽平移。
- 左侧或顶部有图层切换面板，启用/禁用各类数据（如 Aircraft、Ships、Satellites、Earthquakes、Conflicts、GPS Jamming、CCTV 等）。
- 实时动态目标（如飞机、船舶）会以闪烁点或图标显示，点击可查看详情（呼号、速度、类型等）。
- 核心功能：
- 右键交互：在地图任意位置右键，弹出区域/国家档案，包括最新卫星照片、元首信息等。
- 过滤与搜索：支持按时间、类型过滤事件。
- 数据层叠加：同时显示飞机 + 船舶 + GPS 干扰区，快速发现关联（如军事活动区域的信号异常）。
- CCTV 查看：部分城市支持点击摄像头图标查看实时或近实时交通/街景画面（合法公开源）。
- 日常使用建议：
- 初次使用时，先启用核心层（飞机、船舶、地震），熟悉界面。
- 监控特定区域：缩放到感兴趣的城市或热点，开启相关警报层。
- 性能优化：关闭不必要的图层以减少浏览器负载。
- 侧边栏想看什么，可以自由选择
界面直观，大多数操作无需编程知识，即可快速上手。
三：高阶使用方法
当你不满足于“看飞机看船”时，Shadowbroker 真正硬核的功能才刚刚开始。
ShadowBroker 支持进阶玩法，让它从简单仪表盘变为专业情报工具：
- API Key 优化与数据源扩展：
- 获取免费/付费 Key（如 ADS-B Exchange、AISStream、N2YO）后填入 .env，解锁更多精准数据。
- 添加本地硬件：支持 RTL-SDR 接收本地 AIS 船舶信号（项目有专用文档）。
- 自定义与开发：
- 添加新图层：基于现有 BaseCCTVIngestor 等模式，编写 Python 后端 ingestor 集成新数据源（如更多 CCTV、Telegram feed）。
- STIX 2.1 导出：支持将情报导出为标准化威胁情报格式，便于与其他安全工具集成。
- GPS 干扰分析：利用飞机 ADS-B 信号的导航精度降级（NAC-P）被动计算干扰区，这是纯软件实现的 SIGINT 技巧。
- 高级部署：
- 高可用：使用 Helm Chart 部署到 Kubernetes 集群，支持 Traefik/Cert-Manager 等 Ingress。
- 安全强化：添加 Admin Auth、Rate Limiting；生产环境用 Docker Secrets 管理 Key。
- 代理与网络：若某些源需海外访问，可结合 SOCKS5 代理（SSH 动态端口转发）运行。
- 集成扩展：社区贡献包括西班牙交通摄像头、更多信号层；可 fork 项目添加 Telegram/X 事件聚合或 AI 聊天查询。
- 分析师工作流：
- 发现 GPS 干扰 → 叠加飞机/船舶层 → 右键查看冲突新闻 → 导出 STIX 报告。
- 监控私人飞机/游艇时，结合卫星照片验证位置。
高阶用户可深入 GitHub 仓库，贡献代码或自定义模块，让工具更贴合个人需求。
结尾总结
Shadowbroker 不仅仅是一个地图工具，它本质上是一个“空间化的公开情报聚合引擎”。它打破了不同领域（天空、海洋、太空、电磁波、网络空间）之间的壁垒，用最直观的地理维度把碎片化的数据缝合在一起。
通过本地 Docker 部署，我们拥有了一个完全私密、无需注册、不泄露任何数字指纹的超级情报站。从基础的航班追踪，到高阶的短波监听、GPS干扰分析，它满足了从小白到资深OSINT分析师的全方位需求。
