HTTP核心模块(HTTP Core)


回目录

·摘要

Nginx处理HTTP的核心功能模块

·指令

alias

语法:alias file-path|directory-path;
默认值:no
使用字段:location
这个指令指定一个路径使用某个某个,注意它可能类似于root,但是document root没有改变,请求只是使用了别名目录的文件。
location  /i/ {
  alias  /spool/w3/images/;
}
上个例子总,请求"/i/top.gif"将返回这个文件 "/spool/w3/images/top.gif"。
Alias同样可以用于正则指定的location,如:
location ~ ^/download/(.*)$ {
  alias /home/website/files/$1;
}
请求"/download/book.pdf"将返回"/home/website/files/book.pdf"文件。
当然也可以在别名目录字段中使用变量。

client_body_in_file_only

语法:client_body_in_file_only on|off
默认值:off
使用字段:http, server, location
这个指令始终存储一个连接请求实体到一个文件即使它只有0字节。
注意:如果这个指令打开,那么一个连接请求完成后,所存储的文件并不会删除。
这个指令可以用于debug调试和嵌入式Perl模块中的$r->request_body_file。

client_body_in_single_buffer

语法:client_body_in_single_buffer
默认值:off
使用字段:http, server, location
这个指令(0.7.58版本)指定将一个完整的连接请求放入缓冲区,当使用$request_body时推荐使用这个指令以减少复制操作。
如果无法将一个请求放入单个缓冲区,将会被放入磁盘。

client_body_buffer_size

语法:client_body_buffer_size the_size
默认值:8k/16k
使用字段:http, server, location
这个指令可以指定连接请求使用的缓冲区大小。
如果连接请求超过缓存区指定的值,那么这些请求或部分请求将尝试写入一个临时文件。
默认值为两个内存分页大小值,根据平台的不同,它可能是8k或16k。

client_body_temp_path

语法:client_body_temp_path dir-path [ level1 [ level2 [ level3 ]
默认值:client_body_temp
使用字段:http, server, location
这个指令指定连接请求试图写入文件的目录路径。
可以指定三级目录结构,如:
client_body_temp_path  /spool/nginx/client_temp 1 2;
那么它的目录结构可能是这样:
/spool/nginx/client_temp/7/45/00000123457

client_body_timeout

语法:client_body_timeout time
默认值:60
使用字段:http, server, location
这个指令指定一个请求读取超时时间。
这个选项仅设置与客户端与服务器建立连接过程中,如果连接超过这个时间而客户端没有任何响应,Nginx将返回一个"Request time out" (408)错误

client_header_buffer_size

语法:client_header_buffer_size size
默认值:1k
使用字段:http, server
这个指令指定客户端请求的http头部缓冲区大小
绝大多数情况下一个头部请求的大小不会大于1k
不过如果有来自于wap客户端的较大的cookie它可能会大于1k,Nginx将分配给它一个更大的缓冲区,这个值可以在large_client_header_buffers里面设置。

client_header_timeout

语法:client_header_timeout time
默认值:60
使用字段:http, server
这个指令指定客户端请求的http头部超时时间。
这个选项仅设置与客户端与服务器建立连接并且读取http头的过程中,如果连接超过这个时间而客户端没有任何响应,Nginx将返回一个"Request time out" (408)错误。

client_max_body_size

语法:client_max_body_size size
默认值:client_max_body_size 1m
使用字段:http, server, location
这个指令指定允许客户端请求的最大的单个文件字节数,它出现在请求头部的Content-Length字段。
如果请求大于指定的值,客户端将收到一个"Request Entity Too Large" (413)错误。
需要记住,浏览器并不知道怎样显示这个错误。

default_type

语法: default_type MIME-type
默认值:default_type text/plain
使用字段:http, server, location
在基础MIME视图没有指定任何信息的情况下可以设置默认MIME类型。
参考types。
location = /proxy.pac {
  default_type application/x-ns-proxy-autoconfig;
}
location = /wpad.dat {
  rewrite . /proxy.pac;
  default_type application/x-ns-proxy-autoconfig;
}

directio

语法:directio [size|off]
默认值:directio off
使用字段:http, server, location
这个参数指定在读取文件大小大于指定值的文件时使用O_DIRECT(FreeBSD, Linux),F_NOCACHE(Mac OS X)或者调用directio()函数(Solaris),当一个请求用到这个参数时会关掉sendfile,通常这个参数用于大文件。
directio  4m;

error_page

语法:error_page code [ code... ] [ = | =answer-code ] uri | @named_location
默认值:no
使用字段:http, server, location, location 中的if字段
这个参数可以为错误代码指定相应的错误页面
error_page   404          /404.html;
error_page   502 503 504  /50x.html;
error_page   403          http://example.com/forbidden.html;
error_page   404          = @fetch;
同样,你也可以修改返回的错误代码:
error_page 404 =200 /.empty.gif;
如果一个错误的响应经过代理或者FastCGI服务器,这个服务器将返回不同的响应码,如200, 302, 401或404,那么可以指定响应码重定向:
error_page   404  =  /404.php;
如果在重定向时不希望改变URI,可以将错误页面重定向到一个命名的location字段中:
location / (
    error_page 404 = @fallback;
)

location @fallback (
    proxy_pass http://backend;
)

if_modified_since

语法:if_modified_since [off|exact|before]
默认值:if_modified_since exact
使用字段:http, server, location
这个参数(0.7.24)指定了如何将文件修改的时间与请求头中的"If-Modified-Since"时间相比较。

·off :不检查请求头中的"If-Modified-Since"
·exact:精确匹配
·before:文件修改时间应小于请求头中的"If-Modified-Since"时间

index

语法:index file [file...]
默认值:index index.html
使用字段:http, server, location
这个参数哪个(些)文件将被用于主页,可以在文件名中使用变量,一个包含绝对路径的文件可以把它放到末尾,例:
index  index.$geo.html  index.0.html  /index.html;
如果你想自动生成一个目录下的文件列表的主页,可以用autoindex on指令。

internal

语法:internal
默认值:no
使用字段: location
internal指令指定某个location只能被“内部的”请求调用,外部的调用请求会返回"Not found" (404)
“内部的”是指下列类型:

·指令error_page重定向的请求。
·ngx_http_ssi_module模块中使用include virtual指令创建的某些子请求。
·ngx_http_rewrite_module模块中使用rewrite指令修改的请求。

一个防止错误页面被用户直接访问的例子:
error_page 404 /404.html;
location  /404.html {
  internal;
}

keepalive_timeout

语法:keepalive_timeout [ time ] [ time ]
默认值:keepalive_timeout 75
使用字段:http, server, location
参数的第一个值指定了客户端与服务器长连接的超时时间,超过这个时间,服务器将关闭连接。
参数的第二个值(可选)指定了HTTP头中Keep-Alive: timeout=time的time值,这个值可以帮助一些浏览器关闭连接,以便服务器不用重复关闭,如果不指定这个参数,nginx不会在http头中发送Keep-Alive信息。(但这并不是指怎样将一个连接“Keep-Alive”)
参数的这两个值可以不相同
下面列出了一些服务器如何处理包含Keep-Alive的头:

·MSIE和Opera将Keep-Alive: timeout=N头忽略。
·MSIE保持一个活动的连接60-65秒,然后发送一个TCP RST。
·Opera将一直保持一个连接处于活动状态。
·Mozilla将一个连接在timeout=N的基础上增加大约1-10秒。
·Konqueror保持一个连接大约N秒。

keepalive_requests

语法:keepalive_requests n
默认值:keepalive_requests 100
使用字段:http, server, location
服务器保持长连接的请求数。

large_client_header_buffers

语法:large_client_header_buffers number size
默认值:large_client_header_buffers 4 4k/8k
使用字段:http, server
指令指定客户端请求的一些比较大的头文件到缓冲区的最大值,如果一个请求的URI大小超过这个值,服务器将返回一个"Request URI too large" (414),同样,如果一个请求的头部字段大于这个值,服务器将返回"Bad request" (400)。
缓冲区根据需求的不同是分开的。
默认一个缓冲区大小为操作系统中分页文件大小,通常是4k或8k,如果一个连接请求将状态转换为keep-alive,这个缓冲区将被释放。

limit_except

语法:limit_except methods {...}
默认值:no
使用字段:location
可以比较容易得在location字段中做一些http动作的限制。
ngx_http_access_module和ngx_http_auth_basic_module模块有很强的访问控制功能。

limit_except  GET {
  allow  192.168.1.0/32;
  deny   all;
}

limit_rate

语法:limit_rate speed
默认值:no
使用字段:http, server, location, location中的if字段
限制将应答包传送到客户端的速度,单位为字节/秒,限制仅对一个连接有效,即如果一个客户端打开2个连接,则它的速度是这个值乘以二。
基于一些不同的状况,如果要在server字段来限制一些连接的速度,那么这个参数并不适用,不过你可以选择设置$limit_rate变量的值来达到目的:
server {
  if ($slow) {
    set $limit_rate  4k;
  }
}
同样可以通过设置X-Accel-Limit-Rate头(NginxXSendfile)来控制proxy_pass返回的应答。不依赖于X-Accel-Redirect头。

limit_rate_after

语法:limit_rate_after time
默认值:limit_rate_after 1m
使用字段:http, server, location, location中的if字段
这个指令和上面的一起使用:
limit_rate_after 1m;
limit_rate 100k;

listen

语法:listen address:port [ default [ backlog=num | rcvbuf=size | sndbuf=size | accept_filter=filter | deferred | bind | ssl ] ]
默认值:listen 80
使用字段:server
listen指令指定了server{...}字段中可以被访问到的ip地址及端口号,可以只指定一个ip,一个端口,或者一个可解析的服务器名。
listen 127.0.0.1:8000;
listen 127.0.0.1;
listen 8000;
listen *:8000;
listen localhost:8000;
ipv6地址格式(0.7.36)在一个方括号中指定:
listen [::]:8000;
listen [fe80::1];
当linux(相对于FreeBSD)绑定IPv6[::],那么它同样将绑定相应的IPv4地址,如果在一些非ipv6服务器上仍然这样设置,可能会绑定失败,当然你可以使用完整的地址来代替[::],也可以使用"default ipv6only=on" 选项来制定这个listen字段仅绑定ipv6地址,注意这个选项仅对这行listen生效,而不影响server块中指定的其他listen字段。
listen [2a02:750:5::123]:80;
listen [::]:80 default ipv6only=on;
只有ip地址需要指定,端口默认为80。
如果指令有default参数,那么这个server块将是一个“地址:端口”对的默认服务器,这对于你想为那些不匹配server_name指令中的主机名指定默认server块的基于域名的虚拟主机非常有用,如果没有指令带有default参数,那么默认服务器将使用第一个出现“IP:端口”对的server块。
listen允许为系统调用的listen(2)和bind(2)传递一些其他的参数,这些参数必须用在default参数之后:
backlog=num -- 指定调用listen(2)时backlog的值,默认会被-1。
rcvbuf=size -- 为正在监听的端口指定SO_RCVBUF的值。
sndbuf=size -- 为正在监听的端口指定SO_SNDBUF的值。
accept_filter=filter -- 为accept-filter指定一个名称。

·仅用于FreeBSD,它可能有两个过滤器,dataready与httpready,仅在最终版本的FreeBSD(FreeBSD: 6.0, 5.4-STABLE与4.11-STABLE)上,为他们发送-HUP信号可能会改变accept-filter。

deferred -- 在linux系统上延迟accept(2)并使用一个辅助的参数: TCP_DEFER_ACCEPT。
bind -- 指出必须使bind(2)分离构建。

·主要指这里的“地址:端口”对,实际上如果这些指令描述为监听同一个端口,但是每个不同的地址和每条不同的指令均监听的是这个端口的所有地址,那么nginx只将bind(2)构建于*:port。这种情况下必须考虑并且确定哪个地址上有连接到达,完成系统调用getsockname()。但是如果使用了parameters backlog, rcvbuf, sndbuf, accept_filter或deferred这些参数,那么将总是将这个“地址:端口”对分离。

ssl -- 这个参数(0.7.14)并不关联listen(2)和bind(2)系统调用。

·被指定这个参数的listen将被允许工作在SSL模式,这将允许服务器同时工作在HTTP和HTTPS两种协议下,例如:

listen  80;
listen  443 default ssl;
一个使用这些参数的完整例子:
listen  127.0.0.1 default accept_filter=dataready backlog=1024;
0.8.21版本以后nginx可以监听unix套接口:
listen unix:/tmp/nginx1.sock;

location

语法:location [=|~|~*|^~|@] /uri/ { ... }
默认值:no
使用字段:server
这个参数根据URI的不同需求来进行配置,可以使用字符串与正则表达式匹配,如果要使用正则表达式,你必须指定下列前缀:
1、~* 不匹配大小写。
2、~ 匹配大小写。
要确定该指令匹配特定的查询,程序将首先对字符串进行匹配,字符串匹配将作为查询的开始,最确切的匹配将被使用。然后,正则表达式的匹配查询开始,匹配查询的第一个正则表达式找到后会停止搜索,如果没有找到正则表达式,将使用字符串的搜索结果。
在一些操作系统,如Mac OS X和Cygwin,字符串将通过不区分大小写的方式完成匹配(0.7.7),但是,比较仅限于单字节的语言环境。
正则表达式可以包含捕获(0.7.40),并用于其它指令中。
可以使用“^~”标记禁止在字符串匹配后检查正则表达式,如果最确切的匹配location有这个标记,那么正则表达式不会被检查。
使用“=”标记可以在URI和location之间定义精确的匹配,在精确匹配完成后并不进行额外的搜索,例如有请求“/”发生,则可以使用“location = /”来加速这个处理。
即使没有“=”和“^~”标记,精确的匹配location在找到后同样会停止查询。
下面是各种查询方式的总结:
1、前缀“=”表示精确匹配查询,如果找到,立即停止查询。
2、指令仍然使用标准字符串,如果匹配使用“^~”前缀,停止查询。
3、正则表达式按照他们在配置文件中定义的顺序。
4、如果第三条产生一个匹配,这个匹配将被使用,否则将使用第二条的匹配。
例:
location  = / {
  # 只匹配 / 的查询.
  [ configuration A ]
}
location  / {
  # 匹配任何以 / 开始的查询,但是正则表达式与一些较长的字符串将被首先匹配。
  [ configuration B ]
}
location ^~ /images/ {
  # 匹配任何以 /images/ 开始的查询并且停止搜索,不检查正则表达式。
  [ configuration C ]
}
location ~* \.(gif|jpg|jpeg)$ {
  # 匹配任何以gif, jpg, or jpeg结尾的文件,但是所有 /images/ 目录的请求将在Configuration C中处理。
  [ configuration D ]
}
各请求的处理如下例:
·/ -> configuration A
·/documents/document.html -> configuration B
·/images/1.gif -> configuration C
·/documents/1.jpg -> configuration D
注意你可以以任何顺序定义这4个配置并且匹配结果是相同的,但当使用嵌套的location结构时可能会将配置文件变的复杂并且产生一些比较意外的结果。
标记“@”指定一个命名的location,这种location并不会在正常请求中执行,它们仅使用在内部重定向请求中。(查看error_pagetry_files

log_not_found

语法:log_not_found [on|off]
默认值:log_not_found on
使用字段:http, server, location
这个指令指定是否将一些文件没有找到的错误信息写入error_log指定的文件中。

log_subrequest

语法:log_subrequest [on|off]
默认值:log_subrequest off
使用字段:http, server, location
这个指令指定是否将一些经过rewrite rules和/或SSI requests的子请求请求写入access_log指定的文件中。

msie_padding

语法:msie_padding [on|off]
默认值:msie_padding on
使用字段:http, server, location
这个指令指定开启或关闭MSIE浏览器和chrome浏览器(0.8.25+)的msie_padding特征,当这个功能开启,nginx将为响应实体分配最小512字节,以便响应大于或等于400的状态代码。
这个指令预防在MSIE和chrome浏览器中激活“友好的”HTTP错误页面,以便不在服务器端隐藏更多的错误信息。

msie_refresh

语法: msie_refresh [on|off]
默认值:msie_refresh off
使用字段:http, server, location
这个指令允许或拒绝为MSIE发布一个refresh而不是做一次redirect

open_file_cache

语法:open_file_cache max = N [inactive = time] | off
默认值:open_file_cache off
使用字段:http, server, location
这个指令指定缓存是否启用,如果启用,将记录文件以下信息:
·打开的文件描述符,大小信息和修改时间。
·存在的目录信息。
·在搜索文件过程中的错误信息 -- 没有这个文件、无法正确读取,参考open_file_cache_errors
指令参数:

·max - 指定缓存的最大数目,如果缓存溢出,最长使用过的文件(LRU)将被移除。
·inactive - 指定缓存文件被移除的时间,如果在这段时间内文件没被下载,默认为60秒。
·off - 禁止缓存。

例:
 open_file_cache max=1000 inactive=20s;
 open_file_cache_valid    30s;
 open_file_cache_min_uses 2;
 open_file_cache_errors   on;

open_file_cache_errors

语法:open_file_cache_errors on | off
默认值:open_file_cache_errors off
使用字段:http, server, location
这个指令指定是否在搜索一个文件是记录cache错误。

open_file_cache_min_uses

语法:open_file_cache_min_uses number
默认值:open_file_cache_min_uses 1
使用字段:http, server, location
这个指令指定了在open_file_cache指令无效的参数中一定的时间范围内可以使用的最小文件数,如果使用更大的值,文件描述符在cache中总是打开状态。

open_file_cache_valid

语法:open_file_cache_valid time
默认值:open_file_cache_valid 60
使用字段:http, server, location
这个指令指定了何时需要检查open_file_cache中缓存项目的有效信息。

optimize_server_names

语法:optimize_server_names [ on|off ]
默认值:optimize_server_names on
使用字段:http, server
这个指令指定是否在基于域名的虚拟主机中开启最优化的主机名检查。
尤其是检查影响到使用主机名的重定向,如果开启最优化,那么所有基于域名的虚拟主机监听的一个“地址:端口对”具有相同的配置,这样在请求执行的时候并不进行再次检查,重定向会使用第一个server name。
如果重定向必须使用主机名并且在客户端检查通过,那么这个参数必须设置为off。
注意:这个参数不建议在nginx 0.7.x版本中使用,请使用server_name_in_redirect。

port_in_redirect

语法:port_in_redirect [ on|off ]
默认值:port_in_redirect on
使用字段:http, server, location
这个指令指定是否在让nginx在重定向操作中对端口进行操作。
如果这个选项打开,在重定向请求中nginx不会在url中添加端口。

recursive_error_pages

语法:recursive_error_pages [on|off]
默认值:recursive_error_pages off
使用字段:http, server, location
recursive_error_pages指定启用除第一条error_page指令以外其他的error_page。

resolver

语法:resolver address
默认值:no
使用字段:http, server, location
暂无

resolver_timeout

语法:resolver_timeout time
默认值:30
使用字段:http, server, location
解析超时时间。

root

语法:root path
默认值:root html
使用字段:http, server, location ,location中的if字段
请求到达后的文件根目录。
下例中:
location  /i/ {
  root  /spool/w3;
}
如果请求"/i/top.gif"文件,nginx将转到"/spool/w3/i/top.gif"文件。你可以在参数中使用变量。
注意:在请求中root会添加这个location到它的值后面,即"/i/top.gif"并不会请求"/spool/w3/top.gif"文件,如果要实现上述类似于apache alias的功能,可以使用alias指令。

satisfy_any

语法:satisfy_any [ on|off ]
默认值:satisfy_any off
使用字段:location
指令可以检查至少一个成功的密码效验,它在NginxHttpAccessModule或NginxHttpAuthBasicModule这两个模块中执行。
location / {
  satisfy_any  on;
  allow  192.168.1.0/32;
  deny   all;
  auth_basic            "closed site";
  auth_basic_user_file  conf/htpasswd;
}

send_timeout

语法:send_timeout the time
默认值:send_timeout 60
使用字段:http, server, location
指令指定了发送给客户端应答后的超时时间,Timeout是指没有进入完整established状态,只完成了两次握手,如果超过这个时间客户端没有任何响应,nginx将关闭连接。

sendfile

语法:sendfile [ on|off ]
默认值:sendfile off
使用字段:http, server, location
是否启用sendfile()函数。

server

语法:server {...}
默认值:no
使用字段:http
server字段包含虚拟主机的配置。
没有明确的机制来分开基于域名(请求中的主机头)和基于IP的虚拟主机。
可以通过listen指令来指定必须连接到这个server块的所有地址和端口,并且在server_name指令中可以指定所有的域名。

server_name

语法:server_name name [... ]
默认值:server_name hostname
使用字段:server
这个指令有两个作用:
·将HTTP请求的主机头与在nginx配置文件中的server{...}字段中指定的参数进行匹配,并且找出第一个匹配结果。这就是如何定义虚拟主机的方法,域名遵循下述优先级规则:
1、完整匹配的名称。
2、名称开始于一个文件通配符:*.example.com。
3、名称结束于一个文件通配符:www.example.*。
4、使用正则表达式的名称。
如果没有匹配的结果,nginx配置文件将安装以下优先级使用[#server server { ... }]字段:
1、listen指令被标记为default的server字段。
2、第一个出现listen(或者默认的listen 80)的server字段。
·如果server_name_in_redirect被设置,这个指令将用于设置HTTP重定向的服务器名。
例:
server {
  server_name   example.com  www.example.com;
}
第一个名称为服务器的基本名称,默认名称为机器的hostname。
当然,可以使用文件通配符:
server {
  server_name   example.com  *.example.com  www.example.*;
}
上述例子中的前两个名称可以合并为一个:
server {
  server_name  .example.com;
}
同样可以使用正则表达式。名称前面加“~”:
server {
  server_name   www.example.com   ~^www\d+\.example\.com$;
}
如果客户端请求中没有主机头或者没有匹配server_name的主机头,服务器基本名称将被用于一个HTTP重定向,你可以只使用“*”来强制nginx在HTTP重定向中使用Host头(注意*不能用于第一个名称,不过你可以用一个很傻逼的名称代替,如“_”)
server {
  server_name example.com *;
}
server {
  server_name _ *;
}
在nginx0.6.x中有稍许改变:
server {
  server_name _;
}
0.7.12版本以后已经可以支持空服务器名,以处理那些没有主机头的请求:
server {
  server_name "";
}

server_name_in_redirect

语法:server_name_in_redirect on|off
默认值:server_name_in_redirect on
使用字段:http, server, location
如果这个指令打开,nginx将使用server_name指定的基本服务器名作为重定向地址,如果关闭,nginx将使用请求中的主机头。

server_names_hash_max_size

语法:server_names_hash_max_size number
默认值:server_names_hash_max_size 512
使用字段:http
服务器名称哈希表的最大值,更多信息请参考nginx Optimizations

server_names_hash_bucket_size

语法:server_names_hash_bucket_size number
默认值:server_names_hash_bucket_size 32/64/128
使用字段:http
服务器名称哈希表每个页框的大小,这个指令的默认值依赖于cpu缓存。更多信息请参考nginx Optimizations

server_tokens

语法:server_tokens on|off
默认值:server_tokens on
使用字段:http, server, location
是否在错误页面和服务器头中输出nginx版本信息。

tcp_nodelay

语法:tcp_nodelay [on|off]
默认值:tcp_nodelay on
使用字段:http, server, location
这个指令指定是否使用socket的TCP_NODELAY选项,这个选项只对keep-alive连接有效。
点击这里了解更多关于TCP_NODELAY选项的信息。

tcp_nopush

语法:tcp_nopush [on|off]
默认值:tcp_nopush off
使用字段:http, server, location
这个指令指定是否使用socket的TCP_NOPUSH(FreeBSD)或TCP_CORK(linux)选项,这个选项只在使用sendfile时有效。
设置这个选项的将导致nginx试图将它的HTTP应答头封装到一个包中。
点击这里查看关于TCP_NOPUSH和TCP_CORK选项的更多信息。

try_files

语法:try_files file1 [file2 ... filen] fallback
默认值:none
使用字段:location
这个指令告诉nginx将测试参数中每个文件的存在,并且URI将使用第一个找到的文件,如果没有找到文件,将请求名为fallback(可以使任何名称)的location字段,fallback是一个必须的参数,它可以是一个命名的location或者可靠的URI。
例:
location / {
  try_files index.html index.htm @fallback;
}

location @fallback {
  root /var/www/error;
  index index.html;
}

types

语法:types {...}
使用字段:http, server, location
这个字段指定一些扩展的文件对应方式与应答的MIME类型,一个MIME类型可以有一些与其类似的扩展。默认使用以下文件对应方式:
types {
  text/html    html;
  image/gif    gif;
  image/jpeg   jpg;
}
完整的对应视图文件为conf/mime.types,并且将被包含。
如果你想让某些特定的location的处理方式使用MIME类型:application/octet-stream,可以使用以下配置:
location /download/ {
  types         { }
  default_type  application/octet-stream;
}

·变量

core module 支持一些内置的变量,与apache使用的变量相一致。
首先,一些变量是代表了客户端请求标题的字段,如:$http_user_agent, $http_cookie等等。
除此之外,下列是一些其他变量:

$arg_PARAMETER

这个变量包含在查询字符串时GET请求PARAMETER的值。

$args

这个变量等于请求行中的参数。

$binary_remote_addr

二进制码形式的客户端地址。

$body_bytes_sent

未知。

$content_length

请求头中的Content-length字段。

$content_type

请求头中的Content-Type字段。

$cookie_COOKIE

cookie COOKIE的值。

$document_root

当前请求在root指令中指定的值。

$document_uri

与$uri相同。

$host

请求中的主机头字段,如果请求中的主机头不可用,则为服务器处理请求的服务器名称。

$is_args

如果$args设置,值为"?",否则为""。

$limit_rate

这个变量可以限制连接速率。

$query_string

与$args相同。

$remote_addr

客户端的IP地址。

$remote_port

客户端的端口。

$remote_user

已经经过Auth Basic Module验证的用户名。

$request_filename

当前连接请求的文件路径,由root或alias指令与URI请求生成。

$request_body

这个变量(0.7.58+)包含请求的主要信息。在使用proxy_pass或fastcgi_pass指令的location中比较有意义。

$request_body_file

客户端请求主体信息的临时文件名。

$request_completion

未知。

$request_method

这个变量是客户端请求的动作,通常为GET或POST。
包括0.8.20及之前的版本中,这个变量总为main request中的动作,如果当前请求是一个子请求,并不使用这个当前请求的动作。

$request_uri

这个变量等于包含一些客户端请求参数的原始URI,它无法修改,请查看$uri更改或重写URI。

$scheme

HTTP方法(如http,https)。按需使用,例:
rewrite  ^(.+)$  $scheme://example.com$1  redirect;

$server_addr

服务器地址,在完成一次系统调用后可以确定这个值,如果要绕开系统调用,则必须在listen中指定地址并且使用bind参数。

$server_name

服务器名称。

$server_port

请求到达服务器的端口号。

$server_protocol

请求使用的协议,通常是HTTP/1.0或HTTP/1.1。

$uri

请求中的当前URI(不带请求参数,参数位于$args),可以不同于浏览器传递的$request_uri的值,它可以通过内部重定向,或者使用index指令进行修改。

·参考文档

Original Documentation
Nginx Http Core Module

前进->HTTP负载均衡模块(HTTP Upstream)