1. 首页

[译]如何配置Nginx详解

image

原文地址: How to Configure NGINX

Nginx是一个轻量的、高性能、专为高并发设计的web服务器。

Nginx一个鲜明的特点就是,能够高效的处理诸如HTML之类的媒体文件。Nginx采用异步事件驱动模型,以提供高负载下的可预测性能。

动态内容经过Nginx透传给CGI、FastCGI或者其他的诸如Apache的web服务器,然后这些内容又返回给Nginx以分发给客户端。本文将使你熟悉基本的Nginx参数配置和规定。

指令(Directives)&块(Blocks)&上下文(Contexts)

所有的Nginx配置文件都位于/etc/nginx目录下,基本的也是最主要的配置文件是/etc/nginx/nginx.conf

Nginx的配置项也被称之为指令。指令集合就是常说的或者上下文, 两者是相同的。

以字符#开头的行是注释行,不会被Nginx所解析。指令行必须以分号;结尾,否则Nginx无法正确的加载配置文件,并抛出错误。

以下截取自安装nginx时自带的配置文件/etc/nginx/nginx.conf。该文件开头有四个指令: user,worker_processes,error_log, pid。它们没有包含在任何指令块内,因此我们称之为存在于主指令块内。eventshttp指令块是额外的指令配置块,它们也存在于主指令块内。

你可以参考nginx官方配置文件来了解这些指令的含义,以及主指令块内的其他配置参数。


user nginx; worker_processes 1; error_log /var/log/nginx/error.log warn; pid /var/run/nginx.pid events { ... } http { ... } //JS中文网 – 前端进阶资源分享 https://www.javascriptc.com/ 趣聊CSS系列

http配置块

http配置块内包含着处理web通信的指令,这些指令通常被成为通用指令,因为这些指令作用于所有nginx代理的站点服务。 可以查阅nginx官方配置文件来了解http配置块内的所有指令


http { include /etc/nginx/mime.type; default_type application/octet-stream; log_format main '$remote_addr - $remote-user [$time_local] "$request" ' '$status $body_bytes_sent "$http_referer"' '"$http_user_agent" "$http_x_forwarded_for"'; access_log /var/log/nginx/access.log main; sendfile on; #tcp_nopush on; keepalive_timeout 65; #gzip on; include /etc/nginx/conf.d/*.conf; } //JS中文网 – 前端进阶资源分享 https://www.javascriptc.com/ 趣聊CSS系列

Server配置块

上面的http配置块包含了一个include指令,它是用来告诉nginx站点的配置文件的位置

  • 如果你是用官方的nginx包安装的,那么会是像上面的那样include /etc/nginx/conf.d/*.conf。 用nginx代理的每个站点都应该在目录/etc/nginx/conf.d下有自己的配置文件, 并且使用形如 example.com.conf的统一的命名规范。 没有被nginx代理的站点的配置文件应该被命名为example.com.conf.disabled
  • 如果你从Debian或者Ubuntu源上安装的nginx,这条指令会是这样的/etc/nginx/sites-enabled/*; sites-enabled文件夹下包含着站点配置文件的链接,这些文件存储在/etc/nginx/sites-available/文件下。 可以通过移除链接的方式达到禁用站点代理的目的。
  • 根据你的安装源,可以在/etc/nginx/conf.d/default.conf或者etc/nginx/sites-enabled/default 路径下找到默认的nginx配置例子

无论是何种安装源,每个站点的配置文件都会包含一个server配置块,例如:


# /etc/nginx/conf.d/example.com.conf server { listen 80 default_server; listen [::]:80 default_server; server_name example.com www.example.com; root /var/www/example.com; index index.html; try_files $uri /index.html; } //JS中文网 – 前端进阶资源分享 https://www.javascriptc.com/ 趣聊CSS系列

监听端口

listen 指令告诉nginx应该监听的http链接的主机名/IP/端口号。 default_server参数意味着,哪些80端口上的、不符合其他特定的监听声明的请求也会被该虚拟主机处理。第二个listen指令是基于IPv6的,行为与上一个IPv4一致.

命名的虚拟主机

server_name指令,允许一个IP地址代理多个域名,nginx代理服务器会根据收到的请求头来决定将请求转发给哪个域名。

你应该为代理的每个域名创建一个单独的配置文件,下面是对应的一些例子:

  1. 处理来自example.comwww.example.com的请求

# /etc/nginx/conf.d/example.com.conf server_name example.com www.example.com; //JS中文网 – 前端进阶资源分享 https://www.javascriptc.com/ 趣聊CSS系列
  1. server_name指令的值也可以是通配符**.example.com.example.com这两个指令都是指示nginx处理来自二级域名example.com下的所有请求

server_name *.example.com; server_name .example.com; //JS中文网 – 前端进阶资源分享 https://www.javascriptc.com/ 趣聊CSS系列
  1. 处理所有以example开头的域名下的请求

server_name example.*; //JS中文网 – 前端进阶资源分享 https://www.javascriptc.com/ 趣聊CSS系列

Nginx还允许server_name的值是自定义的、无效的域名,它只管根据HTTP请求头中的域名来响应请求,不会去关注该域名是否是有效的。

这种特性在局域网中是非常有用的,或者是你已经知道所有的可能发起请求的客户端。比如,前端常用的,在hosts文件中配置的ip-域名对,nginx都可以监听、处理。

Location路由配置块

Location配置的是,Nginx如何响应请求的资源。该指令把请求抽象为特定的文件或文件夹,就像server_name指令指示Nginx如何处理代理域名下的请求一样, 比如http://example.com/blog/, 下面是一些例子:


location / { } location /images/ { } location /blog/ { } location /planet/ { } location /planet/blog/ { } //JS中文网 – 前端进阶资源分享 https://www.javascriptc.com/ 趣聊CSS系列

上述是路由字符串匹配,匹配的目标是,http请求中域名之后的所有路径:

请求: Http://example.com/

响应: 假设已经配置了主机 server_name example.com, location /该指令将决定该请求的响应是什么。

Nginx总是会用最精确的路由匹配来处理请求:

请求: 例如有这两个请求http://example.com/planet/blog/ & http://example.com/planet/blog/about/

响应: 在上面的路由匹配中,最终会使用location /planet/blog/ { }路由下的配置处理,即使location /planet/ { }该路由也是匹配的,但是因为前者是更精确的,所以会使用前者而不是后者。


location ~ IndexPage\.php$ { } location ~ ^/BlogPlanet(/|/index\.php)$ { } //JS中文网 – 前端进阶资源分享 https://www.javascriptc.com/ 趣聊CSS系列

location指令后面紧跟着一个波浪号, 表示该路由匹配是正则匹配,并且是区分大小写的。 因此IndexPage.php是能够符合上述的第一个例子的,但是indexpage.php是不行的。在第二个例子中,正则表达式^/BlogPlanet(/|index\.php)$会匹配,诸如/BlogPlanet//BlogPlanet/index.php这样的请求,但是不会匹配到/BlogPlanet, /blogplanet/或者 /blogplanet/index.php这样的请求,因为大小写不符合。

Nginx的正则匹配规则是遵循PCRE(Perl Compatible Regular Expression)的。


location ~* \.(pl|cgi|perl|prl)$ { } location ~* \.(md|mdwn|txt|mkdn)$ { } //JS中文网 – 前端进阶资源分享 https://www.javascriptc.com/ 趣聊CSS系列

如果你想使匹配规则对大小写不敏感,那么在~后面添加一个*. 上述的例子是指定nginx如何处理以文件扩展名结尾的请求。 在第一个例子中,所有以.pl, .PL, .cgi, .CGI, .perl, .Perl, .prl, 和.PrL结尾的文件请求,都是满足匹配规则的.


location ^~ /images/IndexPage/ { } location ^~ /blog/BlogPlanet/ { } //JS中文网 – 前端进阶资源分享 https://www.javascriptc.com/ 趣聊CSS系列

location指令后面跟着 ^~组合,意味着,如果匹配到特定的字符串,就直接停止寻找更精确的路由匹配项,直接使用当前的路由配置。除此之外,与字符串匹配规则一样。如果一个请求符合该指令,那么不论后面是否有更精确的匹配项,直接使用此处的配置规则。关于匹配的顺序以及优先级,后文会有更详细的介绍。


location = / { } //JS中文网 – 前端进阶资源分享 https://www.javascriptc.com/ 趣聊CSS系列

最后,如果你在location后面添加了一个等号=, 意味着这是一个精准的匹配,请求路径必须严格等于路由项,才会停止匹配查询。举个栗子:最后的例子会匹配到http://example.com/, 而不会匹配http://example.com/index.html, 使用精准匹配可以轻微的提升响应速度,在某个请求需要频繁的被调用的场景下是非常有用的。

该指令的处理顺序如下:

  1. 精准匹配路由是最先被处理的,如果发现符合条件的,Nginx会停止匹配搜索,直接处理请求
  2. 字符串匹配是第二优先处理的,如果遇到^~匹配项,nginx会停止匹配,直接处理。否则,会持续匹配搜索直到找到最合适的匹配项
  3. 正则匹配项(~~*)是第三优先处理的,如果遇到符合条件的,停止搜索,处理请求
  4. 如果前三步都没有匹配到,那么将会使用最通配的字符串匹配

确保代理域名下的每个文件、文件夹至少能够匹配一个location指令

注意:
不建议也不支持嵌套的location配置块

路由的根路径和入口文件

location也是一个块指令,里面可以配置相关的指令

一旦Nginx匹配到了一个请求的最佳匹配路由,该请求的响应就会被相关location内的指令处理。例如:


location / { root html; index index.html index.htm; } //JS中文网 – 前端进阶资源分享 https://www.javascriptc.com/ 趣聊CSS系列

本例中,文件的根路径会被定位在html/目录下,在默认的nginx配置文件中,例子中的完整文件路径是/etc/nginx/html/

请求: http://example.com/blog/includes/style.css

响应: nginx会尝试在/etc/nginx/html/blog/includes/style.css路径下寻找目标文件

注意:
如果需要的话,root的值也可以使用绝对路径

index指令是告诉nginx,如果没有在目标路径找到目标文件,那么使用index指令的值代表的文件作为返回值。 例如:

请求: http://example.com

响应: nginx没有找到合适的匹配项,就会返回/etc/nginx/html/index.html文件

如果index指令的值有多个,nginx会按顺序寻找文件,直到发现第一个存在的,以此作为响应。如果在相关的文件夹下index.html不存在,会寻找index.htm, 如果依然不存在,就会返回404.

下面是一个稍微复杂的例子,展示了一个代理example.com域名的服务上的一系列location配置


location / { root /srv/www/example.com/public_html; index index.html index.htm; } location ~ \.pl$ { gzip off; include /etc/nginx/fastcgi_params; fastcgi_pass unix:/var/run/fcgiwrap.socket; fastcgi_index index.pl; fastcgi_param SCRIPT_FILENAME /srv/www/example.com/public_html$fastcgi_script_name; } //JS中文网 – 前端进阶资源分享 https://www.javascriptc.com/ 趣聊CSS系列

在这个例子中,所有获取以.pl为扩展名的资源的请求,都会被第二个location块处理, 在该指令块里定义了一个fastcgi回调来处理所有的请求。其他的请求则是由第一个指令块处理。 资源的请求被分发在文件系统中的/srv/www/example.com/public_html/路径下,如果请求的目标文件不存在,nginx会寻找index.htmlindex.htm代替,如果这两个文件也不存在,就会返回404.

我们来分析一下下面的几个例子:

请求: http://example.com

响应: 该请求会被第一个location匹配

  1. /srv/www/example.com/public_html/index.html 路径下的文件,有的话直接返回,没有走第二步
  2. /srv/www/example.com/public_html/index.htm路径下的文件,有的话返回,没有的话走第三步
  3. 返回404错误

请求: http://example.com/blog/
响应: 该请求会被第一个location匹配,请求路径里面有指出资源路径,因此拼接root路径

  1. /srv/www/example.com/public_html/blog/index.html 路径下的文件,有的话直接返回,没有走第二步
  2. /srv/www/example.com/public_html/blog/index.htm路径下的文件,有的话返回,没有的话走第三步
  3. 返回404错误

请求: http://example.com/tasks.pl
响应: 请求的资源是以.pl结尾的,会被第二个location匹配,资源名称是tasks.pl,拼接上root路径 nginx会寻找/srv/www/example.com/public_html/tasks.pl 路径下的文件,然后用指定的FASTCGI回调处理该文件,然后把结果作为响应返回

请求: http://example.com/username/roster.pl
响应: 请求的资源是以.pl结尾的,会被第二个location匹配,资源名称是roster.pl,路径是username, 拼接上root路径 nginx会寻找/srv/www/example.com/public_html/username/roster.pl 路径下的文件,然后用指定的FASTCGI回调处理该文件,然后把结果作为响应返回

总结(译者)

  • nginx location 指令是取请求uri,与location指令后面紧跟的字符串正则表达式做比较,选择匹配度最高的location块,用其中定义的指令处理请求。
  • root指令调整了资源的寻址路径,nginx会按照root + uri的路径来寻找请求资源
  • 如果uri没有明确指定资源名(具体的文件名),那么nginx会读取index指令的值作为默认返回值, 如果没有的话返回404

好文推荐

快狗打车前端团队博文前端想要了解的Nginx

作者:Goldbeener
链接:https://juejin.im/post/6844903827670302734

看完两件小事

如果你觉得这篇文章对你挺有启发,我想请你帮我两个小忙:

  1. 关注我们的 GitHub 博客,让我们成为长期关系
  2. 把这篇文章分享给你的朋友 / 交流群,让更多的人看到,一起进步,一起成长!
  3. 关注公众号 「画漫画的程序员」,公众号后台回复「资源」 免费领取我精心整理的前端进阶资源教程

JS中文网是中国领先的新一代开发者社区和专业的技术媒体,一个帮助开发者成长的社区,目前已经覆盖和服务了超过 300 万开发者,你每天都可以在这里找到技术世界的头条内容。欢迎热爱技术的你一起加入交流与学习,JS中文网的使命是帮助开发者用代码改变世界

本文著作权归作者所有,如若转载,请注明出处

转载请注明:文章转载自「 Js中文网 · 前端进阶资源教程 」https://www.javascriptc.com

标题:[译]如何配置Nginx详解

链接:https://www.javascriptc.com/4217.html

« 用原生实现Vue3,真香~
2020天猫双11前端体系的建设与挑战»
Flutter 中文教程资源

相关推荐

QR code