fredclausen/rtlsdrairband

docker-rtlsdrairband

运行https://github.com/szpajder/RTLSDR-Airband%E5%92%8CIcecast%E7%9A%84Docker%E5%AE%B9%E5%99%A8%E3%80%82%E5%8F%AF%E5%9C%A8%60arm64%60%E6%9E%B6%E6%9E%84%E6%9E%84%E5%BB%BA%E5%92%8C%E8%BF%90%E8%A1%8C%EF%BC%8C%E5%90%8C%E6%97%B6%E6%8F%90%E4%BE%9B%60amd64%60%E5%92%8C%60arm32v7%60%E6%9E%B6%E6%9E%84%E7%9A%84%E5%AE%B9%E5%99%A8%EF%BC%88%E4%BD%86%E6%9C%AA%E6%B5%8B%E8%AF%95%EF%BC%8C%E8%AF%A6%E8%A7%81%E4%B8%8B%E6%96%87%EF%BC%89%E3%80%82

该容器运行Icecast音频服务器，RTLSDR-Airband可连接至该服务器，使你能通过RTLSDR加密狗监听空中交通管制（ATC）甚高频（VHF）无线电通信，以及部分其他窄带调频（NFM）调制传输（见NFM），并通过网页浏览器或音频播放程序访问。

支持的标签及对应的Dockerfile

• latest（master分支，Dockerfile）
• latest_nfm（master分支，Dockerfile.NFM，详见下文NFM）
• 提供版本和架构特定标签

多架构支持

当前，该镜像可在以下架构上拉取并运行：

• amd64：Linux x86-64（已构建但未测试，若能正常使用请告知！）
• arm32v7：ARMv7 32位（Odroid HC1/HC2/XU4、树莓派2/3）（已构建但未测试，若能正常使用请告知！）
• arm64：ARMv8 64位（树莓派3和4的64位系统）

致谢

感谢https://github.com/mikenye%E6%8F%90%E4%BE%9B%E7%9A%84%E4%BC%98%E7%A7%80ADSB Docker容器，本项目大量借鉴了其容器设置思路，同时感谢他在容器实现过程中提供的宝贵建议和帮助。

所需硬件

至少需要一个RTLSDR加密狗。若系统中存在多个加密狗，需设置并传入要使用的加密狗序列号（见下文环境变量配置）。Kerberos SDR RTLSDR设备同样适用。

使用docker run快速启动

shell
docker run \
 -d \
 --rm \
 --name rtlsdr-airband \
 -p 8000:8000 \
 -e RTLSDRAIRBAND_FREQS=123.9 \
 --device /dev/bus/usb:/dev/bus/usb \
fredclausen/rtlsdrairband

请将RTLSDRAIRBAND_FREQS替换为你要监听的频率。

使用Docker Compose快速启动

yaml
version: '2.0'

services:
  rtlsdirairband:
    image: fredclausen/rtlsdrairband
    tty: true
    container_name: rtlsdrairband
    restart: always
    devices:
      - /dev/bus/usb:/dev/bus/usb
    ports:
      - 8000:8000
    environment:
      - RTLSDRAIRBAND_FREQS=123.9

端口

容器默认暴露8000端口。若需使用其他端口，可设置以下环境变量：

• PORT

将其值设为所需端口。在容器启动命令中，确保PORT环境变量的值替换8000。例如，使用上述Docker Compose配置，将PORT设为9000，则端口配置如下：

yaml
    ports:
      - 9000:9000
    environment:
      - RTLSDRAIRBAND_FREQS=123.9
      - PORT=9000

卷

可挂载/run/rtlsdr-airband目录，为容器提供自定义的rtlsdr-airband.conf或icecast.xml配置文件。大多数用户无需此操作。详见RTLSDR-Airband高级模式和/或Icecast高级模式。

环境变量

容器支持多种配置选项，具体如下：

Icecast

RTLSDR-Airband

• 更多信息见https://github.com/szpajder/RTLSDR-Airband/wiki/Icecast-metadata-updates-in-scan-mode%EF%BC%8C%E6%B3%A8%E6%84%8F%E4%B8%8D%E8%A6%81%E5%8C%85%E5%90%AB%E6%8B%AC%E5%8F%B7%E6%88%96%E9%A6%96%E5%B0%BE%E7%A9%BA%E6%A0%BC%E3%80%82

• 此外，Icecast元数据同步（无论是否带标签）可能与音频不同步，原因见https://github.com/szpajder/RTLSDR-Airband/wiki/Icecast-metadata-updates-in-scan-mode%E3%80%82

• 并非所有RTLSDR加密狗都支持高于2.56的采样率。若采样率高于2.56后接收效果显著下降，请降低至2.56。

测试

若需测试流是否正常工作，请确保：

• RTLSDRAIRBAND_MODE

未设置或设为multichannel，并添加以下环境变量：

• SQUELCH

设置任意非空值，这将关闭自动静噪，打开流时可听到静电噪音。

RTLSDR-Airband高级模式

若需从同一RTLSDR加密狗向多个Icecast服务器推流、使用多个加密狗，或配置环境变量未涵盖的高级选项，可将卷挂载至容器的：

• /run/rtlsdr-airband

并设置以下环境变量为任意值：

• RTLSDRAIRBAND_CUSTOMCONFIG

设置后，所有RTLSDRAIRBAND_*配置值将被忽略，容器将使用挂载卷中提供的rtlsdr-airband.conf自定义配置文件。配置文件格式详见https://github.com/szpajder/RTLSDR-Airband/wiki/Configuration-essentials%E3%80%82

Icecast高级模式

Icecast支持环境变量未涵盖的多种高级选项。若需配置，可将卷挂载至：

• /run/rtlsdr-airband

并设置以下环境变量为任意值：

• ICECAST_CUSTOMCONFIG

设置后，所有ICECAST_*配置值将被忽略，容器将使用挂载卷中提供的icecast.xml自定义配置文件。配置文件格式详见Icecast文档。

NFM

容器的主要用途是监听VHF空中波段通信，但底层软件不限于VHF通信和AM调制。使用fredclausen/rtlsdrairband:latest_nfm镜像可启用NFM调制，监听其他无线电通信（如铁路通信）。latest标签默认未启用NFM，因需额外CPU开销（硬件受限情况下不可忽略），若需此功能，请使用latest_nfm标签。

访问Web界面

容器的Web界面可通过containerip:8000访问，若设置了PORT环境变量，则通过containerip:port访问。

日志

• 所有进程日志输出至容器stdout，可通过docker logs [-f] container查看。

获取帮助

可在项目GitHub上https://github.com/fredclausen/docker-rtlsdrairband/issues%E3%80%82