Nginx | 稚子的成长博客

Nginx Location指令配置及常用全局变量 12月02日

Nginx Location 指令基础

Nginx 中的 Location 指令 是NginxHttpCoreModule中重要指令。Location 指令比较简单，但却是配置 Nginx 过程中不得不去了解的。 
Location 指令，是用来为匹配的 URI 进行配置，URI 即语法中的”/uri/”，可以是字符串或正则表达式。但如果要使用正则表达式，则必须指定前缀。

一、基本语法
 
location [=|~|~*|^~|@] /uri/ { … }
〖=〗 表示精确匹配，如果找到，立即停止搜索并立即处理此请求。
〖~ 〗 表示区分大小写匹配
〖~*〗 表示不区分大小写匹配
〖^~ 〗 表示只匹配字符串,不查询正则表达式。
〖@〗 指定一个命名的location，一般只用于内部重定向请求。

二、匹配过程

首先对字符串进行匹配查询，最确切的匹配将被使用。然后，正则表达式的匹配查询开始，匹配第一个结果后会停止搜索，如果没有找到正则表达式，将使用字符串的搜索结果，如果字符串和正则都匹配，那么正则优先级较高。

三、配置实例
 
location  = / {
  # 只匹配对 / 目录的查询.
  [ config A ]
}
location  / {
  # 匹配以 / 开始的查询，即所有查询都匹配。
  [ config B ]
}
location ^~ /images/ {
  # 匹配以 /images/ 开始的查询，不再检查正则表达式。
  [ config C ]
}
location ~* \.(gif|jpg|jpeg)$ {
  # 匹配以gif, jpg, or jpeg结尾的文件，但优先级低于config C。
  [ config D ]
}
 
四、全局变量
 
$args #这个变量等于请求行中的参数。
$content_length #请求头中的Content-length字段。
$content_type #请求头中的Content-Type字段。
$document_root #当前请求在root指令中指定的值。
$host #请求主机头字段，否则为服务器名称。
$http_user_agent #客户端agent信息
$http_cookie #客户端cookie信息
$limit_rate #这个变量可以限制连接速率。
$request_body_file #客户端请求主体信息的临时文件名。
$request_method #客户端请求的动作，通常为GET或POST。
$remote_addr #客户端的IP地址。
$remote_port #客户端的端口。
$remote_user #已经经过Auth Basic Module验证的用户名。
$request_filename #当前请求的文件路径，由root或alias指令与URI请求生成。
$query_string #与$args相同。
$scheme #HTTP方法（如http，https）。
$server_protocol #请求使用的协议，通常是HTTP/1.0或HTTP/1.1。
$server_addr #服务器地址，在完成一次系统调用后可以确定这个值。
$server_name #服务器名称。
$server_port #请求到达服务器的端口号。
$request_uri #包含请求参数的原始URI，不包含主机名，如：”/foo/bar.php?arg=baz”。
$uri #不带请求参数的当前URI，$uri不包含主机名，如”/foo/bar.html”。
$document_uri #与$uri相同。
 附录1
$request_uri和$uri区别


$request_uri
This variable is equal to the *original* request URI as received from the client including the args. It cannot be modified. Look at $uri for the post-rewrite/altered URI. Does not include host name. Example: “/foo/bar.php?arg=baz” 
这个变量等于从客户端发送来的原生请求URI，包括参数。它不可以进行修改。$uri变量反映的是重写后/改变的URI。不包括主机名。例如：”/foo/bar.php?arg=baz”
$uri
This variable is the current request URI, without any arguments (see $args for those). This variable will reflect any modifications done so far by internal redirects or the index module. Note this may be different from $request_uri, as $request_uri is what was originally sent by the browser before any such modifications. Does not include the protocol or host name. Example: /foo/bar.html 
这个变量指当前的请求URI，不包括任何参数(见$args)。这个变量反映任何内部重定向或index模块所做的修改。注意，这和$request_uri不同，因$request_uri是浏览器发起的不做任何修改的原生URI。不包括协议及主机名。例如：”/foo/bar.html”
$document_uri
The same as $uri. 
同$uri.
 附录2
#允许客户端请求的最大的单个文件字节数
client_max_body_size 10m; 
#缓冲区代理缓冲用户端请求的最大字节数 可以理解为先保存到本地再传给用户
client_body_buffer_size 128k;

#跟后端服务器连接的超时时间_发起握手等候响应超时时间
proxy_connect_timeout 600;

#连接成功后_等候后端服务器响应时间_其实已经进入后端的排队等候处理
proxy_read_timeout 600;

#后端服务器数据回传时间_就是在规定时间之内后端服务器必须传完所有的数据
proxy_send_timeout 600;

#代理请求缓存区_这个缓存区间会保存用户的头信息以供Nginx进行规则处理_一般只要能保存下头信息即可
proxy_buffer_size 8k;

#同上 告诉Nginx保存单个用的几个Buffer 最大用多大空间
proxy_buffers 4 32k;

#如果系统很忙的时候可以申请更大的proxy_buffers 官方推荐*2
proxy_busy_buffers_size 64k;

#proxy缓存临时文件的大小
proxy_temp_file_write_size 64k;

Nginx 中的 Location 指令是NginxHttpCoreModule中重要指令。Location 指令比较简单，但却是配置 Nginx 过程中不得不去了解的。

Location 指令，是用来为匹配的 URI 进行配置，URI 即语法中的”/uri/”，可以是字符串或正则表达式。但如果要使用正则表达式，则必须指定前缀。

一、基本语法

location [=|~|~*|^~|@] /uri/ { … }

〖=〗表示精确匹配，如果找到，立即停止搜索并立即处理此请求。

〖~ 〗表示区分大小写匹配

〖~*〗表示不区分大小写匹配

〖^~ 〗表示只匹配字符串,不查询正则表达式。

〖@〗指定一个命名的location，一般只用于内部重定向请求。

二、匹配过程

首先对字符串进行匹配查询，最确切的匹配将被使用。然后，正则表达式的匹配查询开始，匹配第一个结果后会停止搜索，如果没有找到正则表达式，将使用字符串的搜索结果，如果字符串和正则都匹配，那么正则优先级较高。

三、配置实例

location = / {

# 只匹配对 / 目录的查询.

[ config A ]

}

location / {

# 匹配以 / 开始的查询，即所有查询都匹配。

[ config B ]

}

location ^~ /images/ {

# 匹配以 /images/ 开始的查询，不再检查正则表达式。

[ config C ]

}

location ~* \.(gif|jpg|jpeg)$ {

# 匹配以gif, jpg, or jpeg结尾的文件，但优先级低于config C。

[ config D ]

}

四、全局变量

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

$content_length #请求头中的Content-length字段。

$content_type #请求头中的Content-Type字段。

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

$host #请求主机头字段，否则为服务器名称。

$http_user_agent #客户端agent信息

$http_cookie #客户端cookie信息

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

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

$request_method #客户端请求的动作，通常为GET或POST。

$remote_addr #客户端的IP地址。

$remote_port #客户端的端口。

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

$request_filename #当前请求的文件路径，由root或alias指令与URI请求生成。

$query_string #与$args相同。

$scheme #HTTP方法（如http，https）。

$server_protocol #请求使用的协议，通常是HTTP/1.0或HTTP/1.1。

$server_addr #服务器地址，在完成一次系统调用后可以确定这个值。

$server_name #服务器名称。

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

$request_uri #包含请求参数的原始URI，不包含主机名，如：”/foo/bar.php?arg=baz”。

$uri #不带请求参数的当前URI，$uri不包含主机名，如”/foo/bar.html”。

$document_uri #与$uri相同。

附录1

$request_uri和$uri区别

$request_uri

This variable is equal to the *original* request URI as received from the client including the args. It cannot be modified. Look at $uri for the post-rewrite/altered URI. Does not include host name. Example: “/foo/bar.php?arg=baz”

这个变量等于从客户端发送来的原生请求URI，包括参数。它不可以进行修改。$uri变量反映的是重写后/改变的URI。不包括主机名。例如：”/foo/bar.php?arg=baz”

$uri

This variable is the current request URI, without any arguments (see $args for those). This variable will reflect any modifications done so far by internal redirects or the index module. Note this may be different from $request_uri, as $request_uri is what was originally sent by the browser before any such modifications. Does not include the protocol or host name. Example: /foo/bar.html

这个变量指当前的请求URI，不包括任何参数(见$args)。这个变量反映任何内部重定向或index模块所做的修改。注意，这和$request_uri不同，因$request_uri是浏览器发起的不做任何修改的原生URI。不包括协议及主机名。例如：”/foo/bar.html”

$document_uri

The same as $uri.

同$uri.

附录2

#允许客户端请求的最大的单个文件字节数

client_max_body_size 10m;

#缓冲区代理缓冲用户端请求的最大字节数可以理解为先保存到本地再传给用户

client_body_buffer_size 128k;

#跟后端服务器连接的超时时间_发起握手等候响应超时时间

proxy_connect_timeout 600;

#连接成功后_等候后端服务器响应时间_其实已经进入后端的排队等候处理

proxy_read_timeout 600;

#后端服务器数据回传时间_就是在规定时间之内后端服务器必须传完所有的数据

proxy_send_timeout 600;

#代理请求缓存区_这个缓存区间会保存用户的头信息以供Nginx进行规则处理_一般只要能保存下头信息即可

proxy_buffer_size 8k;

#同上告诉Nginx保存单个用的几个Buffer 最大用多大空间

proxy_buffers 4 32k;

#如果系统很忙的时候可以申请更大的proxy_buffers 官方推荐*2

proxy_busy_buffers_size 64k;

#proxy缓存临时文件的大小

proxy_temp_file_write_size 64k;

&n […]

分类：应用工具软件
标签： Location, Nginx
评论：0条
浏览：792
阅读全文

PHP返回数据被nginx截断问题的解决方法 08月15日

出现的问题现象： 1 直接在命令行运行PHP脚本返回数据正常 2 通过nginx访问返回数据被截断经过排查是 […]

分类：应用工具软件
标签： Nginx
评论：0条
浏览：2150
阅读全文

Nginx泛解析的匹配域名绑定到子目录配置 10月25日

网站的目录结构为： # tree /home/wwwroot/zzstudio.net /home/wwwro […]

分类：应用工具软件
标签： Nginx, 泛解析
评论：0条
浏览：2274
阅读全文

使用socket方式连接Nginx优化php-fpm性能 10月25日

Nginx连接fastcgi的方式有2种：TCP和unix domain socket 什么是Unix dom […]

分类：操作系统相关
标签： Nginx, php-fpm, socket
评论：0条
浏览：1655
阅读全文

设置nginx的自定义404页面 10月24日

做网站时配置404页面是必不可少的，一旦配置了自定义的个性404会让一个网站提升N个逼格。一个好的404还能留 […]

分类：应用工具软件操作系统相关
标签： 404, Nginx
评论：0条
浏览：2045
阅读全文

Nginx代理无法获取真实ip地址解决方法 10月18日

在nginx代理服务器的location中增加以下配置 proxy_set_header Host $host […]

分类：应用工具软件操作系统相关
标签： IP, Nginx, proxy
评论：0条
浏览：1855
阅读全文

用Nginx 修改头信息，让AJAX跨域正常请求 10月10日

AJAX从一个域请求另一个域的地址会有跨域的问题，需要在nginx的配置上添加add_header 如下： s […]

分类：应用工具软件
标签： header, Nginx, 跨域
评论：0条
浏览：1923
阅读全文

nginx配置请求直接返回json数据 09月30日

对于有些服务端接口返回是固定值的json，可通过配置nginx直接返回json，减少程序的加载对资源的占用，减 […]

分类：Web前台开发技术操作系统相关
标签： JSON, Nginx
评论：0条
浏览：6770
阅读全文

nginx中配置子域名重定向的方法 08月24日

首先解析域名具体的代码如下： listen 80; server_name zzstudio.net www […]

分类：应用工具软件操作系统相关
标签： Nginx, 重定向
评论：0条
浏览：2257
阅读全文

解决nginx 504 Gateway Time-out的方法 07月14日

在CentOS下配置lnmp组合基本上用的都是同样的配置文件，一直都没出现过问题，可最近在一个vps上安装同样 […]

分类：应用工具软件操作系统相关
标签： 504, Nginx, Time-out
评论：0条
浏览：7444
阅读全文