关于
ngx_image_thumb是nginx中用来生成缩略图的模块,生存缩略图的方法很多,之前也写过一篇 《nginx生成缩略图配置 - ttlsa教程系列之nginx》,在github上发现国人开发的一款模块,作者的文档写的很详细,我便照搬过来了。以后将做一个测试.
特性
本nginx模块主要功能是对请求的图片进行缩略/水印处理,支持文字水印和图片水印。支持自定义字体,文字大小,水印透明度,水印位置,判断原图是否是否大于指定尺寸才处理等等
1. 编译方法
实验环境:
[[email protected] ~]# cat /etc/redhat-release
CentOS release 6.6 (Final)
[[email protected] ~]# uname -m
x86_64
[[email protected] ~]# uname -a
Linux masterserver 2.6.32-504.el6.x86_64 #1 SMP Wed Oct 15 04:27:16 UTC 2014 x86_64 x86_64 x86_64 GNU/Linux
[[email protected] ~]#
# 请确保已经安装了gcc automake autoconf m4
[[email protected] ~]# yum install gd-devel pcre-devel libcurl-devel
[[email protected] ~]# cd /home/opuser/tools/
[[email protected] tools]# wget https://github.com/3078825/nginx-image/archive/master.zip [[email protected] tools]# ll master.zip
-rw-r--r-- 1 root root 14306 Mar 15 17:00 master.zip
[[email protected] tools]#
[[email protected] tools]# ll master.zip
-rw-r--r-- 1 root root 14306 Mar 15 17:00 master.zip
[[email protected] tools]# unzip master.zip
Archive: master.zip
ff2a0177fdec59828a88e2a05f0adb2a432e89a4
creating: ngx_image_thumb-master/
inflating: ngx_image_thumb-master/.gitignore
inflating: ngx_image_thumb-master/README.md
inflating: ngx_image_thumb-master/README_EN.md
inflating: ngx_image_thumb-master/config
inflating: ngx_image_thumb-master/ngx_http_image_module.c
[[email protected] tools]# ll
total 852
-rw-r--r-- 1 root root 14540 Oct 16 02:37 epel-release-6-8.noarch.rpm
-rw-r--r-- 1 root root 14306 Mar 15 17:00 master.zip
-rw-r--r-- 1 root root 828607 Apr 21 2015 nginx-1.7.10.tar.gz
drwxr-xr-x 2 root root 4096 Sep 23 2014 ngx_image_thumb-master
[[email protected] tools]#
#安装nginx加入模块ngx_image_thumb-master
[[email protected] tools]# tar xf nginx-1.7.10.tar.gz
[[email protected] tools]# cd nginx-1.7.10
[[email protected] nginx-1.7.10]# ./configure --add-module=../ngx_image_thumb-master/
[[email protected] nginx-1.7.10]# make && make install
#修改nginx配置文件
[[email protected] nginx-1.7.10]# vim /usr/local/nginx/conf/nginx.conf
location / {
root html;
index index.html index.htm;
#添加以下配置
image on;
image_output on;
}
#检查配置文件是否正确,然后启动nginx
[[email protected] nginx-1.7.10]# /usr/local/nginx/sbin/nginx -t
nginx: the configuration file /usr/local/nginx/conf/nginx.conf syntax is ok
nginx: configuration file /usr/local/nginx/conf/nginx.conf test is successful
[[email protected] nginx-1.7.10]# /usr/local/nginx/sbin/nginx
#模块ngx_image_thumb-master参介绍
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
#调用说明
这里假设你的nginx 访问地址为 http://10.0.0.10/
并在nginx网站根目录存在一个 pit.jpg 的图片
通过访问
http://10.0.0.10/pit.jpg!c300x200.jpg
其中 c 是生成图片缩略图的参数, 300 是生成缩略图的宽度 200 是生成缩略图的高度
一共可以生成四种不同类型的缩略图。
支持 jpeg / png / gif (Gif生成后变成静态图片)
C 参数按请求宽高比例从图片高度 10% 处开始截取图片,然后缩放/放大到指定尺寸( 图片缩略图大小等于请求的宽高 )
M 参数按请求宽高比例居中截图图片,然后缩放/放大到指定尺寸( 图片缩略图大小等于请求的宽高 )
T 参数按请求宽高比例按比例缩放/放大到指定尺寸( 图片缩略图大小可能小于请求的宽高 )
W 参数按请求宽高比例缩放/放大到指定尺寸,空白处填充白色背景颜色( 图片缩略图大小等于请求的宽高 )
5. 调用举例
http://10.0.0.10/pit.jpg!c300x300.jpg
http://10.0.0.10/pit.jpg!t300x300.jpg
http://10.0.0.10/pit.jpg!m300x300.jpg
http://10.0.0.10/pit.jpg!w300x300.jpg
6. 最后
这款模块的缩略图是实时生成的,如果你的网站流量比较大,势必会造成nginx服务器负载过高,针对这个问题,你可以参考我们运维生存时间之前写的几篇文章,分别为存硬盘和redis. 《nginx实时生成缩略图到硬盘上》《srcache_nginx+redis构建缓存系统》
参考文章
项目地址:https://github.com/3078825/nginx-image/
下一篇解决流量大造成nginx负载过高的问题