HackRF One Toolkit — 把频谱扫描、IQ 抓包重放、GPS 模拟装进浏览器的自托管 Web 控制台（开源）

[AI 整理声明]本文基于作者的项目文档与开发实践由 AI 辅助整理输出核心内容与数据均来自作者本人。目录安装设备频谱抓包重放GPS参数档架构注意用 HackRF One 做信号录制或重放的时候每次都要拼一长串hackrf_transfer参数频率、采样率、增益各记各的容易写错抓完的.raw文件也没地方统一管理。HackRF One Toolkit 就是把这些操作收进浏览器的 Web 控制台——选频段、按按钮后台帮你构造并执行真实命令把频谱、功率曲线、解码结果推回页面。GitHubhttps://github.com/cstriker1407/HackRF_One_Toolkit安装硬件端Kali / Debian 系sudoaptinstallhackrf rtl-433 soapysdr-module-hackrf# 可选GPS 模拟需要 gps-sdr-sim源码编译gitclone https://github.com/osqzss/gps-sdr-sim tools/gps-sdr-sim gcc tools/gps-sdr-sim/gpssim.c-lm-O3-otools/gps-sdr-sim/gps-sdr-simPython 3.11依赖flask/waitress/requests见pyproject.toml。./start.sh# 启动 RF_Bridge(:30001) hackrf_web(:30000)./stop.sh# 停止并清理残留子进程浏览器打开http://主机IP:30000。硬件和浏览器可以不在同一台机器——RF_Bridge 加--allow-lan后从另一台机器访问即可比如 Kali 上接 HackRFWindows 浏览器操作。设备进来先看「硬件设备」页确认设备在线列出每台 HackRF 的序列号、固件、硬件版本克隆板有黄色提示时钟精度可能影响 GPS多台设备时点「设为当前」切换。下方「RF_Bridge 工具链」显示hackrf_*/rtl_433/gps-sdr-sim是否就位。频谱「频谱扫描」页用来看环境里有什么信号点一个预设频段如WiFi·BLE 2.4 GHz或手填起始/结束频率点「连续扫描」或「单次扫描」。绿线是此刻功率暗黄线是峰值保持把出现过的最强值定格间歇信号不会漏。下方峰值列表按强度排序点某行的「抓包」直接跳到抓包页并把该频点填好。页面右下「将执行的命令」实时显示底层跑的hackrf_sweep …参数知道发生了什么。切到**设备解码rtl_433**标签填频率点「开始解码」能把周边 ISM 设备胎压、气象站、门磁、温湿度传感器直接解成结构化记录。频谱扫描与设备解码共用天线互斥运行。抓包「抓包 / 重放」页录 IQ 文件选频率、采样率、时长点「开始录制」。下方「实时功率」是 dBFS 随时间的曲线右上角有倒计时。安静时是底噪目标一发射功率会明显跳升——看到跳升就说明录到了有效信号。右侧抓包库列出所有录制每条可重放 / 下载.raw/ 删除。重放点抓包库里的「重放」弹出发射窗口频率和采样率自动回填采样率锁定为录制值防止收发不一致解不开。设 TX 增益点「确认发射」。发射时弹窗不可关闭必须先点「停止发射」其他页面被整页锁定避免误操作。固定码遥控老车库门、便宜遥控插座等原样重放通常能复现滚动码一般无效。发射类功能仅限你自己拥有或获得书面授权的设备。GPS「GPS 模拟」页在地图上点坐标发射伪造 GPS 信号必须在射频屏蔽箱法拉第箱内进行。向开放空间发射 GPS 违法且危险。地图上点击添加坐标默认高德底图坐标自动做 GCJ-02→WGS-84 纠偏右侧「坐标序列」给每个点设海拔和停留时长点「尝试自动获取当天星历」或手动上传 RINEX.nav点「生成并发射」状态栏分两步显示步骤 1/2 生成信号中→步骤 2/2 发射中 倒计时单个坐标推荐先这样验证生成一段连续文件发一次即停建议停留 ≥120 秒、屏蔽箱内、TX 增益调高。多个坐标循环为实验性接收机通常难以锁定。参数档每个操作页都有三层标准只露最常用的几项频率、采样率、时长高级展开全部参数LNA / VGA 增益、带宽、放大器、天线偏置电源、设备选择每项旁?有即时说明专家直接手改「将执行的命令」那行真实命令——经白名单校验必须是对应工具、禁 shell 特殊字符、文件限定在captures/目录内点开始按你写的执行架构两进程HTTP SSE 通信浏览器 ──HTTPSSE── hackrf_web(:30000) ──HTTPSSE── RF_Bridge(:30001) ──子进程── hackrf_* / rtl_433 / gps-sdr-sim 只显示不碰硬件 独占 HackRF跑命令、解析输出、推实时流RF_Bridge 独占硬件同一时刻只运行一个任务半双工hackrf_web 是纯展示层把/api/*透明代理到 RF_Bridge不含任何硬件逻辑。注意接收 / 扫描频谱、解码被动一般合法发射重放、GPS只可用于已授权设备GPS 模拟必须在屏蔽箱内向开放空间发射会干扰周边真实导航与授时违法且危险无登录鉴权仅适合局域网可信环境跨信任边界请自行加反向代理 认证子进程一律以 argv 数组执行不经过 shell专家模式命令经白名单校验MIT 开源。