Перейти к содержимому

Astra HTTP Relay

Astra HTTP Relay — это простой встроенный инструмент для ретрансляции данных из любого источника, поддерживаемого Astra, на HTTP-клиент.

astra --relay -p 8000

Аргументы командной строки:

  • -p 8000 — локальный порт для входящих подключений. По умолчанию: 8000;
  • -a 0.0.0.0 — локальный IP-адрес для входящих подключений. По умолчанию 0.0.0.0 — принимать запросы на всех интерфейсах;
  • -l 0.0.0.0 — IP-адрес локального интерфейса для приёма UDP/RTP потоков. По умолчанию 0.0.0.0 — приём потоков согласно системной таблице маршрутизации;
  • --pass login:password — логин и пароль для базовой авторизации для всех запросов;
  • --no-udp — отключить доступ к источнику UDP/RTP;
  • --no-http — отключить доступ к источнику HTTP;
  • --buffer-size 1024 — максимальный размер буфера в килобайтах для каждого клиента. По умолчанию 1024 Кб;
  • --buffer-fill 128 — количество килобайт, которое нужно заполнить в буфере перед началом передачи. По умолчанию 128 Кб;
  • --daemon — запуск в режиме демона;
  • --log /var/log/relay.log — полный путь к файлу журнала;
  • --channels /etc/astra/relay.lua — полный путь к файлу с алиасами каналов.

Адрес запроса имеет следующий формат:

  • http://your-server-address:8000/udp/239.255.1.1:1234 — приём UDP-потока из мультикаст-группы 239.255.1.1:1234
  • http://your-server-address:8000/http/example.com/travel-channel — приём HTTP-потока с http://example.com/travel-channel

Алиасы каналов позволяют использовать короткое имя вместо полного адреса. Пример списка алиасов:

-- /etc/astra/relay.conf
channels = {
["demo"] = "udp://239.255.1.1:1234",
["travel-channel"] = "http://example.com/travel-channel"
}

Запустите relay с указанием пути к списку алиасов:

astra --relay -p 8000 --channels /etc/astra/relay.conf

Каналы из приведённого выше примера будут доступны по адресам:

  • http://your-server-address:8000/demo — UDP-поток
  • http://your-server-address:8000/travel-channel — HTTP-поток

Статистика — это простая страница с активными сессиями, содержащая следующую информацию:

  • IP-адрес клиента
  • Путь запроса — алиас или полный адрес исходного канала
  • Время работы сессии
  • Ссылка для закрытия сессии

Чтобы просмотреть статистику, откройте в браузере: http://your-server-address:8000/stat/