dmorehouse/raspberrypi-flightradar-flightaware-feed

Fr24feed、FlightAware与dump1090-mutability树莓派Docker镜像

镜像概述和主要用途

本Docker镜像专为树莓派设计，集成Fr24feed、FlightAware客户端和dump1090-mutability，通过RTL-SDR USB加密狗接收航空ADS-B信号，实现航班位置数据的本地查看与远程数据贡献。用户可通过Web界面查看实时航班地图，并将数据同步至FlightAware和FlightRadar24平台。

!https://raw.githubusercontent.com/dmorehouse/docker-raspberrypi-fr24feed-piaware-dump1090-mutability/master/screenshot.png

核心功能和特性

• 数据接收与展示：通过RTL-SDR设备接收航班ADS-B信号，本地Web界面（8080端口）实时显示航班位置地图
• 数据贡献：支持向FlightAware和FlightRadar24平台提交航班数据
• 配置管理：提供Fr24feed配置面板（8754端口），支持参数调整
• 可定制化：允许配置接收位置、站点名称等参数
• 跨设备支持：兼容树莓派B+、2、3、Zero W等型号

使用场景和适用范围

• 航空爱好者本地监控航班动态
• 向FlightAware/FlightRadar24贡献ADS-B数据
• 树莓派低功耗环境下的长期航班数据采集
• 教育或研究用途的航空数据收集与分析

详细使用方法和配置说明

前置要求

• 树莓派型号：B+、2、3、Zero W或Zero（需网络连接）
• 已安装Docker的树莓派系统
• RTL-SDR DVBT USB加密狗（RTL2832芯片）

作为Docker镜像运行（推荐）

安装Docker

若未安装Docker，执行以下命令获取最新稳定版：

bash
curl -sSL https://get.docker.com | sh

设置接收位置

下载并编辑https://raw.githubusercontent.com/dmorehouse/docker-raspberrypi-fr24feed-piaware-dump1090-mutability/master/config.js%E9%85%8D%E7%BD%AE%E6%96%87%E4%BB%B6%EF%BC%8C%E8%AE%BE%E7%BD%AE%E6%8E%A5%E6%94%B6%E4%BD%8D%E7%BD%AE%E5%92%8C%E7%AB%99%E7%82%B9%E5%90%8D%E7%A7%B0%EF%BC%9A

javascript
SiteShow    = true;           // 是否显示中心标记
SiteLat     = 47;             // 纬度（根据实际位置修改）
SiteLon     = 2.5;            // 经度（根据实际位置修改）
SiteName    = "Home";         // 站点名称

验证镜像运行与数据采集

在正式注册服务前，先验证设备是否能正常接收数据：

bash
docker run -it -p 8080:8080 -p 8754:8754 \
--privileged --device=/dev/bus/usb:/dev/bus/usb \
--mac-address="ff:ff:ff:ff:ff:ff" \
-v /绝对路径/到/config.js:/usr/lib/fr24/public_html/config.js \
docker.xuanyuan.run/dmorehouse/raspberrypi-flightradar-flightaware-feed

验证方法：

• 访问http://dockerhost:8080/gmap.html（本地树莓派可使用localhost）
• 若地图左下角显示"Problem fetching data from dump1090"，表示数据接收异常
• 检查终端输出日志排查错误（如"exec wrong/invalid exec format"可能需要本地构建镜像）

数据接收正常后，按Ctrl+C停止容器，继续以下配置。

FlightAware注册与配置

1. 访问FlightAware注册页面创建账号
2. 下载并编辑https://raw.githubusercontent.com/dmorehouse/docker-raspberrypi-fr24feed-piaware-dump1090-mutability/master/piaware.conf%EF%BC%9A

   flightaware-user YOUR_USERNAME  # 替换为你的FlightAware用户名
   flightaware-password YOUR_PASSWORD  # 替换为你的FlightAware密码
   

FlightRadar24注册与配置

1. 获取树莓派网络接口MAC地址：

   • 有线连接：ifconfig eth0 | grep "HWaddr"
   • 无线连接：ifconfig wlan0 | grep "HWaddr"

2. 执行注册命令生成共享密钥：

   bash
   docker run -it --privileged -v /dev/bus/usb:/dev/bus/usb \
   --mac-address="你的MAC地址" \
   --entrypoint /fr24feed/fr24feed_armhf/fr24feed docker.xuanyuan.run/dmorehouse/raspberrypi-flightradar-flightaware-feed --signup
   

3. 按提示完成注册：

   • 输入***地址
   • 无共享密钥时直接回车
   • 同意MLAT
   • 输入最近机场代码
   • 选择数据保留时间（建议1）
   • 日志路径可默认

4. 记录生成的16位共享密钥和雷达ID，下载并编辑https://raw.githubusercontent.com/dmorehouse/docker-raspberrypi-fr24feed-piaware-dump1090-mutability/master/fr24feed.ini%EF%BC%9A

   ini
   fr24key="你的共享密钥"  # 替换为注册得到的16位密钥
   

地形限制环配置（可选）

1. 在heywhatsthat.com为接收位置创建全景图
2. 下载地形数据：http://www.heywhatsthat.com/api/upintheair.json?id=XXXX&refraction=0.25&alts=1000,10000（XXXX为全景图ID）
3. 运行容器时添加挂载：-v /路径/到/upintheair.json:/usr/lib/fr24/public_html/upintheair.json

作为服务运行

使用以下命令后台运行容器（替换占位符为实际路径和MAC地址）：

bash
docker run -d -p 8080:8080 -p 8754:8754 \
--device=/dev/bus/usb:/dev/bus/usb \
--mac-address="你的MAC地址" \
-v /路径/到/piaware.conf:/etc/piaware.conf \
-v /路径/到/config.js:/usr/lib/fr24/public_html/config.js \
-v /路径/到/fr24feed.ini:/etc/fr24feed.ini \
docker.xuanyuan.run/dmorehouse/raspberrypi-flightradar-flightaware-feed

可选参数：添加--restart=always实现容器自动重启（需Docker服务自启动）

本地构建Docker镜像

准备配置文件

1. FlightAware配置：编辑piaware.conf，替换用户名和密码
2. 接收位置配置：编辑config.js设置经纬度和站点名称
3. FlightRadar24配置：编辑fr24feed.ini，填入注册得到的共享密钥
4. 地形数据（可选）：下载upintheair.json并取消Dockerfile中对应COPY行的注释

构建与运行

1. 编辑docker-compose.yml，替换mac-address为实际MAC地址
2. 执行构建命令：docker-compose up