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
    }
}