nginx中文文档-ngx_http_index_module

ngx_http_index_module模块处理以斜杠“/”结尾的请求。这些请求也可以被ngx_http_autoindex_module和ngx_http_random_index_module模块处理。

示例配置

location / {
    index index.$geo.html index.html;
}

index

语法:index file
默认:index index.html
上下文:http, server, location

定义一个作为索引的文件。file可以包含变量。文件将按照指定的顺序检查。列表中最后一个元素可以是一个文件的绝对路径,例如:
index index.$geo.html index.0.html /index.html
需要注意的是,使用索引文件会产生内部重定向,请求会被一个不同的location处理。例如,下面的配置:

location = / {
    index index.html;
}

location / {
    ...
}

“/”请求将会实际会作为“/index.html”处理。

nginx中文文档-ngx_http_image_filter_module

ngx_http_image_filter_module模块(0.7.54+)是一个将图片转为JPEG、GIF、PNG格式的过滤器。

该模块默认不会构建,需要通过–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通道的透明总是会保留。