nginx中文文档-ngx_http_hls_module

ngx_http_hls_module模块为MP4和MOV媒体文件提供HLS服务端支持。

ngx_http_hls_module模块为MP4和MOV媒体文件提供HLS服务端支持,这些文件通常以.mp4,.m4v,.m4a,.mov或.qt扩展名结尾。该模块支持H.264视频编码及AAC和MP3音频编码。
对于每个媒体文件,支持两种URI:

  • 播放列表URI以“.m3u8”扩展名结尾,URI支持可选参数:
    “start”和“end”定义了播放列表的范围,单位为秒(1.9.0+)
    “offset”指定了秒为单位的偏移位置(1.9.0+)。正数表示从开头偏移,负数表示从结尾偏移。
    “len”指定了以秒为单位的分片长度。
  • 分片URI以“.ts”作为扩展名,URI支持可选参数:
    “start”和“end”定义了以秒为单位的分片范围

该模块为商业版本。

示例配置

location / {
    hls;
    hls_fragment            5s;
    hls_buffers             10 10m;
    hls_mp4_buffer_size     1m;
    hls_mp4_max_buffer_size 5m;
    root /var/video/;
}

对于这个配置,下面的URI支持“/var/video/test.mp4”文件:

http://hls.example.com/test.mp4.m3u8?offset=1.000&start=1.000&end=2.200
http://hls.example.com/test.mp4.m3u8?len=8.000
http://hls.example.com/test.mp4.ts?start=1.000&end=2.200

hls

语法:hls
默认:—
上下文:location

在location中开启HLS协议功能。

hls_buffers

语法:hls_buffers number size
默认:hls_buffers 8 2m
上下文:http, server, location

设置读写数据帧的缓冲区最大数量和大小。

hls_forward_args

语法:hls_forward_args on | off
默认:hls_forward_args off
上下文:http, server, location
版本:1.5.12+

从播放列表请求中添加参数到分片URI。这个用于在请求分片或使用ngx_http_secure_link_module模块保护HLS流时处理客户端权限。
例如,如果客户端请求播放列表http://example.com/hls/test.mp4.m3u8?a=1&b=2,参数a=1和b=2会被添加到分片URI开始和结束参数后面:

#EXTM3U
#EXT-X-VERSION:3
#EXT-X-TARGETDURATION:15
#EXT-X-PLAYLIST-TYPE:VOD

#EXTINF:9.333,
test.mp4.ts?start=0.000&end=9.333&a=1&b=2
#EXTINF:7.167,
test.mp4.ts?start=9.333&end=16.500&a=1&b=2
#EXTINF:5.416,
test.mp4.ts?start=16.500&end=21.916&a=1&b=2
#EXTINF:5.500,
test.mp4.ts?start=21.916&end=27.416&a=1&b=2
#EXTINF:15.167,
test.mp4.ts?start=27.416&end=42.583&a=1&b=2
#EXTINF:9.626,
test.mp4.ts?start=42.583&end=52.209&a=1&b=2

#EXT-X-ENDLIST

如果HLS流被ngx_http_secure_link_module模块保护,$uri不会被用在secure_link_md5表达式中,因为这样在请求分片时会出错。应使用基础URI替代$uri(例子中是$hls_uri):

http {
    ...

    map $uri $hls_uri {
        ~^(?.*).m3u8$ $base_uri;
        ~^(?.*).ts$   $base_uri;
        default                 $uri;
    }

    server {
        ...

        location /hls {
            hls;
            hls_forward_args on;

            alias /var/videos;

            secure_link $arg_md5,$arg_expires;
            secure_link_md5 "$secure_link_expires$hls_uri$remote_addr secret";

            if ($secure_link = "") {
                return 403;
            }

            if ($secure_link = "0") {
                return 410;
            }
        }
    }
}

hls_fragment

语法:hls_fragment time
默认:hls_fragment 5s
上下文:http, server, location

定义当请求URI没有len参数时默认的分片长度。

hls_mp4_buffer_size

语法:hls_mp4_buffer_size size
默认:hls_mp4_buffer_size 512k
上下文:http, server, location

设置用于处理MP4和MOV文件的缓冲区的初始大小。

hls_mp4_max_buffer_size

语法:hls_mp4_max_buffer_size size
默认:hls_mp4_max_buffer_size 10m
上下文:http, server, location

在处理媒体信息时,可能需要更大的缓冲区。它的大小不能超过指定的size,否则nginx将会返回500错误码,并记录如下的日志:

"/some/movie/file.mp4" mp4 moov atom is too large:
12583268, you may want to increase hls_mp4_max_buffer_size

nginx中文文档-ngx_http_headers_module

ngx_http_headers_module模块允许向响应头中添加“Expires”、“Cache-Control”以及任意头域。

示例配置

expires    24h;
expires    modified +24h;
expires    @24h;
expires    0;
expires    -1;
expires    epoch;
expires    $expires;
add_header Cache-Control private;

add_header

语法:add_header name value [always]
默认:—
上下文:http, server, location, if in location

为响应码等于200, 201, 204, 206, 301, 302, 303, 304, 或 307的响应增加指定的头域。值可以包含变量。
可以由多个add_header指令。如果当前层级没有add_header指令,则这些指令会被从上级继承。
如果指定了always参数(1.7.5+),会忽略响应码直接添加响应头域。

expires

语法:expires [modified] time
expires epoch | max | off
默认:expires off
上下文:http, server, location, if in location

为响应码等于200, 201, 204, 206, 301, 302, 303, 304, 或 307的响应启用或禁用添加或修改“Expires” 和 “Cache-Control” 字段的功能。参数可以是正数或负数。
“Expires”域中的时间由当前时间和指令中指定的时间之和计算得出。如果modified参数使用了(0.7.0+,0.6.32+),那么计算文件修改时间和指令中时间之和。
另外,可以通过“@”前缀指定一天中的时间(0.7.9+,0.6.34+):
expires @15h30m;
epoch参数相当于绝对时间“Thu, 01 Jan 1970 00:00:01 GMT”。
“Cache-Control”字段的值取决于指定的之间:

  • 时间是负数-“Cache-Control: no-cache”
  • 时间是正数或0-“Cache-Control: max-age=t”,其中t是指令中定义的时间,单位为秒。

max参数设置“Expires”的值为“Thu, 31 Dec 2037 23:55:55 GMT”,“Cache-Control”的值为10年。
off参数禁用了添加或修改“Expires”和“Cache-Control”响应头的功能。
参数的值可以包含变量(1.7.9+):

map $sent_http_content_type $expires {
    default         off;
    application/pdf 42d;
    ~image/         max;
}

expires $expires;