官网地址: https://github.com/3078825/ngx_image_thumb
模块同时支持 Nginx 和 tengine
- 本nginx模块主要功能是对请求的图片进行缩略/水印处理,支持文字水印和图片水印。
- 支持自定义字体,文字大小,水印透明度,水印位置。
- 判断原图是否是否大于指定尺寸才处理。 ....等等
1、下载模块代码,并解压
# cd /usr/local/src
# wget https://codeload.github.com/3078825/ngx_image_thumb/zip/master
# unzip master.zip/
2、重新编译Nginx,同时指定Nginx Image缩略图模块
安装依赖包
# yum install -y gcc automake autoconf m4 gd-devel pcre-devel libcurl-devel
编译安装 Nginx
# cd /usr/local/src
# wget http://nginx.org/download/nginx-1.10.3.tar.gz
# tar -zxvf nginx-1.10.3.tar.gz
# cd nginx-1.10.3
# useradd www -s /sbin/nologin
# ./configure --prefix=/usr/local/nginx --user=www --group=www --with-http_stub_status_module --with-http_ssl_module \
--add-module=../ngx_image_thumb-master
# make && make install
3、Nginx配置
红色):
location / {
root html;
image on;
image_output on;
}
或者指定目录开启
location /upload {
root html;
image on;
image_output on;
}
参数说明:
image on/off 是否开启缩略图功能,默认关闭
image_backend on/off 是否开启镜像服务,当开启该功能时,请求目录不存在的图片(判断原图),将自动从镜像服务器地址下载原图
image_backend_server 镜像服务器地址
image_output on/off 是否不生成图片而直接处理后输出 默认off
image_jpeg_quality 75 生成JPEG图片的质量 默认值75
image_water on/off 是否开启水印功能
image_water_type 0/1 水印类型 0:图片水印 1:文字水印
image_water_min 300 300 图片宽度 300 高度 300 的情况才添加水印
image_water_pos 0-9 水印位置 默认值9 0为随机位置,1为顶端居左,2为顶端居中,3为顶端居右,4为中部居左,5为中部居中,6为中部居右,7为底端居左,8为底端居中,9为底端居右
image_water_file 水印文件(jpg/png/gif),绝对路径或者相对路径的水印图片
image_water_transparent 水印透明度,默认20
image_water_text 水印文字 "Power By Vampire"
image_water_font_size 水印大小 默认 5
image_water_font 文字水印字体文件路径
image_water_color 水印文字颜色,默认 #000000
4、调用方法
在nginx网站根目录存放一个 test.png 文件,然后访问 http://192.168.145.34/test.png,如下图:
访问时加上参数,生成/输出 test.png 300x200 的缩略图,如下图:
http:/192.168.145.34/test.png!c300x200.png
访问时加上参数,生成/输出 test.png 500x400 的缩略图,如下图:
http:/192.168.145.34/test.png!c500x400.png
参数说明:
c 是生成图片缩略图的参数
300 是生成缩略图的宽度
200 是生成缩略图的高度
我们可以生成四种不同类型的缩略图,并支持 jpeg / png / gif (Gif生成后变成静态图片)图片文件。
C 参数按请求宽高比例从图片高度 10% 处开始截取图片,然后缩放/放大到指定尺寸( 图片缩略图大小等于请求的宽高 )
M 参数按请求宽高比例居中截图图片,然后缩放/放大到指定尺寸( 图片缩略图大小等于请求的宽高 )
T 参数按请求宽高比例按比例缩放/放大到指定尺寸( 图片缩略图大小可能小于请求的宽高 )
W 参数按请求宽高比例缩放/放大到指定尺寸,空白处填充白色背景颜色( 图片缩略图大小等于请求的宽高 )