189 8069 5689
中文文档
Nginx 功能概述
--|Http 基础功能：
1. 处理静态文件
2. 反向代理加速（无缓存），简单的负载均衡和容错。
3. 模块化结构
4. SSL 和TLS SNI支持
--|IMAP/POP3代理服务功能：
--|其他Http 功能：
1. 基于IP和名称的虚拟主机服务
2. 基于客户端IP地址和HTTP基本认证的访问控制
3.支持FLV（Flash视频）
补充：Nginx 可以作为Web服务器、负载均衡服务器、邮件代理服务器。
其中，我使用它作为Tomcat的HTTP代理服务器。
Nginx主模块
include
配置文件的包含：
include vhosts/*.conf;
http 核心模块
alias
location /i/ { alias /spool/w3/images/; }
表示请求"/i/top.gif"将返回文件： "/spool/w3/images/top.gif".
default_type
指定标准MIME-type以外的MIME 类型。
location = /proxy.pac { default_type application/x-ns-proxy-autoconfig; }
index
指定index 的文件
internal
error_page 404 /404.html; location /404.html { internal; }
此位置只处理"internal"请求，如：
requests redirected by the instructionerror_page
subrequests created by the commandinclude virtualof the "ngx_http_ssi_module" module
requests changed by the instructionrewriteof the "ngx_http_rewrite_module" module
Nginx 0.7.x 引入了新的internal locations：@Location
location / { root /var/www/html; error_page 404 @40x; } location @40x { root /var/www/errors/40x.html; }
location
1. ~*大小写不敏感
2. ~ 大小写敏感
匹配顺序：
~先匹配一部分query，搜索不停止。
然后搜索正则，正则匹配了，就停止搜索。
如果没有正则匹配，则搜索字面量。
匹配修正：
“=” 前缀：仅匹配额外的query，如果匹配则搜索停止。比如query - ”/"频繁出现,可以使用"location = /" 去处理这类请求。
"^~"前缀：表示部分匹配后不再继续搜索。比如"location ^~/images/",表示以 "/images"开头的 query 即匹配此location,不再继续搜索正则。
location = / { # matches the query / only. [ configuration A ] } location / { # matches any query, since all queries begin with /, but regular # expressions and any longer conventional blocks will be # matched first. [ configuration B ] } location ^~ /images/ { # matches any query beginning with /images/ and halts searching, # so regular expressions will not be checked. [ configuration C ] } location ~* .(gif|jpg|jpeg)$ { # matches any request ending in gif, jpg, or jpeg. However, all # requests to the /images/ directory will be handled by # Configuration C. [ configuration D ] }
针对上述配置,可能的匹配结果：
/ -> configuration A
/documents/document.html -> configuration B
/images/1.gif -> configuration C
/documents/1.jpg -> configuration D
root
location /i/ { root /spool/w3; }
比如对于 请求"/i/top.gif" 将返回文件"/spool/w3/i/top.gif". 注意比较alias,这里会匹配"i"目录到query中。
server
配置 virtual server
指令listen 用于配置 addresses和ports
指令server_name用于配置 server_name
注意：如果 host和server都匹配的话,host将匹配。
server的搜索顺序：
全名
前通配符 *.example.com
后通配符 — www.example.*
正则匹配
types
types { text/html html; image/gif gif; image/jpeg jpg; }
The sufficiently complete table of mappings is included and is located in the file conf/mine.types
匹配所有类型,可以使用 types { }
location /download/ { types { } default_type application/octet-stream; }
变量
支持apache 内置变量,如：$http_user-agent,$http_cookie,and so forth.
还支持
$arg_PARAMETER 表示GET 请求的中变量PARAMETER的值。
$args/$query_string 请求行的参数
$content_length
$content_type
$cookie_COOKIE
$document_root 效果等同于root指令,但只针对当前请求。
$document_uri/$uri
$host 等同于,用于 host头不可得时。
$http_HEADER
...
HttpProxy模块
此模块专伺将请求导向其它服务.
It is an HTTP/1.0 proxy without the ability for keep-alive requests yet.
补充：无请求保持，可能需要多次建立Tcp连接。无连接的含义是限制每次连接只处理一个请求。服务器处理完客户的请求，并收到客户的应答后，即断开连接。采用这种方式可以节省传输时间。
HTTP 协议是无状态协议。无状态是指协议对于事务处理没有记忆能力。缺少状态意味着如果后续处理需要前面的信息，则它必须重传，这样可能导致每次连接传送的数据量增大。服务器没有保存客户端的状态信息吧，客户端必须每次带上自己的状态去请求服务器（比如cookie、session等）。另一方面，在服务器不需要先前信息时它的应答就较快。
示例 location / { : proxy_pass http://localhost:8000; : proxy_set_header X-Real-IP $remote_addr; }