flightaware/dump1090-rtldsp 镜像文档

镜像概述

本镜像为flightaware/dump1090客户端的微型容器化版本，集成了RTLDSP驱动以支持USB设备，主要用于接收和处理ADS-B（广播式自动相关监视）信号，适用于航空数据接收与监视场景。

核心功能与特性

• 微型容器设计：采用轻量化构建，体积小、启动速度快，资源占用低。
• 集成RTLDSP驱动：内置RTLDSP驱动，原生支持USB RTL-SDR设备（如RTL2832U芯片的USB dongle），无需额外安装驱动。
• dump1090客户端功能：实现ADS-B信号接收、数据解码、实时处理及网络输出（如Web界面、JSON数据接口）。
• 兼容性：兼容主流Linux容器运行环境，支持USB设备直接挂载与访问。

使用场景与适用范围

适用场景

• 个人航空爱好者接收ADS-B信号，监控周边航班动态。
• 小型航空数据收集站部署，用于航空数据统计与分析。
• 机场或航空相关机构的辅助监视系统，补充传统雷达数据。

适用范围

• 需要通过USB RTL-SDR设备接收1090MHz ADS-B信号的环境。
• 支持Linux容器运行时（如Docker、Podman）的服务器或边缘设备。
• 具备USB设备访问权限的系统（需挂载USB总线设备）。

使用方法与配置说明

基本运行要求

• 宿主系统需支持USB设备挂载，且已安装容器运行时（Docker/Podman）。
• 需连接RTL-SDR USB设备至宿主，并确保宿主对设备有访问权限。

基本运行命令

通过以下命令启动容器，挂载USB设备并映射Web界面端口（默认8080）：

bash
docker run -d \
  --name dump1090-rtldsp \
  --device=/dev/bus/usb:/dev/bus/usb \  # 挂载USB总线设备
  -p 8080:8080 \                        # 映射Web界面端口
  flightaware/dump1090-rtldsp:latest

配置参数说明

可通过命令行参数调整dump1090运行配置，常用参数如下：

示例：带自定义参数运行

以下示例指定地理位置、增益，并启用Mode A/C解码：

bash
docker run -d \
  --name dump1090-custom \
  --device=/dev/bus/usb:/dev/bus/usb \
  -p 8080:8080 \
  flightaware/dump1090-rtldsp:latest \
  --gain 45 --lat 39.9042 --lon 116.4074 --modeac

访问Web界面

容器启动后，通过宿主IP:8080访问dump1090 Web界面，查看实时航班数据与信号状态。

注意事项

• 确保宿主用户对/dev/bus/usb设备有读写权限，或通过--user参数指定特权用户。
• 部分RTL-SDR设备可能需要宿主安装rtl-sdr工具包依赖（如librtlsdr0）。
• 高增益设置可能导致信号过载，建议根据实际环境调整--gain参数。