Nginx学习总结:geo与image模块(四)

斜体下划线,表示建议采用默认配置,无需显式的配置

一、ngx_http_geo_module

    核心特性为:根据客户端IP(段),geo模块将会匹配出指定的变量(比如,国家代码,城市代码)。geo模块可以帮助我们实现如下场景:

    1)简易的CDN网络

    2)多机房部署,站点分流。

    3)limit非法IP(段)的访问,或者限流。

    1、geo 【$address】$variable {...}

        上下文:http

    其中“address”变量是可选的,如果不指定,默认为“$remote_addr”;使用“address”变量值作为客户端IP,参与geo匹配,将匹配的值作为$variable。如果“address”变量不是一个合法的IP地址,那么将使用“255.255.255.255”作为可选值。geo模块中可以使用如下参数:

    1)delete:删除指定的网络。

    2)default:如果客户端IP没有在geo ip列表中匹配到任何信息,那么将使用default指定的值,作为$variable的值。如果没有使用default配置项,且匹配失败时,最终$variable的值为空。

    3)include:指定geo ip列表的外部文件。此文件中声明方式与在geo区块中一样,每行一个“ip”对应一个参数值。

    4)proxy:定义那些可信(trusted)的地址(通常是集群中其他nginx的地址),来自trusted地址的请求,将会使用header中“X-Forwarded-For”字段值,来匹配geo。proxy配置项将会按照声明的顺序检测。 

    5)ranges:表明地址使用区间方式定义,此参数需要在geo区块的首行使用,地址的区间需要按照正序方式声明。

 

geo $country {
    default    US;
    include    conf/geo.conf;
    proxy      192.168.1.0/24;
    ##ip list
    127.0.0.0/24    US;
    10.1.0.0/16      RU;
}
server {
    server_name .exmaple.org;
    $if($country != US) {
        rewrite ^/(.*)$ http://$country.example.org/$! last;
    }
}
server {
    server_name us.example.org;
    location / {
        ....
    }
}

 

geo $country {
    rangs;
    default    US;
    127.0.0.0-127.0.0.0    US;##区间表示,以"-"分割
    127.0.0.1-127.0.0.1    RU;
}

 

二、ngx_http_image_fileter_module

    图片裁剪辅助模块,此模块需要额外的安装,而且安装过程比较复杂,参见【安装过程】。

    1、image_filter

        上下文:location

    图片处理的方式,语法:

    

image_filter off;
image_filter test;
image_filter size;
imagefilter rotate 90 | 180 | 270;
image_filter resize 【width】 【height】;
image_filter crop 【width】 【height】;

    1)off:此location区块中,关闭此module处理。

    2)test:确保响应的图片格式为JPEG、GIF、PNG,否则将返回415错误代码(Unsupported Media Type)。这个参数可以用来检测图片URL是否为“格式良好”的图片。

    3)size:响应输出图片的尺寸信息(而不输出图片流),以json格式,如果出错,则返回空JSON。

{ "img" : { "width": 100, "height": 100, "type": "gif" } }

 

 

    4)rotate 90 | 180 | 270:逆时针旋转图片指定的角度。可选值为“90”、“180”、“270”,这个指令可以单独使用,也可以与“resize”、“crop”一起使用。

    5)resize 【width】【height】:按比例压缩图片的尺寸;如果只希望按照一个维度压缩,另一个维度可以用“_”表示。如果出错,将返回415错误代码。当此参数与rotate一起使用时,那么压缩后太会rotate。resize即为我们常说的“等比压缩”,最终压缩后的图片长、宽都不会超过参数指定的值。

    6)crop 【width】 【height】:裁剪,先按照图片较长的边等比压缩(同resize),然后再使用那个较短的边进行裁剪。如果此有rotate配置,那么先rotate然后再crop。

 

    图片resize、crop时,会抛出415错误,原因排查方式:nginx是否有访问此文件的权限(如果没有,不会抛出403,而是直接415),系统是否安装了相关的Media类型处理lib,图片的大小是否超过了“image_filter_buffer”的大小。

 

    2、image_filter_buffer 【size】

        默认值为“1M”;设置读取图片时所需要的最大内存空间,如果图片大小超过此值,则返回415错误。

    3、image_filter_jpeg_quality 【quality】

        默认值为“75”;jpeg格式的图片压缩质量。质量越低,所传输的数据大小越小;推荐的最大值为95。

    4、image_filter_sharpen 【percent】

        默认值为“0”;增加图片的锐度。“0”表示关闭锐度。

    5、image_filter_transparency 【on | off】

        默认值为“on”;对于PNG、GIF格式的图片,是否保留原始图片的透明度。

server {
    server_name img.example.org;
    location / {
        root www/images;
        image_filter resize $arg_width $arg_height;#请求参数中的width,height
    }
}

 

 

    

你可能感兴趣的:(nginx)