docker adsbexchange

sdr 爱好者/docker-adsbexchange

Docker 容器将 ADS-B 数据馈送到 adsbexchange。旨在与 sdr-enthusiasts/docker-readsb-protobuf 或其他 BEAST 提供商协同工作。在 x86、x86_64、arm32v7 和 arm64v8 上构建并运行。

容器从 BEAST 提供商处提取 ADS-B 信息并将数据发送到 adsbexchange。

有关 adsbexchange 的更多信息，请参阅此处：ADSBExchange 操作方法。该容器使用该页面上概述的“脚本方法”的修改版本。

支持的标签和相应的 Dockerfile

• latest是在提交基本映像和/或映像中包含的任何 adsbexchange 软件后 24 小时内从main分支构建的。它包含：
  • adsbxchange/adsb-exchange/setup.sh 中指定的mlat-client和readsb版本
  • 最新版本的adsbexchange-stats
  • rtl-sdr最新发布版本
• latest_nohealthcheck与上面的latest版本相同。但是，此版本删除了 docker healthcheck。这是为运行不支持手动禁用运行状况检查（不需要运行状况检查）的平台（例如 Nomad）的用户完成的。
• 如果需要，可以使用特定版本和架构标签，但这些标签不会定期更新。一般建议运行latest 。

配置sdr-enthusiasts/adsbexchange容器

• 如果您将此容器与 sdr-enthusiasts/docker-readsb-protobuf 容器一起使用来提供 ModeS/BEAST 数据，并且这些容器位于不同的 docker 网络或不同的主机上：
  • 您需要确保已在 sdr-enthusiasts/docker-readsb-protobuf 容器中打开端口30005 （或任何提供 BEAST 数据的端口）。
  • 运行 sdr-enthusiasts/docker-readsb-protobuf 容器的 docker 主机的 IP 地址或主机名应通过下面所示的BEASTHOST环境变量传递到sdr-enthusiasts/docker-adsbexchange容器。如果需要，可以使用可选的BEASTPORT环境变量更改默认端口30005 。
• 天线的纬度和经度必须分别通过LAT和LONG环境变量传递。
• 天线的高度必须分别通过ALT环境变量传递。默认为米，但可以使用“ft”或“m”后缀指定单位。
• 该供给器的 UUID 必须通过UUID环境变量传递（见下文）。
• 最后，您应该通过SITENAME环境变量指定站点名称。该字段仅支持字母、数字、 -和_ 。任何其他字符都将在容器初始化时被删除。

生成站点 UUID 号

首次使用的用户应使用以下命令生成静态 UUID：

cat /proc/sys/kernel/random/uuid

记下返回的 UUID。运行容器时，您应该将其作为UUID环境变量传递。

您可以通过访问https://www.adsbexchange.com/api/feeders/?feed=YOUR-UUID-HERE查看您网站的统计信息。当容器启动时，带有您的 UUID 的链接将打印到容器日志中。

使用docker run启动并运行

docker run 
 -d 
 --rm 
 --name adsbx 
 -e TZ=YOUR_TIMEZONE 
 -e BEASTHOST=beasthost 
 -e LAT=-33.33333 
 -e LONG=111.11111 
 -e ALT=50m 
 -e SITENAME=My_Cool_ADSB_Receiver 
 -e UUID=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx 
 --tmpfs=/run:rw,nosuid,nodev,exec,relatime,size=64M,uid=1000,gid=1000 
 ghcr.io/sdr-enthusiasts/docker-adsbexchange:latest

使用 Docker Compose 启动并运行

我们鼓励初学者阅读 ADS-B 接收、解码和使用 Docker 共享。

docker compose 服务定义示例如下：

 adsbexchange :
  image : ghcr.io/sdr-enthusiasts/docker-adsbexchange:latest
  tty : true
  container_name : adsbx
  restart : always
  environment :
    - BEASTHOST=beasthost
    - TZ=Australia/Perth
    - LAT=-33.33333
    - LONG=111.11111
    - ALT=50m
    - SITENAME=My_Cool_ADSB_Receiver
    - UUID=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
  tmpfs :
    - /run:rw,nosuid,nodev,exec,relatime,size=64M,uid=1000,gid=1000 

检查一切是否正常

• https://www.adsbexchange.com/myip/
• https://map.adsbexchange.com/mlat-map/

运行时环境变量

有一系列可用的环境变量：

环境变量	目的	默认
BEASTHOST	必需的。 S 模式/BEAST 提供商的 IP/主机名 (dump1090)
BEASTPORT	选修的。 S 模式/BEAST 提供商的 TCP 端口号 (dump1090)	30005
UUID	必需的。您的静态 UUID
LAT	必需的。天线纬度
LONG	必需的。天线经度
ALT	必需的。天线海拔高度。如果为正（高于海平面），则必须包含“m”或“ft”后缀以指示米或英尺。如果为负（低于海平面），则必须没有后缀，并且该值以米为单位解释。
SITENAME	必需的。您网站的名称（AZ、az、 - 、 _ ）
TZ	选修的。您当地的时区	GMT
REDUCE_INTERVAL	选修的。 eastreduce 数据传输到 ADSBExchange 的频率。对于低带宽馈送，可以增加到5甚至10	0.5
PRIVATE_MLAT	选修的。将此设置为 true 将阻止支线显示在 ADS-B 交换支线地图上	false
MLAT_INPUT_TYPE	选修的。设置输入接收器类型。运行docker run --rm -it --entrypoint mlat-client ghcr.io/sdr-enthusiasts/docker-adsbexchange:latest --help并查看--input-type以获取有效值。	dump1090
STATS_DISABLE	选修的。设置为任意值以禁用统计模块/任意位置地图（如果您不喜欢大量 DNS 查找，请将其设置为 1）	未设置
ADSB_FEED_DESTINATION_HOSTNAME	选修的。允许更改 ADS-B 数据馈送到的主机名。	feed.adsbexchange.com
ADSB_FEED_DESTINATION_PORT	选修的。允许更改 ADS-B 数据馈送到的 TCP 端口。	30005
ADSB_FEED_DESTINATION_TYPE	选修的。允许更改readsb输出数据类型。	beast_reduce_out
MLAT_FEED_DESTINATION_HOSTNAME	选修的。允许更改 MLAT 服务器主机名。	feed.adsbexchange.com
MLAT_FEED_DESTINATION_PORT	选修的。允许更改 MLAT 服务器 TCP 端口。	31090

港口

港口	目的
30105	用于graphs1090和/或tar1090等工具的 Beast 格式的 MLAT 数据

记录

• 所有进程都会记录到容器的标准输出中，并且可以使用docker logs [-f] container查看。

寻求帮助

请随时在项目的 GitHub 上提出问题。

我还有一个 Discord 频道，欢迎加入并交谈。