介绍
- 安装 Nginx
- 从源码构建 Nginx
- 初学者指南
- 控制 nginx
- 连接处理方式
- 设置哈希
- 调试日志
- 记录日志到 syslog
- 配置文件度量单位
- 命令行参数
- Windows 下的 nginx
- QUIC 和 HTTP/3 支持
- nginx 如何处理请求
- 服务器名称
- 使用 nginx 作为 HTTP 负载均衡器
- 配置 HTTPS 服务器
- UDP 会话
- 关于 nginScript
其他
How-To
开发
模块参考
- 核心功能
- HTTP
- ngx_http_core_module
- ngx_http_access_module
- ngx_http_addition_module
- ngx_http_auth_basic_module
- ngx_http_auth_jwt_module
- ngx_http_auth_request_module
- ngx_http_autoindex_module
- ngx_http_browser_module
- ngx_http_charset_module
- ngx_http_dav_module
- ngx_http_empty_gif_module
- ngx_http_f4f_module
- ngx_http_fastcgi_module
- ngx_http_flv_module
- ngx_http_geo_module
- ngx_http_geoip_module
- ngx_http_grpc_module
- ngx_http_gunzip_module
- ngx_http_gzip_module
- ngx_http_gzip_static_module
- ngx_http_headers_module
- ngx_http_hls_module
- ngx_http_image_filter_module
- ngx_http_index_module
- ngx_http_js_module
- ngx_http_keyval_module
- ngx_http_limit_conn_module
- ngx_http_limit_req_module
- ngx_http_log_module
- ngx_http_map_module
- ngx_http_memcached_module
- ngx_http_mirror_module
- ngx_http_mp4_module
- ngx_http_perl_module
- ngx_http_proxy_module
- ngx_http_random_index_module
- ngx_http_realip_module
- ngx_http_referer_module
- ngx_http_rewrite_module
- ngx_http_scgi_module
- ngx_http_secure_link_module
- ngx_http_session_log_module
- ngx_http_slice_module
- ngx_http_spdy_module(过时)
- ngx_http_split_clients_module
- ngx_http_ssi_module
- ngx_http_ssl_module
- ngx_http_status_module(过时)
- ngx_http_stub_status_module
- ngx_http_sub_module
- ngx_http_upstream_module
- ngx_http_upstream_conf_module
- ngx_http_upstream_hc_module
- ngx_http_userid_module
- ngx_http_uwsgi_module
- ngx_http_v2_module
- ngx_http_xslt_module
- Stream
- ngx_stream_core_module
- ngx_stream_access_module
- ngx_stream_geo_module
- ngx_stream_geoip_module
- ngx_stream_js_module
- ngx_stream_keyval_module
- ngx_stream_limit_conn_module
- ngx_stream_log_module
- ngx_stream_map_module
- ngx_stream_proxy_module
- ngx_stream_realip_module
- ngx_stream_return_module
- ngx_stream_split_clients_module
- ngx_stream_ssl_module
- ngx_stream_ssl_preread_module
- ngx_stream_upstream_module
- ngx_stream_upstream_hc_module
- ngx_stream_zone_sync_module
- 其他
- ngx_http_api_module
nginx 如何处理请求
基于名称的虚拟服务器
nginx 首先决定哪个 server
应该处理请求,让我们从一个简单的配置开始,三个虚拟服务器都监听了 *:80
端口:
server {
listen 80;
server_name example.org www.example.org;
...
}
server {
listen 80;
server_name example.net www.example.net;
...
}
server {
listen 80;
server_name example.com www.example.com;
...
}
在此配置中,nginx 仅检验请求的 header 域中的 Host
,以确定请求应该被路由到哪一个 server
。如果其值与任何的 server
名称不匹配,或者该请求根本不包含此 header 域,nginx 会将请求路由到该端口的默认 server
中。在上面的配置中,默认 server
是第一个(这是 nginx 的标准默认行为)。你也可以在 listen 指令中使用 default_server
参数,明确地设置默认的 server
。
server {
listen 80 default_server;
server_name example.net www.example.net;
...
}
default_server
参数自 0.8.21 版本起可用。在早期版本中,应该使用default
参数。
请注意,default_server
是 listen port
的属性,而不是 server_name
的。之后会有更多关于这方面的内容。
如何使用未定义的 server 名称来阻止处理请求
如果不允许没有 “Host” header 字段的请求,可以定义一个丢弃请求的 server:
server {
listen 80;
server_name "";
return 444;
}
这里的 server
名称设置为一个空字符串,会匹配不带 Host
的 header 域请求,nginx 会返回一个表示关闭连接的非标准代码 444。
自 0.8.48 版本开始,这是
server
名称的默认设置,因此可以省略server name ""
。在早期版本中,机器的主机名被作为server
的默认名称。
基于名称和 IP 混合的虚拟服务器
让我们看看更加复杂的配置,其中一些虚拟服务器监听在不同的 IP 地址上监听:
server {
listen 192.168.1.1:80;
server_name example.org www.example.org;
...
}
server {
listen 192.168.1.1:80;
server_name example.net www.example.net;
...
}
server {
listen 192.168.1.2:80;
server_name example.com www.example.com;
...
}
此配置中,nginx 首先根据 server 块的 listen
指令检验请求的 IP 和端口。之后,根据与 IP 和端口相匹配的 server
块的 server_name 项对请求的“Host” header 域进行检验。如果找不到服务器的名称(server_name),请求将由 default_server
处理。例如,在 192.168.1.1:80
上收到的对 www.example.com
的请求将由 192.168.1.1:80
端口的 default_server
(即第一个 server)处理,因为没有 www.example.com
在此端口上定义。
如上所述,default_server
是 listen port
的属性,可以为不同的端口定义不同的 default_server
:
server {
listen 192.168.1.1:80;
server_name example.org www.example.org;
...
}
server {
listen 192.168.1.1:80 default_server;
server_name example.net www.example.net;
...
}
server {
listen 192.168.1.2:80 default_server;
server_name example.com www.example.com;
...
}
一个简单的 PHP 站点配置
现在让我们来看看 nginx 是如何选择一个 location
来处理典型的简单 PHP 站点的请求:
server {
listen 80;
server_name example.org www.example.org;
root /data/www;
location / {
index index.html index.php;
}
location ~* \.(gif|jpg|png)$ {
expires 30d;
}
location ~ \.php$ {
fastcgi_pass localhost:9000;
fastcgi_param SCRIPT_FILENAME
$document_root$fastcgi_script_name;
include fastcgi_params;
}
}
nginx 首先忽略排序搜索具有最明确字符串的前缀 location
。在上面的配置中,唯一有符合的是前缀 location
为 /
,因为它匹配任何请求,它将被用作最后的手段。之后,nginx 按照配置文件中列出的顺序检查由 location
的正则表达式。第一个匹配表达式停止搜索,nginx 将使用此 location
。如果没有正则表达式匹配请求,那么 nginx 将使用前面找到的最明确的前缀 location
。
请注意,所有类型的 location
仅仅是检验请求的 URI 部分,不带参数。这样做是因为查询字符串中的参数可以有多种形式,例如:
/index.php?user=john&page=1
/index.php?page=1&user=john
此外,任何人都可以在查询字符串中请求任何内容:
/index.php?page=1&something+else&user=john
现在来看看在上面的配置中是如何请求的:
- 请求
/logo.gif
首先与 前缀location
为/
相匹配,然后由正则表达式\.(gif|jpg|png)$
匹配,因此由后一个location
处理。使用指令root /data/www
将请求映射到/data/www/logo.gif
文件,并将文件发送给客户端。 - 一个
/index.php
的请求也是首先与前缀location
为/
相匹配,然后是正则表达式\.(php)$
。因此,它由后一个location
处理,请求将被传递给在localhost:9000
上监听的 FastCGI 服务器。fastcgi_param 指令将 FastCGI 参数SCRPT_FILENAME
设置为/data/www/index.php
,FastCGI 服务器执行该文件。变量$document_root
与 root 指令的值是一样的,变量$fastcgi_script_name
的值为请求URI,即/index.php
。 /about.html
请求仅与前缀location
为/
相匹配,因此由此location
处理。使用指令root /data/www
将请求映射到/data/www/about.html
文件,并将文件发送给客户端。- 处理请求
/
更复杂。它与前缀location
为/
相匹配。因此由该location
处理。然后,index 指令根据其参数和root /data/www
指令检验索引文件是否存在。如果文件/data/www/index.html
不存在,并且文件/data/www/index.php
存在,则该指令执行内部重定向到/index.php
,就像请求是由客户端发起的,nginx 将再次搜索location
。如之前所述,重定向请求最终由 FastCGI 服务器处理。
由 Igor Sysoev 撰写 由 Brian Mercer 编辑
如果你对这篇内容有疑问,欢迎到本站社区发帖提问 参与讨论,获取更多帮助,或者扫码二维码加入 Web 技术交流群。
绑定邮箱获取回复消息
由于您还没有绑定你的真实邮箱,如果其他用户或者作者回复了您的评论,将不能在第一时间通知您!
发布评论