Nginx 文档阅读记录

中文文档

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 instruction error_page

subrequests created by the command include virtual of the "ngx_http_ssi_module" module

requests changed by the instruction rewrite of 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;
}