intercept

支持此开源项目的开发者

信号情报平台
一个基于 Web 的软件定义无线电工具接口。

功能

• 寻呼机解码 - 通过 rtl_fm + multimon-ng 解码 POCSAG/FLEX
• 433MHz 传感器 - 通过 rtl_433 解码气象站、TPMS、物联网设备
• Sub-GHz 分析仪 - 通过 HackRF 进行 300-928 MHz ISM 频段的射频捕获和协议解码
• 飞机跟踪 - 通过 dump1090 进行 ADS-B 跟踪，含实时地图和雷达
• 船舶跟踪 - AIS 船舶跟踪，含 VHF DSC 遇险监控
• ACARS 消息 - 通过 acarsdec 解码飞机数据链消息
• VDL2 - 通过 dumpvdl2 解码 VHF 数据链路模式 2 飞机数据链
• 监听站 - 宽带频率扫描仪，含实时音频监控
• 气象卫星 - 通过 SatDump 解码 NOAA APT 和 Meteor LRPT 图像，含自动调度
• WebSDR - 通过 KiwiSDR 网络远程 HF/短波收听
• ISS SSTV - 从国际空间站接收慢扫描电视图像
• HF SSTV - 短波频率（80m-10m、VHF、UHF）上的地面 SSTV
• APRS - 业余分组无线电位置报告和遥测，通过 direwolf 实现
• 卫星跟踪 - 过境预测，含极坐标图和地面轨迹图
• 公用事业电表 - 通过 rtlamr 读取电、气、水表
• ADS-B 历史 - 持久化飞机历史记录，含报告仪表板（可选 Postgres）
• WiFi 扫描 - 通过 aircrack-ng 进行监控模式侦察
• 蓝牙扫描 - 设备发现和追踪器检测（支持 Ubertooth）
• BT 定位 - 搜索与救援蓝牙设备定位，含 GPS 标记信号轨迹映射和接近警报
• WiFi 定位 - 通过 BSSID 定位 WiFi 接入点，含实时信号强度计、距离估计和接近音频
• GPS - 实时 GPS 位置跟踪，含实时地图、速度、高度和卫星信息
• TSCM - 反监控，含射频基线比较和威胁检测
• Meshtastic - LoRa 网格网络集成
• 空间天气 - 来自 NOAA SWPC、NASA SDO 和 HamQSL 的实时太阳和地磁数据（无需 SDR）
• 间谍电台 - 数字台和外交 HF 网络数据库
• 远程代理 - 分布式 SIGINT，含远程传感器节点
• 离线模式 - 为气隙/野外部署打包的资源
• 无人机情报 - 通过 ASTM F3411 远程 ID（WiFi/BLE）、RTL-SDR 433/868 MHz 射频和 HackRF 2.4/5.8 GHz 扫描进行多向量 UAV 检测，含实时接触地图和风险评分

安装 / Debian / Ubuntu / macOS

快速开始

git clone https://github.com/smittix/intercept.git
cd intercept
./setup.sh          # 交互式菜单（首次运行启动设置向导）
sudo ./start.sh

首次运行时，setup.sh 会启动一个引导式向导，检测您的操作系统，让您选择安装配置文件，设置 Python 环境，并可选择配置环境变量和 PostgreSQL。

后续运行时，它会打开一个交互式菜单：

INTERCEPT 设置菜单
════════════════════════════════════════
  1) 安装 / 添加模块
  2) 系统健康检查
  3) 数据库设置（ADS-B 历史记录）
  4) 更新工具
  5) 环境配置器
  6) 卸载 / 清理
  7) 查看状态
  0) 退出

生产环境 vs 开发服务器： start.sh 自动检测 gunicorn + gevent，并运行一个使用协作式 greenlet 的生产服务器——可处理多个 SSE/WebSocket 客户端而不阻塞。如果未安装 gunicorn，则回退到 Flask 开发服务器。对于快速本地开发，您仍然可以直接使用 sudo -E venv/bin/python intercept.py。

安装配置文件

在向导或通过菜单选项 1 选择要安装的内容：

多个配置文件可以组合（例如输入 1 3 表示核心 + 天气）。

命令行标志

./setup.sh --non-interactive          # 无人值守完整安装（与旧行为相同）
./setup.sh --profile=core,weather     # 安装特定配置文件
./setup.sh --health-check             # 检查系统健康状况并退出
./setup.sh --postgres-setup           # 运行 PostgreSQL 设置并退出
./setup.sh --menu                     # 强制进入交互式菜单

Docker

git clone https://github.com/smittix/intercept.git
cd intercept
docker compose --profile basic up -d --build

注意： Docker 需要特权模式才能访问 USB SDR。SDR 设备通过 /dev/bus/usb 传递。

对于多架构构建（amd64 + arm64 用于树莓派），请参见 build-multiarch.sh——它一步处理交叉编译和注册表推送。

环境配置

使用环境配置器（菜单选项 5）以交互方式设置任何 INTERCEPT_* 变量。设置项保存到 .env 文件中，start.sh 在启动时自动加载该文件。

您也可以手动创建或编辑 .env：

# .env（由 start.sh 自动加载）
INTERCEPT_PORT=5050
INTERCEPT_ADSB_AUTO_START=true
INTERCEPT_DEFAULT_LAT=51.5074
INTERCEPT_DEFAULT_LON=-0.1278

ADS-B 历史记录（可选）

ADS-B 历史记录功能将飞机消息持久化到 PostgreSQL 中，用于长期分析。

自动设置（本地安装）：

./setup.sh --postgres-setup
# 或使用菜单选项 3：数据库设置

如果需要，此操作将安装 PostgreSQL，创建数据库/用户/表，并将连接设置写入 .env。

Docker：

docker compose --profile history up -d

设置以下环境变量（在 .env 中）：

INTERCEPT_ADSB_HISTORY_ENABLED=true
INTERCEPT_ADSB_DB_HOST=adsb_db
INTERCEPT_ADSB_DB_PORT=5432
INTERCEPT_ADSB_DB_NAME=intercept_adsb
INTERCEPT_ADSB_DB_USER=intercept
INTERCEPT_ADSB_DB_PASSWORD=intercept

要将 Postgres 数据存储在外部存储器上，设置 PGDATA_PATH（默认为 ./pgdata）：

PGDATA_PATH=/mnt/usbpi1/intercept/pgdata

然后打开 /adsb/history 查看报告仪表板。

系统健康检查

验证您的安装是否完整且正常工作：

./setup.sh --health-check
# 或使用菜单选项 2

检查已安装的工具、SDR 设备、端口可用性、权限、Python 虚拟环境、.env 配置和 PostgreSQL 连接。

打开界面

启动后，在浏览器中打开 **http://localhost:5050**。

默认凭据：admin / admin——在将应用程序暴露到网络之前，请在 config.py 中更改这些凭据（ADMIN_USERNAME / ADMIN_PASSWORD）。

硬件要求

大多数功能只需一个基础的 RTL-SDR 加密狗（RTL2832U + R820T2）即可工作。

Discord 服务器

加入我们的 Discord

文档

• 使用指南 - 每种模式的详细说明
• 硬件指南 - SDR 硬件、手动安装和高级设置
• 故障排除 - 常见问题及解决方法
• 分布式代理 - 远程传感器节点部署
• Webhook - 警报规则和 Webhook 集成
• 安全 - 网络安全和最佳实践

免责声明

本项目使用 AI 作为编码伙伴开发，结合了人类指导和 AI 辅助实现。目标：通过为常用 SDR 工具提供一个简洁统一的界面，使软件定义无线电更易访问。

本软件仅用于教育和授权测试目的。

• 仅在有适当授权的情况下使用
• 未经同意截取通信可能违法
• 您有责任遵守适用法律

许可证

Apache 2.0 许可证 - 请参阅 LICENSE

作者

由 smittix 创建 - GitHub

致谢

rtl-sdr | multimon-ng | rtl_433 | dump1090 | AIS-catcher | acarsdec | direwolf | rtlamr | dumpvdl2 | aircrack-ng | Leaflet.js | SatDump | Celestrak | Priyom.org |