fr24feed Docker镜像文档

镜像概述

本镜像为Flightradar24数据收集客户端（fr24feed）的Docker容器化版本。fr24feed是Flightradar24平台的***数据上传工具，用于将本地接收的航班数据（如ADS-B信号）标准化后发送至fr24.com，支持全球航班实时追踪平台的数据聚合。

核心功能与特性

• Docker容器化部署：提供隔离的运行环境，简化部署流程，确保跨环境一致性，降低依赖冲突风险。
• 数据转发能力：接收本地航班数据（通常来自ADS-B接收器），按Flightradar24规范处理后发送至fr24.com平台。
• 配置灵活性：支持通过环境变量或挂载配置文件自定义参数，如API密钥、接收器地址、数据发送频率等。
• 轻量级运行：基于精简基础镜像构建，资源占用低，适合边缘设备或服务器环境长期运行。

使用场景与适用范围

• 航班数据贡献者：个人或组织运行ADS-B接收器（如搭配RTL-SDR设备）时，需将接收的航班数据上传至Flightradar24平台。
• 简化部署管理：替代传统的系统级安装方式，通过Docker Compose或容器编排工具（如Kubernetes）实现自动化部署与运维。
• 多环境适配：适用于Linux、Windows（WSL2）、macOS等支持Docker的操作系统，满足不同用户的环境需求。

使用方法与配置说明

前提条件

1. 已获取Flightradar24的API密钥（通过fr24.com注册并申请，通常在账号设置中获取）。
2. 本地已部署ADS-B接收器（如dump1090），并能通过网络提供航班数据（默认端口通常为30005）。
3. 主机已安装Docker Engine（20.10+推荐）。

基本运行命令

使用以下命令启动容器（替换<your_fr24_key>为实际API密钥）：

bash
docker run -d \
  --name fr24feed \
  --net=host \  # 使用主机网络以直接访问本地ADS-B接收器（推荐）
  -e FR24_KEY=<your_fr24_key> \  # 必需：Flightradar24 API密钥
  -e RECEIVER_IP=127.0.0.1 \  # 可选：ADS-B接收器IP（默认本地）
  -e RECEIVER_PORT=30005 \  # 可选：ADS-B接收器数据端口（默认30005）
  --restart unless-stopped \  # 容器退出时自动重启
  flightradar24/fr24feed  # 假设镜像名称为flightradar24/fr24feed（实际需替换为具体镜像名）

配置参数说明

数据持久化（可选）

若需保存配置文件或日志，可挂载本地目录至容器内对应路径（具体路径需参考镜像内fr24feed的配置文件位置，通常为/etc/fr24feed.ini）：

bash
docker run -d \
  --name fr24feed \
  --net=host \
  -e FR24_KEY=<your_fr24_key> \
  -v /path/to/local/config:/etc/fr24feed \  # 挂载本地配置目录
  -v /path/to/local/logs:/var/log/fr24feed \  # 挂载日志目录
  --restart unless-stopped \
  flightradar24/fr24feed

验证运行状态

容器启动后，可通过以下命令检查日志确认数据发送状态：

bash
docker logs -f fr24feed

若日志中出现类似“Successfully connected to fr24 server”或“Data sent to fr24.com”的信息，表明容器运行正常并已开始发送数据。