IT 运维专家网 【推广 Nginx 之基础应用教程】 http://www.linuxtone.org
Nginx 常见应用技术指南[Nginx Tips] 第二版
作者:NetSeek http://www.linuxtone.org (IT运维专家网|集群架构|性能调优)
欢迎转载,转载时请务必以超链接形式标明文章原始出处和作者信息及本声明.
首发时间: 2008-11-25 更新时间:2009-1-14
目 录
一、 Nginx 基础知识
二、 Nginx 安装及调试
三、 Nginx Rewrite
四、 Nginx Redirect
五、 Nginx 目录自动加斜线:
六、 Nginx Location
七、 Nginx expires
八、 Nginx 防盗链
九、 Nginx 访问控制
十、 Nginx 日志处理
十一、 Nginx Cache
十二、 Nginx 负载均衡
十三、 Nginx 简单优化
十四、 如何构建高性能的 LEMP 环境
十五、 Nginx 服务监控
十六、 常见问题与错误处理.
十七、 相关资源下载
【前言】：
编写此技术指南在于推广普及NGINX在国内的使用，更方便的帮助大家了解和掌握NGINX
的一些使用技巧。本指南很多技巧来自于网络和工作中或网络上朋友们问我的问题.在此对
网络上愿意分享的朋友们
表
关于同志近三年现实表现材料材料类招标技术评分表图表与交易pdf视力表打印pdf用图表说话 pdf
示感谢和致意！欢迎大家和我一起丰富本技术指南提出更好的建
议！请朋友们关注: http://www.linuxtone.org 技术分享社区! 互想学习共同进步!
一、 Nginx 基础知识
1、简介
Nginx ("engine x") 是一个高性能的 HTTP 和 反向代理 服务器，也是一个 IMAP/POP3/SMTP 代理服
务器。 Nginx 是由 Igor Sysoev 为俄罗斯访问量第二的 Rambler.ru 站点开发的，它已经在该站点运行超
过两年半了。Igor 将源代码以类BSD许可证的形式发布。尽管还是测试版，但是，Nginx 已经因为它的稳
定性、丰富的功能集、示例配置文件和低系统资源的消耗而闻名了。
更多的请见官方wiki: http://wiki.codemongers.com/
2、 Nginx 的优点
nginx 做为 HTTP 服务器，有以下几项基本特性：
1) 处理静态文件，索引文件以及自动索引；打开文件描述符缓冲．
——————————————————————————————————————————————
期待您的加入我们!一起建立最好的技术分享社区! Gmail:cnseek@gmail.com/MSN:cnseek@msn.com
IT 运维专家网 【推广 Nginx 之基础应用教程】 http://www.linuxtone.org
2) 无缓存的反向代理加速，简单的负载均衡和容错．
3) FastCGI，简单的负载均衡和容错．
4) 模块化的结构。包括 gzipping, byte ranges, chunked responses, 以及 SSI-filter 等 filter。
如果由 FastCGI 或其它代理服务器处理单页中存在的多个 SSI，则这项处理可以并行运行，而不
需要相互等待。
5) 支持 SSL 和 TLS SNI．
Nginx 专为性能优化而开发，性能是其最重要的考量, 实现上非常注重效率 。它支持内核 Poll 模型，
能经受高负载的考验, 有报告表明能支持高达 50,000 个并发连接数。
Nginx 具有很高的稳定性。其它 HTTP 服务器，当遇到访问的峰值，或者有人恶意发起慢速连接时，
也很可能会导致服务器物理内存耗尽频繁交换，失去响应，只能重启服务器。例如当前 apache 一旦上到
200 个以上进程，web 响应速度就明显非常缓慢了。而 Nginx 采取了分阶段资源分配技术，使得它的 CPU 与
内存占用率非常低。nginx 官方表示保持 10,000 个没有活动的连接，它只占 2.5M 内存，所以类似 DOS 这
样的攻击对 nginx 来说基本上是毫无用处的。就稳定性而言, nginx 比 lighthttpd 更胜一筹。
Nginx 支持热部署。它的启动特别容易, 并且几乎可以做到 7*24 不间断运行，即使运行数个月也不
需要重新启动。你还能够在不间断服务的情况下，对软件版本进行进行升级。
Nginx 采用 master-slave 模型, 能够充分利用 SMP 的优势，且能够减少工作进程在磁盘 I/O 的阻
塞延迟。当采用 select()/poll()调用时，还可以限制每个进程的连接数。
Nginx 代码质量非常高，代码很规范， 手法成熟， 模块扩展也很容易。特别值得一提的是强大
的 Upstream 与 Filter 链。 Upstream 为诸如 reverse proxy, 与其他服务器通信模块的编写奠定了很好的
基础。而 Filter 链最酷的部分就是各个 filter 不必等待前一个 filter 执行完毕。它可以把前一个 filter
的输出做为当前 filter 的输入，这有点像 Unix 的管线。这意味着，一个模块可以开始压缩从后端服务器
发送过来的请求，且可以在模块接收完后端服务器的整个请求之前把压缩流转向客户端。
Nginx 采用了一些 os 提供的最新特性如对 sendfile (Linux 2.2+)，accept-filter (FreeBSD
4.1+)，TCP_DEFER_ACCEPT (Linux 2.4+) 的支持，从而大大提高了性能
二、 Nginx 安装及调试
1、Pcre 安装
./configure
make && make install
cd ../
2. nginx 编译安装
/configure --user=www --group=www --prefix=/usr/local/nginx/ --with-http_stub_status_module
--with-openssl=/usr/local/openssl
make && make install
更详细的模块定制与安装请参照官方 wiki.
——————————————————————————————————————————————
期待您的加入我们!一起建立最好的技术分享社区! Gmail:cnseek@gmail.com/MSN:cnseek@msn.com
IT 运维专家网 【推广 Nginx 之基础应用教程】 http://www.linuxtone.org
3、Nginx 配置文件测试：
# /usr/local/nginx/sbin/nginx -t //Debug 配置文件的关键命令需要重点撑握.
2008/12/16 09:08:35 [info] 28412#0: the configuration file /usr/local/nginx/conf/nginx.conf
syntax is ok
2008/12/16 09:08:35 [info] 28412#0: the configuration file /usr/local/nginx/conf/nginx.conf was
tested successfully
3、 Nginx 启动：
# /usr/local/nginx/sbin/nginx
4、 Nginx 配置文件修改重新加载：
# kill -HUP `cat /usr/local/nginx/logs/nginx.pid
`
三、 Nginx Rewrite
1. Nginx Rewrite 基本标记(flags)
last - 基本上都用这个 Flag。
※相当于 Apache 里的[L]标记，表示完成 rewrite，不再匹配后面的规则
break - 中止 Rewirte，不再继续匹配
redirect - 返回临时重定向的 HTTP 状态 302
permanent - 返回永久重定向的 HTTP 状态 301
※原有的 url 支持正则 重写的 url 不支持正则
2. 正则表达式匹配，其中：
* ~ 为区分大小写匹配
* ~* 为不区分大小写匹配
* !~和!~* 分别为区分大小写不匹配及不区分大小写不匹配
3. 文件及目录匹配，其中：
* -f 和!-f 用来判断是否存在文件
* -d 和!-d 用来判断是否存在目录
* -e 和!-e 用来判断是否存在文件或目录
* -x 和!-x 用来判断文件是否可执行
3. Nginx 的一些可用的全局变量，可用做条件判断：
$args
$content_length
——————————————————————————————————————————————
期待您的加入我们!一起建立最好的技术分享社区! Gmail:cnseek@gmail.com/MSN:cnseek@msn.com
IT 运维专家网 【推广 Nginx 之基础应用教程】 http://www.linuxtone.org
$content_type
$document_root
$document_uri
$host
$http_user_agent
$http_cookie
$limit_rate
$request_body_file
$request_method
$remote_addr
$remote_port
$remote_user
$request_filename
$request_uri
$query_string
$scheme
$server_protocol
$server_addr
$server_name
$server_port
$uri
四、 Nginx Redirect
将所有linuxtone.org与netseek.linuxtone.org域名全部自跳转到http://www.linuxtone.org
server
{
listen 80;
server_name linuxtone.org netseek.linuxtone.org;
index index.html index.php;
root /data/www/wwwroot;
if ($host !~ "^www\.linxtone\.org$") {
rewrite ^(.*) http://www.linuxtone.org$1 redirect;
}
........................
}
五、 Nginx 目录自动加斜线:
if (-d $request_filename){
rewrite ^/(.*)([^/])$ http://$host/$1$2/ permanent;
}
——————————————————————————————————————————————
期待您的加入我们!一起建立最好的技术分享社区! Gmail:cnseek@gmail.com/MSN:cnseek@msn.com
IT 运维专家网 【推广 Nginx 之基础应用教程】 http://www.linuxtone.org
六、 Nginx Location
1．基本语法:[和上面 rewrite 正则匹配语法基本一致]
location [=|~|~*|^~] /uri/ { … }
* ~ 为区分大小写匹配
* ~* 为不区分大小写匹配
* !~和!~*分别为区分大小写不匹配及不区分大小写不匹配
示例 1:
location = / {
# matches the query / only.
# 只匹配 / 查询。
}
匹配任何查询，因为所有请求都已 / 开头。但是正则表达式规则和长的块规则将被优
先和查询匹配
示例 2:
location ^~ /images/ {
# matches any query beginning with /images/ and halts searching,
# so regular expressions will not be checked.
# 匹配任何已 /images/ 开头的任何查询并且停止搜索。任何正则表达式将不会被测试。
示例 3:
location ~* \.(gif|jpg|jpeg)$ {
# matches any request ending in gif, jpg, or jpeg. However, all
# requests to the /images/ directory will be handled by
}
# 匹配任何已 gif、jpg 或 jpeg 结尾的请求。
七、 Nginx expires
1．根据文件类型 expires
# Add expires header for static content
location ~* \.(js|css|jpg|jpeg|gif|png|swf)$ {
if (-f $request_filename) {
root /data/www/wwwroot/bbs;
expires 1d;
break;
}
}
——————————————————————————————————————————————
期待您的加入我们!一起建立最好的技术分享社区! Gmail:cnseek@gmail.com/MSN:cnseek@msn.com
IT 运维专家网 【推广 Nginx 之基础应用教程】 http://www.linuxtone.org
2、根据判断某个目录
# serve static files
location ~ ^/(images|javascript|js|css|flash|media|static)/ {
root /data/www/wwwroot/down;
expires 30d;
}
八、 Nginx 防盗链
1. 针对不同的文件类型
#Preventing hot linking of images and other file types
location ~* ^.+\.(gif|jpg|png|swf|flv|rar|zip)$ {
valid_referers none blocked server_names *.linuxtone.org linuxtone.org http://localhost
baidu.com;
if ($invalid_referer) {
rewrite ^/ http://www.linuxtone.org/images/default/logo.gif;
# return 403;
}
}
2. 针对不同的目录
location /img/ {
root /data/www/wwwroot/bbs/img/;
valid_referers none blocked server_names *.linuxtone.org http://localhost baidu.com;
if ($invalid_referer) {
rewrite ^/ http://www.linuxtone.org/images/default/logo.gif;
#return 403;
}
}
3. 同实现防盗链和 expires 的方法
#Preventing hot linking of images and other file types
location ~* ^.+\.(gif|jpg|png|swf|flv|rar|zip)$ {
valid_referers none blocked server_names *.linuxtone.org linuxtone.org http://localhost ;
if ($invalid_referer) {
rewrite ^/ http://www.linuxtone.org/images/default/logo.gif;
}
access_log off;
root /data/www/wwwroot/bbs;
expires 1d;
break;
}
——————————————————————————————————————————————
期待您的加入我们!一起建立最好的技术分享社区! Gmail:cnseek@gmail.com/MSN:cnseek@msn.com
IT 运维专家网 【推广 Nginx 之基础应用教程】 http://www.linuxtone.org
九、 Nginx 访问控制
1. Nginx 身份证验证
#cd /usr/local/nginx/conf
#mkdir htpasswd
/usr/local/apache2/bin/htpasswd -c /usr/local/nginx/conf/htpasswd/tongji linuxtone
#添加用户名为 linuxtone
New password: (此处输入你的密码)
Re-type new password: (再次输入你的密码)
Adding password for user
http://count.linuxtone.org/tongji/data/index.html(目录存在 /data/www/wwwroot/tongji/data/目录
下)
将下段配置放到虚拟主机目录，当访问 http://count.linuxtone/tongji/即提示要密验证:
location ~ ^/(tongji)/ {
root /data/www/wwwroot/count;
auth_basic "LT-COUNT-TongJi";
auth_basic_user_file /usr/local/nginx/conf/htpasswd/tongji;
}
2. Nginx 禁止访问某类型的文件.
如，Nginx 下禁止访问*.txt 文件，配置方法如下.
location ~* \.(txt|doc)$ {
if (-f $request_filename) {
root /data/www/wwwroot/linuxtone/test;
#rewrite …..可以重定向到某个 URL
break;
}
}
方法 2:
location ~* \.(txt|doc)${
root /data/www/wwwroot/linuxtone/test;
deny all;
}
实例:
禁止访问某个目录
location ~ ^/(WEB-INF)/ {
deny all;
}
——————————————————————————————————————————————
期待您的加入我们!一起建立最好的技术分享社区! Gmail:cnseek@gmail.com/MSN:cnseek@msn.com
IT 运维专家网 【推广 Nginx 之基础应用教程】 http://www.linuxtone.org
3. 使用 ngx_http_access_module 限制 ip 访问
location / {
deny 192.168.1.1;
allow 192.168.1.0/24;
allow 10.1.1.0/16;
deny all;
}
详细参见wiki: http://wiki.codemongers.com/NginxHttpAccessModule#allow
4. Nginx 下载限制并发和速率
limit_zone linuxtone $binary_remote_addr 10m;
server
{
listen 80;
server_name down.linuxotne.org;
index index.html index.htm index.php;
root /data/www/wwwroot/down;
#Zone limit
location / {
limit_conn linuxtone 1;
limit_rate 20k;
}
..........
}
只允许客房端一个线程,每个线程 20k.
【注】limit_zone linuxtone $binary_remote_addr 10m; 这个可以定义在主的
5. Nginx 实现 Apache 一样目录列表
location / {
autoindex on;
}
6. 上文件大小限制
主配置文件里加入如下，具体大小根据你自己的业务做调整。
client_max_body_size 10m;
十、 Nginx 日志处理
1.Nginx 日志切割
#contab -e
——————————————————————————————————————————————
期待您的加入我们!一起建立最好的技术分享社区! Gmail:cnseek@gmail.com/MSN:cnseek@msn.com
IT 运维专家网 【推广 Nginx 之基础应用教程】 http://www.linuxtone.org
59 23 * * * /usr/local/sbin/logcron.sh /dev/null 2>&1
[root@count ~]# cat /usr/local/sbin/logcron.sh
#!/bin/bash
log_dir="/data/logs"
time=`date +%Y%m%d`
/bin/mv ${log_dir}/access_linuxtone.org.log ${log_dir}/access_count.linuxtone.org.$time.log
kill -USR1 `cat /var/run/nginx.pid`
更多的日志分析与处理就关注(同时欢迎你参加讨论):http://bbs.linuxtone.org/forum-8-1.html
2.利用 AWSTATS 分析 NGINX 日志
设置好 Nginx 日志
格式
pdf格式笔记格式下载页码格式下载公文格式下载简报格式下载
,仍后利用 awstats 进行分析.
请参考: http://bbs.linuxtone.org/thread-56-1-1.html
3. Nginx 如何不记录部分日志
日志太多，每天好几个 G，少记录一些，下面的配置写到 server{}段中就可以了
location ~ .*\.(js|jpg|JPG|jpeg|JPEG|css|bmp|gif|GIF)$
{
access_log off;
}
十一、Nginx Cache 服务配置
如果需要将文件缓存到本地，则需要增加如下几个子参数：
proxy_store on;
proxy_store_access user:rw group:rw all:rw;
proxy_temp_path 缓存目录;
其中，
proxy_store on 用来启用缓存到本地的功能，
proxy_temp_path 用来指定缓存在哪个目录下，如：proxy_temp_path html;
在经过上一步配置之后，虽然文件被缓存到了本地磁盘上，但每次请求仍会向远端拉取
文件，为了避免去远端拉取文件，必须修改 proxy_pass：
if ( !-e $request_filename) {
proxy_pass http://mysvr;
}
即改成有条件地去执行 proxy_pass ，这个条件就是当请求的文件在本地的
proxy_temp_path 指定的目录下不存在时，再向后端拉取。
更多更高级的应用可以研究ncache，官方网站: http://code.google.com/p/ncache/
详细安装请参照http://bbs.linuxtone.org 应用加速版ncache相关的贴子.
——————————————————————————————————————————————
期待您的加入我们!一起建立最好的技术分享社区! Gmail:cnseek@gmail.com/MSN:cnseek@msn.com
IT 运维专家网 【推广 Nginx 之基础应用教程】 http://www.linuxtone.org
十二、Nginx 负载均衡
1. Nginx 负载均衡基础知识
nginx 的 upstream 目前支持 4 种方式的分配
1)、轮询（默认）
每个请求按时间顺序逐一分配到不同的后端服务器，如果后端服务器 down 掉，能自动剔除。
2)、weight
指定轮询几率，weight 和访问比率成正比，用于后端服务器性能不均的情况。
2)、ip_hash
每个请求按访问 ip 的 hash 结果分配，这样每个访客固定访问一个后端服务器，可以解决 session 的问题。
3)、fair（第三方）
按后端服务器的响应时间来分配请求，响应时间短的优先分配。
4)、url_hash（第三方）
2. Nginx 负载均衡实例 1
upstream bbs.linuxtone.org {#定义负载均衡设备的 Ip 及设备状态
server 127.0.0.1:9090 down;
server 127.0.0.1:8080 weight=2;
server 127.0.0.1:6060;
server 127.0.0.1:7070 backup;
}
在需要使用负载均衡的 server 中增加
proxy_pass http://bbs.linuxtone.org/;
每个设备的状态设置为:
a) down 表示单前的 server 暂时不参与负载
b) weight 默认为 1.weight 越大，负载的权重就越大。
c) max_fails ：允许请求失败的次数默认为 1.当超过最大次数时，返回 proxy_next_upstream 模
块定义的错误
d) fail_timeout:max_fails 次失败后，暂停的时间。
e) backup： 其它所有的非 backup 机器 down 或者忙的时候，请求 backup 机器。所以这台机器
压力会最轻。
nginx 支持同时设置多组的负载均衡，用来给不用的 server 来使用。
client_body_in_file_only 设置为On 可以讲 client post过来的数据记录到文件中用来做 debug
client_body_temp_path 设置记录文件的目录 可以设置最多 3 层目录
location 对 URL 进行匹配.可以进行重定向或者进行新的代理 负载均衡
3. Nginx 负载均衡实例 2
按访问 url 的 hash 结果来分配请求，使每个 url 定向到同一个后端服务器，后端服务器为缓
存时比较有效,也可以用作提高 Squid 缓存命中率.
——————————————————————————————————————————————
期待您的加入我们!一起建立最好的技术分享社区! Gmail:cnseek@gmail.com/MSN:cnseek@msn.com
IT 运维专家网 【推广 Nginx 之基础应用教程】 http://www.linuxtone.org
简单的负载均等实例:
#vi nginx.conf //nginx 主配置文件核心配置
……….
#loadblance my.linuxtone.org
upstream my.linuxtone.org {
ip_hash;
server 127.0.0.1:8080;
server 192.168.169.136:8080;
server 219.101.75.138:8080;
server 192.168.169.117;
server 192.168.169.118;
server 192.168.169.119;
}
…………..
include vhosts/linuxtone_lb.conf;
………
# vi proxy.conf
proxy_redirect off;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
client_max_body_size 50m;
client_body_buffer_size 256k;
proxy_connect_timeout 30;
proxy_send_timeout 30;
proxy_read_timeout 60;
proxy_buffer_size 4k;
proxy_buffers 4 32k;
proxy_busy_buffers_size 64k;
proxy_temp_file_write_size 64k;
proxy_next_upstream error timeout invalid_header http_500 http_503 http_404;
proxy_max_temp_file_size 128m;
proxy_store on;
proxy_store_access user:rw group:rw all:r;
#nginx cache
#client_body_temp_path /data/nginx_cache/client_body 1 2;
proxy_temp_path /data/nginx_cache/proxy_temp 1 2;
#vi linuxtone_lb.conf
server
{
listen 80;
——————————————————————————————————————————————
期待您的加入我们!一起建立最好的技术分享社区! Gmail:cnseek@gmail.com/MSN:cnseek@msn.com
IT 运维专家网 【推广 Nginx 之基础应用教程】 http://www.linuxtone.org
server_name my.linuxtone.org;
index index.php;
root /data/www/wwwroot/mylinuxtone;
if (-f $request_filename) {
break;
}
if (-f $request_filename/index.php) {
rewrite (.*) $1/index.php break;
}
error_page 403 http://my.linuxtone.org/member.php?m=user&a=login;
location / {
if ( !-e $request_filename) {
proxy_pass http://my.linuxtone.org;
break;
}
include /usr/local/nginx/conf/proxy.conf;
}
}
十三、Nginx 简单优化
1. 减小 nginx 编译后的文件大小 (Reduce file size of nginx)
默认的 nginx 编译选项里居然是用 debug 模式(-g)的（debug 模式会插入很多跟踪和
ASSERT 之类），编译以后一个 nginx 有好几兆。去掉 nginx 的 debug 模式编译，编译以
后只有几百 K
在 auto/cc/gcc，最后几行有：
# debug
CFLAGS=”$CFLAGS -g”
注释掉或删掉这几行，重新编译即可。
2. 修改 Nginx 的 header 伪装服务器
1) 修改 nginx.h
#vi nginx-0.7.30/src/core/nginx.h
#define NGINX_VERSION "1.8"
#define NGINX_VER "LTWS/" NGINX_VERSION
#define NGINX_VAR "NGINX"
#define NGX_OLDPID_EXT ".oldbin"
2) 修改 nginx_http_header_filter_module
#vi nginx-0.7.30/src/http/ngx_http_header_filter_module.c
将如下
static char ngx_http_server_string[] = "Server: nginx" CRLF;
——————————————————————————————————————————————
期待您的加入我们!一起建立最好的技术分享社区! Gmail:cnseek@gmail.com/MSN:cnseek@msn.com
IT 运维专家网 【推广 Nginx 之基础应用教程】 http://www.linuxtone.org
修改为
static char ngx_http_server_string[] = "Server: LTWS" CRLF;
a) 修改 nginx_http_header_filter_module
#vi nginx-0.7.30/src/http/ngx_http_special_response.c
将如下：
static u_char ngx_http_error_full_tail[] =
"
" NGINX_VER "" CRLF
"
![Nginx+常见应用技术指南[Nginx+Tips]+第二版](https://swf.iask.com/724pHNgQIN9.svg?ssig=2IaTeRvngp&Expires=1719255110&KID=sina,ishare&range=0-308255)
