1. 概述

大家都知道Nginx有很多功能模块，比如反向代理、缓存等，这篇文章总结下我们这些年实际环境中那些有用的Nginx规则和模块，大部分是用法的概括及介绍，具体细节在实际配置时再自行google。

2. 内置语法

先介绍Nginx默认已支持的内置功能，靠这些基本就满足大部分的web服务需求。

2.1 proxy代理

proxy常用于两类应用场景，一类是中转，如异地科学的上网方式，另外一类是到后端服务的负载均衡方案。

用反向代理时候，需要特别注意里面的域名默认是在nginx启动时候就解析了，除非reload否则一直用的是当初解析的域名，也就是说不能动态解析。

但这个问题是可以通过别的模块或者用内置字典变量方式来解决。

r s } e e l s p } s r o e r o v c t o l e a x v r t $ y e i s _ r { o e p n r a 1 s 1 / e s 4 r . { s h 1 t 1 g t 4 i p . t : 1 h / 1 u / 4 b $ . . s 1 c e 1 o r 4 m v ; ; e r s ;

2.1.1 中转

针对某个域名进行中转：

s l } e i s l p p p } r s e o r r r v t r c o o o e e v a x x x r n e t y y y r i _ _ _ { 1 _ o s r p 7 n n e e a 2 a t d s . m ~ _ i s 1 e h r 6 / e e h . p s a c t 1 y i d t t 0 p m e p . i p r o : 1 . l f / : p e H f / 8 y o ; p 0 t { s y ; h t p o i n $ . . h p o t y r t t g p h ; _ o h n o . s o t r ; g ;

注意如果是前后端域名不一样的话需要处理proxy_redirect的301跳转之类的显示，否则在跳转时候会跳转到proxy_pass的域名。

另外可以直接代理所有80端口的http流量：

s } e l s r s l p } r i e e e o r v s r s t c o e t v o a x r e e l $ t y n r v U i _ { _ e R o p 8 n r L n a 0 a s ; m 1 $ / s e 1 h 4 o { h _ . s t ; 1 t t 1 ; p 4 : . / 1 / 1 $ 4 U . R 1 L 1 ; 4 ;

如果是想代理https的站点也不是不可能，只是需要自行处理CA证书导入即可，而且经过https中转的流量对nginx是透明的，也就是有证书的时候做窃听和劫持的情况。

2.1.2 负载均衡

这是代理的另外一个常见用法，通过upstream到多个后端，可以通过weight来调节权重或者backup关键词来指定备份用的后端，通常默认就可以 了，或者可以指定类似ip_hash这样的方式来均衡，配置很简单，先在http区域添加upstream定义：

u } p i s s s p e e t _ r r r h v v e a e e a s r r m h ; b b b a a a c c c k k k e e e n n n d d d 1 2 . . { e e x x a a m m p p l l e e . . c c o o m m w w e e i i g g h h t t = = 5 5 ; ; ;

然后在server里面添加proxy_pass：

l } o p p p c r r r a o o o t x x x i y y y o _ _ _ n p h s a t e / s t t s p _ { _ h h v e t e a t r d p s e : i r / n C b o a 1 n c . n k 1 e e ; c n t d i ; o n " " ;

做负载均衡的时候可以智能识别后端服务器状态，虽然可以智能地proxy_next_upstream到另外的后端，但还是会定期损失一些正常的“尝试性”的连接，比如过了max_fails 次尝试之后，休息fail_timeout时间，过了这个时间之后又会去尝试，这个时候可以使用第三方的upstream_check模块来在后台定期地自动探索，类似这样：

c h e c k i n t e r v a l = 3 0 0 0 r i s e = 2 f a l l = 5 t i m e o u t = 2 0 0 0 t y p e = h t t p ;

这样替代用户正常的连接来进行尝试的方式进一步保障了高可用的特性。

还有就是在做前端代理的时候也是这样的方式，直接proxy_pass到后端即可，比如CDN的场景。

2.2 防盗链

普通的防盗链是通过referer来做，比如：

l } o v i r } c a f e a l t t i ( u i d $ r o _ i n n r n e v 4 ~ f a 0 * e l 3 r i ; e d r _ ( s r g e i n f f o e | n r j e e p r g b ) | l p o { n c g k | e b d m p ) . $ e x { a m p l e . c o m s e r v e r _ n a m e s ~ \ . g o o g l e \ . ~ \ . b a i d u \ . ;

再精细一点的就是URL加密，针对一些用户IP之类的变量生成一个加密URL通常是针对文件下载时候用到，可以通过openresty来写lua脚本或者是accesskey之类的模块来实现。

2.3 变量

nginx里面支持正则匹配和变量配置，默认的变量比如remote_addr、request_filename、query_string、server_name之类的，这些组合在一起可以做很多规则，或者还有日志里面status、http_cookie等。

还有在进行多域名配置时候可以用通配符，比如：

s r e o r o v t e r / _ d n a a t m a e / w ~ e ^ b ( / w $ w 2 w ; \ . ) ? ( . + ) $ ;

这样就实现了自动进行域名的目录指派。

变量方面，比如配置变量a=1：

s e t $ a 1 ;

下面这个案例配合if判断来做有更大的用处。

2.4 if判断

nginx里面支持一些简单的if判断，但是没有多重逻辑的语法，多个判断条件用起来需要结合变量的方式来实现，比如允许ip地址为10.10.61段和和192.168.100段的用户访问，其余的拒绝，返回405状态码：

s e i s } i s } i r } t f e f e f e t t t $ ( ( ( u e $ $ r r $ e $ e $ n r r r r r e e r e r r 4 0 m m r 0 ; o 0 o 0 5 t ; t ; = ; e e _ _ 1 a a ) d d { d d r r ~ ~ 1 1 0 9 . 2 1 . 0 1 . 6 6 8 1 . . 1 ) 0 { 0 . ) {

这样通过一个err变量比较巧妙实现了需求。

2.5 error_page

有用到后端proxy的地方需要加上这句话才可以传到状态码到nginx：

f a s t c g i _ i n t e r c e p t _ e r r o r s o n ;

具体配置一般是配置到具体的错误URL页面，比如：

1
2
3
4

#返回具体状态码
error_page 404 403 /4xx.html
#返回200状态码
error_page 404 403 =200 /error.html

或者采用callback的方式统一做处理：

e l } r o p a r c r c o a o c r t x e _ i y s p o _ s a n p _ g a l e @ s o f s g 4 a 0 l h / 4 l t d b t a 4 a p t 0 c : a 3 k / l = { b o a g @ c s f k / a e 4 l n 0 l d 4 b ; _ a e c r k r ; o r . l o g a c c e s s ;

这样在重定向时不会改变URL，然后把404页面直接返回。

2.6 rewrite

rewrite做一些301、302之类的跳转，同时也可以在CDN前端做“去问号”缓存的效果。

l } o r i c e n a w c t r l i i u o t d n e e / p d r b o . x t y x $ . t 1 c ? o { n b f r ; e a k ;

另外最常见的跳转写法：

r e w r i t e / g a m e / ( . * ) / $ 1 ;

把/game/test跳转为/test的效果，注意这样是没有状态码的，如果访问正常就直接返回200状态码。

可以在后面加个permanent参数，就变为了301 Moved Permanently，或者添加redirect改为302跳转。

同理，还可以进行多个正则匹配进行URL重组，比如：

r e w r i t e / d o w n l o a d / ( . * ) / l a s t e s t / ( . * ) $ / f i l e / $ 1 ? v e r = $ 2 b r e a k ;

2.7 日志字段

想针对每个连接进行日志留档，可以在nginx日志那里配置好字段，比如记录cookie之类的数据。

在log_format字段里面加入$http_cookie变量即可。

另外post的数据可以永久保留在文件里面，比如用来做http的日志备份，包括get和post的原始数据，把这个值开启即可：

c l i e n t _ b o d y _ i n _ f i l e _ o n l y o n ;

然后post的数据就会保存在nginx/client_body_temp文件夹里面。

2.8 internal关键词

这个关键词很少见，但有时候是很有用的，比如在有很多规则时候，突然需要针对某个目录转为nginx内部处理。

l a i } o l n c i t a a e t s r i n o / a n d l a ; ^ t ~ a w u e p b l d a t d s / / d d o t w s n f / i l { e / d o w n / ;

2.9 try_files

字面意思是尝试，后面可以接多个目录或者文件，比如kohana框架：

t r y _ f i l e s $ u r i / i n d e x . p h p ? $ q u e r y _ s t r i n g ;

先看是否有URL这个文件，没有的话再调用index.php来处理，或者支持状态码处理：

t r y _ f i l e s / f o o / b a r / = 4 0 4 ;

没有这两个文件的话返回404状态。

2.10 auth认证

可以做简单的用户登录认证方式，其中的passwd_file得通过apache的htpasswd命令来生成。

a a u u t t h h _ _ b b a a s s i i c c _ " u R s e e s r t _ r f i i c l t e e d p " a ; s s w d _ f i l e ;

认证通过之后每次访问会在头部添加Authorization字段包含用户名密码的base64加密密文给服务端。

2.11 gzip

普通的线上web站点gzip压缩是必须要开的，压缩一些文本类型的文件再返回给用户。

注意必须手动指定全需要压缩的类型，比如css、js之类的，线上配置如下：

g g g g g g z z z z z z i i i i i i p p p p p p _ _ _ _ _ o m b v h t n i u a t y ; n f r t p _ f y p e l e _ s e r o v n s n e t g ; r e t 4 s x h i t 1 o / 2 6 n p 0 k l 4 ; 1 a 8 . i ; 1 n ; t e x t / c s s t e x t / x m l a p p l i c a t i o n / x m l a p p l i c a t i o n / j a v a s c r i p t a p p l i c a t i o n / x - j a v a s c r i p t ;

2.12 mime配置

很久以前基本是忽略这个配置，但手游流行之后就发现异常了，需要让手机浏览器知道返回的apk后缀是什么类型，否则类似IE浏览器会以zip后缀返回，需要加上：

a a p p p p l l i i c c a a t t i i o o n n / / i n p d h . o a n n e d r p o x i l d . i p p a a c ; k a g e - a r c h i v e a p k ;

2.13 限速

限速包括限制请求的并发数和请求的下载速度。

简单的限制某个线程的下载速度就直接加上一句话就可以了：

l i m i t _ r a t e 1 0 2 4 k ;

要限制某个IP的并发数之类的就需要用ngx_http_limit_req_module和ngx_http_limit_conn_module模块了，不过是默认就编译好的。

比如使用一个 10M 大小的状态缓存区，针对每个IP每秒只接受20次的请求：

l i m i t _ r e q _ z o n e $ b i n a r y _ r e m o t e _ a d d r z o n e = N A M E : 1 0 m r a t e = 2 0 r / s ;

2.14 location匹配

location匹配有多种方式，常见的比如

l l l o o o c c c a a a t t t i i i o o o n n n = / ^ ~ / / t e s t {

是有优先级的，直接 ”=” 的优先级是最高的，一般就用”~”这个符号来匹配php就好了，不过是区分了大小写的：

l o c a t i o n ~ . p h p $

2.15 文件缓存

返回给用户的文件一般都配置了过期时间，让浏览器缓存起来。

比如缓存14天：

e x p i r e s 1 4 d ;

针对某些特殊的文件就需要location匹配之后进行禁止缓存配置：

a a e d d x d d p _ _ i h h r e e e a a s d d e e o r r f f C C ; a a c c h h e e - - C C o o n n t t r r o o l l n n o o - - c s a t c o h r e e ; ;

2.16 缓存文件

nginx可以作为ATS这样的缓存服务器来缓存文件，配置也比较简单，不过我们很少用，除非一些特殊的场合，参考配置：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

#先在全局下面定义好缓存存放的目录
proxy_cache_path /data/cache/ levels=1:2 keys_zone=cache_one:10m inactive=7d max_size=10g;
proxy_temp_path /data/cache/proxy_temp_path;
proxy_cache_key $host$uri$is_args$args;
#然后在server里面的location匹配好目的文件，加入下一段即可
proxy_cache cache_one;
proxy_cache_valid 200 304 24h;
proxy_cache_valid any 10m;
proxy_pass https://$host;
proxy_cache_key $host$uri$is_args$args;
add_header Nginx-Cache "$upstream_cache_status"; 3. 内置模块

3. 内置模块

nginx含有大量的模块可以支持多种复杂的需求，比如源码目录src/http/modules里面就有很多c模块的代码，或者直接通过./configure –help|grep module来查看有哪些内置模块，编译时候直接加上就可以了。

除了nginx内置的模块，网络上还有很多第三方的模块，可以通过编译时候加参数–add-module=PATH指定模块源码来编译。

下面介绍一些我们线上用过而且比较赞的内置模块。

3.1 stream

端口转发的模块，从nginx1.9版本才开始支持，包含tcp和udp的支持，和IPTABLES相比这个虽然是应用层，会监听端口，但是配置起来很方便，比IPTABLES灵活，在tcp模块下面添加类似vhost的server就可以了，方便自动化管理，参考配置：

s } e l p a r i r c v s o c e t x e r e y s n _ s { p _ P a l O s o R s g T ; I / P d : a P t O a R / T l ; o g s / t c p / P O R T . l o g ;

3.2 http_realip_module

nginx反向代理之后，如何让后端web直接获取到的IP不是反向代理的iP，而是直接获取到用户的真实IP呢，就需要这个模块了，不需要代码那里再做类似X-Real-IP的变量特殊判断。

3.3 http_slice_module

在做CDN时候可以用到，让一个大文件分片，分成多个小文件通过206断点续传到后端，然后再组合起来，避免大文件直接回源导致多副本和多次回源的问题。

3.4 http_secure_link_module

前面说到的防盗链可以用这个来做，但是这个一般是针对那种文件下载时候用到的，比如从网页下载时候，服务端生成一个加密URL给用户，然后这个URL有过期时间之类的，避免此URL被多次分享出去，不过普通的素材加载还是用普通的防盗链即可。

3.5 http_sub_module

替换响应给用户的内容，相对于sed之后再返回，比如可以在需要临时全局修改网站背景或者title时候可以一次性处理好。

4. 扩展项目

简单介绍下大名鼎鼎的两个基于nginx的扩展项目，也是我们线上有很多地方用到的。

4.1 openresty

集成lua脚本，几乎可以完成任何普通web相关的需求。

比如URL加密进行防劫持和防盗链，服务端动态生成一串aes加密的URL给CDN，CDN的openresty解密之后用普通的URL转发到后端，然后再返回给用户正确的内容。

4.2 tengine

淘宝的nginx修改版，实现了很多nginx的收费功能或者是特殊功能，比如动态加载、concat合并请求，动态解析等。