jketterl/openwebrx

OpenWebRX Docker镜像文档

1. 镜像概述

OpenWebRX Docker镜像是一个基于Web的软件定义无线电(SDR)接收器解决方案，专为业余无线电（火腿无线电）用户设计。该镜像包含OpenWebRX核心功能及多种额外数字操作模式，包括DMR、D-Star、YSF、NXDN、FT8、FT4、JT9、JT65、WSPR和Packet，可通过Web界面实现无线电信号的接收与解码。

2. 核心功能与特性

• 基于Web的图形化界面，无需安装客户端软件
• 支持多种主流业余无线电数字通信模式
• 兼容rtl-sdr等USB SDR设备（需访问主机USB总线）
• 配置数据持久化存储（通过Docker卷实现）
• 支持Web界面配置管理

3. 使用场景

适用于业余无线电爱好者进行无线电信号接收、数字模式通信实验及无线电频谱监测。

4. 使用方法

4.1 前提条件

• 主机需连接rtl-sdr或其他兼容的USB SDR设备
• 容器需要访问主机USB总线（通过--device /dev/bus/usb参数）

4.2 首次启动

1. 创建数据卷以持久化配置：

   bash
   docker volume create openwebrx-settings
   

2. 启动容器（首次运行会自动将示例配置复制到数据卷）：

   bash
   docker run --device /dev/bus/usb -p 8073:8073 -v openwebrx-settings:/var/lib/openwebrx jketterl/openwebrx:stable
   

4.3 后续启动

配置完成后，后续启动可直接执行：

bash
docker run --device /dev/bus/usb -p 8073:8073 -v openwebrx-settings:/var/lib/openwebrx jketterl/openwebrx:stable

5. 高级配置

5.1 临时文件内存存储优化

若主机使用闪存存储（如SSD或树莓派SD卡），建议将临时文件转移至内存存储以减少磁盘写入：

bash
docker run --device /dev/bus/usb -p 8073:8073 -v openwebrx-settings:/var/lib/openwebrx --tmpfs=/tmp/openwebrx jketterl/openwebrx:stable

注意：路径/tmp/openwebrx为容器内固定配置，如需修改需同步更新容器配置。

5.2 配置文件自定义

如需修改/etc/openwebrx目录下的配置文件，需添加额外数据卷挂载：

bash
docker run --device /dev/bus/usb -p 8073:8073 -v openwebrx-settings:/var/lib/openwebrx -v /path/to/host/config:/etc/openwebrx jketterl/openwebrx:stable

6. 更多信息

• https://github.com/jketterl/openwebrx/wiki
• 官方网站