Astra HTTP Relay

Astra HTTP Relay is a simple built-in tool to retransmit data from any source supported by Astra to HTTP client.

Usage

astra --relay -p 8000

Command line arguments:

-p 8000 - local port for incomming connections. Default: 8000;
-a 0.0.0.0 - local IP address for incomming connections. Default 0.0.0.0 - accept request on any interface;
-l 0.0.0.0 - IP address of the local interface to receive UDP/RTP streams. Default 0.0.0.0 - receives streams according to system routing table;
--pass login:password - login and password for basic authorization for all requests;
--no-udp - disable access to the UDP/RTP source;
--no-http - disable access to the HTTP source;
--buffer-size 1024 — the maximum buffer size in kilbytes for each client. Default 1024Kb;
--buffer-fill 128 — defines number of kilobytes to fill in buffer before start transmission. Default 128Kb;
--daemon - start in daemon mode;
--log /var/log/relay.log - full path to the log file;
--channels /etc/astra/relay.lua - full path to the channel aliases.

Request address has next format:

http://your-server-address:8000/udp/239.255.1.1:1234 - receives UDP stream from multicast group 239.255.1.1:1234
http://your-server-address:8000/http/example.com/travel-channel - receives HTTP stream from http://example.com/travel-channel

Channel aslias let to use short name instead of full address. Alias list example:

-- /etc/astra/relay.conf

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

Launch relay with path to the alias list:

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

Channels from example above will be availble on:

Statistics is a simple page with active sessions contain next information:

To view statistics, open in your browser: http://your-server-address:8000/stat/