slechev/openwebrxplus

OpenWebRX+ Docker 镜像

基于 https://github.com/luarvique 的 https://luarvique.github.io/ppa/ 构建。

🚨 支持与问题反馈

如遇镜像相关问题，请联系 LZ2SLL 或加入 OpenWebRX+ 聊天群组。

核心功能和特性

• 包含所有接收器和解调器
• 服务和SDR设备健康检查
• 简单的管理员用户设置
• 插件扩展支持

使用场景和适用范围

适用于无线电爱好者、信号监测等场景，通过Web界面实现SDR（软件定义无线电）设备的远程访问、配置与管理，支持多种解调模式和信号接收。

使用方法

有关详细功能和故障排除，请参阅 OpenWebRX+ 信息页。

时区配置

设置 TZ 环境变量为您的时区（例如 Europe/Sofia）。
时区列表

rtl_tcp 端口转发

默认情况下，rtl_tcp兼容的数据端口在容器内绑定到localhost。如需暴露这些端口：

1. 设置环境变量 FORWARD_LOCALPORT_XXXX=YYYY，其中：
   • XXXX = 内部端口，即您在OWRX设置页面配置的端口（如1234）
   • YYYY = 外部端口，即您希望在网络中暴露的端口（如5678）
   • 两者必须不同。
2. 在 docker run 命令中添加 -p YYYY:YYYY。

管理员用户设置

通过设置以下环境变量创建管理员用户：

• OPENWEBRX_ADMIN_USER=myuser（管理员用户名）
• OPENWEBRX_ADMIN_PASSWORD=password（管理员密码）

容器健康检查

容器包含健康检查脚本：

• 端口检查：始终检查8073端口是否开放且OWRX有响应。
• USB设备检查：
  设置 HEALTHCHECK_USB_<VENDOR>_<PRODUCT>=N，要求存在N个具有指定USB ID的设备。
• SDR设备检查：
  设置 HEALTHCHECK_SDR_DEVICES=N，要求OWRX内部运行N个SDR设备。

使用 https://hub.docker.com/r/willfarrell/autoheal/ 可重启不健康的容器。

安装

sh
# 创建持久化数据目录
mkdir -p /opt/owrx-docker/var /opt/owrx-docker/etc /opt/owrx-docker/plugins/receiver /opt/owrx-docker/plugins/map

# 运行容器
docker run -d --name owrxp \
    --device /dev/bus/usb \
    --tmpfs=/tmp \
    -p 8073:8073 \
    -p 5678:5678 \
    -v /opt/owrx-docker/var:/var/lib/openwebrx \
    -v /opt/owrx-docker/etc:/etc/openwebrx \
    -v /opt/owrx-docker/plugins:/usr/lib/python3/dist-packages/htdocs/plugins \
    -e TZ=Europe/Sofia \
    -e FORWARD_LOCALPORT_1234=5678 \
    -e OPENWEBRX_ADMIN_USER=myuser \
    -e OPENWEBRX_ADMIN_PASSWORD=password \
    -e HEALTHCHECK_USB_0BDA_2838=2 \
    -e HEALTHCHECK_SDR_DEVICES=4 \
    --restart unless-stopped \
    slechev/openwebrxplus-softmbe

Docker Compose 配置示例

保存为 /opt/owrx-docker/docker-compose.yml：

yaml
services:
  owrx:
    image: 'slechev/openwebrxplus-softmbe:latest'
    container_name: owrx-mbe
    restart: unless-stopped
    ports:
      - '8073:8073'
      - '5678:5678'
    environment:
      TZ: Europe/Sofia
      FORWARD_LOCALPORT_1234: 5678
      OPENWEBRX_ADMIN_USER: myuser
      OPENWEBRX_ADMIN_PASSWORD: password
      HEALTHCHECK_USB_0BDA_2838: 2
      HEALTHCHECK_USB_0BDA_2832: 1
      HEALTHCHECK_USB_1DF7_3000: 1
      HEALTHCHECK_SDR_DEVICES: 4
    devices:
      - /dev/bus/usb:/dev/bus/usb
    volumes:
      - /opt/owrx-docker/etc:/etc/openwebrx
      - /opt/owrx-docker/var:/var/lib/openwebrx
      - /opt/owrx-docker/plugins:/usr/lib/python3/dist-packages/htdocs/plugins
    # 将/tmp挂载到内存中，对于树莓派设备，可减少SD卡磨损并加快dump1090运行速度
    tmpfs:
      - /tmp:mode=1777

# 如需容器在健康检查失败时自动重启
# (参考: https://stackoverflow.com/a/48538213/420585)
  autoheal:
    restart: always
    image: willfarrell/autoheal
    environment:
      - AUTOHEAL_CONTAINER_LABEL=all
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock

• 根据需要编辑配置。
• 使用 docker compose up -d 启动。

插件

在 /opt/owrx-docker/plugins/[receiver|map] 目录下添加插件。
详见 https://github.com/0xAF/openwebrxplus-plugins%E3%80%82

sh
# 从示例创建init.js
wget -O /opt/owrx-docker/plugins/receiver/init.js https://raw.githubusercontent.com/0xAF/openwebrxplus-plugins/main/receiver/init.js.sample
wget -O /opt/owrx-docker/plugins/map/init.js https://raw.githubusercontent.com/0xAF/openwebrxplus-plugins/main/map/init.js.sample

主机设备驱动黑名单

为避免冲突，在主机上黑名单SDR驱动并重启：

sh
cat > /etc/modprobe.d/owrx-blacklist.conf << _EOF_
blacklist dvb_usb_rtl28xxu
blacklist sdr_msi3101
blacklist msi001
blacklist msi2500
blacklist hackrf
_EOF_

SDRPlay 设备

若首次运行后未检测到SDRPlay设备，请重启容器。
详见 https://github.com/jketterl/openwebrx/wiki/SDRPlay-device-notes#no-sdr-devices-available-when-running-in-docker 和 https://github.com/pbelskiy/docker-usb-sync%E3%80%82

寻求帮助

• OpenWebRX+ 信息页
• https://github.com/0xAF/openwebrxplus-docker-builder/issues

更多信息

• https://github.com/jketterl/openwebrx/wiki/Getting-Started-using-Docker
• https://github.com/jketterl/openwebrx/wiki/User-Management#special-information-for-docker-users
• https://github.com/0xAF/openwebrxplus-docker-builder