标签： 官方文档

该模块默认不会构建，需要通过–with-http_image_filter_module参数开启。
该模块使用libgd库，建议使用最新的版本。

示例配置

location /img/ {
    proxy_pass   http://backend;
    image_filter resize 150 100;
    image_filter rotate 90;
    error_page   415 = /empty;
}

location = /empty {
    empty_gif;
}

image_filter

语法：image_filter off
image_filter test
image_filter size
image_filter rotate 90 | 180 | 270
image_filter resize width height
image_filter crop width height
默认：image_filter off
上下文：location

设置转换操作类型：
off
关闭转换

test
确保响应图片是JPEG、GIF或PNG格式，否则返回415错误码。

size
以JSON格式输出图片的信息，例如：
{ "img" : { "width": 100, "height": 100, "type": "gif" } }
如果有错误，输出：
{}

rotate
顺时针旋转指定角度。参数值可以包含变量。这个模式可以单独使用也可以和resize、crop变换同时使用。

resize width height
按比例对图像进行缩放，可以只指定一个尺寸，另一个尺寸用“-”。如果遇到错误，服务器返回415错误码。参数值可以包含变量。当与rotate参数一同使用时，旋转操作发生在缩放之后。

crop width height
按比例裁剪图片，可以只指定一个尺寸，另一个尺寸用“-”。如果遇到错误，服务器返回415错误码。参数值可以包含变量。当与rotate参数一同使用时，旋转操作发生在裁剪之前。

image_filter_buffer

语法：image_filter_buffer size
默认：image_filter_buffer 1M
上下文：http, server, location

设置读取图片的最大缓冲区大小。当超过缓冲区大小时，服务器返回415错误码。

image_filter_interlace

语法：image_filter_interlace on | off
默认：image_filter_interlace off
上下文：http, server, location
版本：1.3.15+

如果开启此功能，最终的图像是交错的。对于JPEG，最终图片是“渐进式JPEG”格式。

image_filter_jpeg_quality

语法：image_filter_jpeg_quality quality
默认：image_filter_jpeg_quality 75
上下文：http, server, location

设置转为JPEG图像的质量。接受的值从1到100。较小的值意味着低质的图片质量和更少的数据传输量。最大建议的值是95。参数可以包含变量。

image_filter_sharpen

语法：image_filter_sharpen percent
默认：image_filter_sharpen 0
上下文：http, server, location

增加最终图片的锐度。这个百分比可以超过100。0值禁用此功能。参数可以包含变量。

image_filter_transparency

语法：image_filter_transparency on|off
默认：image_filter_transparency on
上下文：http, server, location

决定在转换GIF或PNG图片带有调色板定义的颜色时，透明是否会保留。丢失透明度可以是图片得到更好的质量。PNG的Alpha通道的透明总是会保留。

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