Skip to main content
Version: 5.0 (Stable) ✅

HLS Edge Cluster Example

Example for HLS Edge Cluster, like to create a CDN to deliver HLS files.

Suppose the server ip is 192.168.1.170

Step 1, Get SRS code

For detail, read GIT

git clone https://github.com/ossrs/srs
cd srs/trunk

Or update the exists code:

git pull

Step 2, Configure and build SRS

For detail, read Build

./configure && make

Step 3, Config origin srs, to generate HLS files

See HLS.

Please use config conf/hls.origin.conf, or create a config file by:

# conf/hls.origin.conf
listen              1935;
max_connections     1000;
daemon              off;
srs_log_tank        console;
http_server {
    enabled         on;
    listen          8080;
}
vhost __defaultVhost__ {
    hls {
        enabled         on;
        hls_ctx off;
        hls_ts_ctx off;
    }
}

Step 4, Config edge NGINX to deliver HLS files.

See Nginx for HLS.

Save bellow as config, or use conf/hls.edge.conf:

# conf/hls.edge.conf
worker_processes  3;
events {
    worker_connections  10240;
}

http {
    # For Proxy Cache.
    proxy_cache_path  /tmp/nginx-cache levels=1:2 keys_zone=srs_cache:8m max_size=1000m inactive=600m;
    proxy_temp_path /tmp/nginx-cache/tmp; 

    server {
        listen       8081;
        # For Proxy Cache.
        proxy_cache_valid  404      10s;
        proxy_cache_lock on;
        proxy_cache_lock_age 300s;
        proxy_cache_lock_timeout 300s;
        proxy_cache_min_uses 1;

        location ~ /.+/.*\.(m3u8)$ {
            proxy_pass http://127.0.0.1:8080$request_uri;
            # For Proxy Cache.
            proxy_cache srs_cache;
            proxy_cache_key $scheme$proxy_host$uri$args;
            proxy_cache_valid  200 302  10s;
        }
        location ~ /.+/.*\.(ts)$ {
            proxy_pass http://127.0.0.1:8080$request_uri;
            # For Proxy Cache.
            proxy_cache srs_cache;
            proxy_cache_key $scheme$proxy_host$uri;
            proxy_cache_valid  200 302  60m;
        }
    }
}

Step 5, Start SRS Origin and NGINX Edge Server

nginx -c $(pwd)/conf/hls.edge.conf
./objs/srs -c conf/hls.origin.conf

Note: Please follow instructions of NGINX to download and install.

Step 6, Publish RTMP stream to SRS Origin, to generate HLS files.

Use FFMPEG to publish stream:

for((;;)); do \
    ./objs/ffmpeg/bin/ffmpeg -re -i ./doc/source.flv \
    -c copy -f flv rtmp://192.168.1.170/live/livestream; \
    sleep 1; \
done

Or use OBS to publish:

Server: rtmp://192.168.1.170/live
StreamKey: livestream

Step 7, Play HLS stream

HLS by SRS Origin: http://192.168.1.170:8080/live/livestream.m3u8

HLS by NGINX Edge: http://192.168.1.170:8081/live/livestream.m3u8

Note: Please replace all ip 192.168.1.170 to your server ip.

Step 8: Benchmark and More NGINX Edge Servers

Please use srs-bench to simulate a set of visitors:

docker run --rm -it --network=host --name sb ossrs/srs:sb \
  ./objs/sb_hls_load -c 100 -r http://192.168.1.170:8081/live/livestream.m3u8

You could run more NGINX from another server, use the same config.

Winlin 2014.11