docker adsbexchange

SDR-энтузиасты/docker-adsbexchange

Docker-контейнер для передачи данных ADS-B в AdsBexchange. Предназначен для работы в тандеме с sdr-enthusiasts/docker-readsb-protobuf или другим поставщиком BEAST. Создается и работает на платформах x86, x86_64, Arm32v7 и Arm64v8.

Контейнер получает информацию ADS-B от поставщика BEAST и отправляет данные в Adsbexchange.

Дополнительную информацию о Adsbexchange можно найти здесь: ADSBExchange How-To-Feed. Этот контейнер использует модифицированную версию «метода сценария», описанного на этой странице.

Поддерживаемые теги и соответствующие файлы Dockerfile.

• latest создается из main ветки в течение 24 часов после фиксации базового образа и/или любого программного обеспечения Adsbexchange, включенного в образ. Он содержит:
  • Версии mlat-client и readsb указаны в файлахadsbxchange/adsb-exchange/setup.sh.
  • Последняя версия adsbexchange-stats
  • Последняя выпущенная версия rtl-sdr
• latest_nohealthcheck аналогичен latest версии, указанной выше. Однако в этой версии удалена проверка работоспособности докера. Это сделано для людей, использующих платформы (такие как Nomad), которые не поддерживают отключение проверок работоспособности вручную, где проверки работоспособности не нужны.
• При необходимости доступны теги конкретной версии и архитектуры, однако они не обновляются регулярно. Обычно рекомендуется использовать latest .

Настройка контейнера sdr-enthusiasts/adsbexchange

• Если вы используете этот контейнер с контейнером sdr-enthusiasts/docker-readsb-protobuf для предоставления данных ModeS/BEAST, а контейнеры находятся в разных сетях Docker или на разных хостах:
  • Вам необходимо убедиться, что вы открыли порт 30005 (или любой другой порт, через который обслуживаются данные BEAST) в контейнере sdr-enthusiasts/docker-readsb-protobuf.
  • IP-адрес или имя хоста узла Docker, на котором работает контейнер sdr-enthusiasts/docker-readsb-protobuf, следует передать в контейнер sdr-enthusiasts/docker-adsbexchange через переменную среды BEASTHOST , показанную ниже. При необходимости порт можно изменить со значения по умолчанию 30005 с помощью дополнительной переменной среды BEASTPORT .
• Широта и долгота вашей антенны должны быть переданы через переменные среды LAT и LONG соответственно.
• Высота вашей антенны должна быть передана через переменную среды ALT соответственно. По умолчанию используются метры, но единицы измерения могут быть указаны с суффиксом «футы» или «м».
• 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:

 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	Необходимый. IP/имя хоста провайдера Mode-S/BEAST (dump1090)
BEASTPORT	Необязательный. Номер TCP-порта провайдера Mode-S/BEAST (dump1090)	30005
UUID	Необходимый. Ваш статический UUID
LAT	Необходимый. Широта антенны
LONG	Необходимый. Долгота антенны
ALT	Необходимый. Высота антенны над уровнем моря. Если положительное значение (над уровнем моря), оно должно включать суффикс «m» или «ft» для обозначения метров или футов. Если отрицательное значение (ниже уровня моря), суффикса не должно быть, а значение интерпретируется в метрах.
SITENAME	Необходимый. Название вашего сайта (AZ, az, - , _ )
TZ	Необязательный. Ваш местный часовой пояс	GMT
REDUCE_INTERVAL	Необязательный. Как часто данные BeastReduce передаются в 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	Необязательный. Позволяет изменить TCP-порт, на который передаются данные ADS-B.	30005
ADSB_FEED_DESTINATION_TYPE	Необязательный. Позволяет изменить тип выходных данных readsb .	beast_reduce_out
MLAT_FEED_DESTINATION_HOSTNAME	Необязательный. Позволяет изменить имя хоста сервера MLAT.	feed.adsbexchange.com
MLAT_FEED_DESTINATION_PORT	Необязательный. Позволяет изменить TCP-порт сервера MLAT.	31090

Порты

Порт	Цель
30105	Данные MLAT в формате Beast для таких инструментов, как graphs1090 и/или tar1090

Ведение журнала

• Все процессы записываются в стандартный вывод контейнера, и их можно просмотреть с помощью docker logs [-f] container .

Получение помощи

Пожалуйста, не стесняйтесь открыть вопрос на GitHub проекта.

У меня также есть канал Discord, не стесняйтесь присоединяться и общаться.