学习Nginx配置

た入场券 2024-02-19 09:47 30阅读 0赞

#### **1.下载地址** ####

官网地址：[NGINX - 免费试用、软件下载、产品定价 (nginx-cn.net)][NGINX - _ _nginx-cn.net]

![418c830ad94d48a48fbc04026c0f7f7c.png][]

[我这边选择NGINX 开源版 nginx: download][NGINX _ nginx_ download]

#### **2.nginx的基本配置** ####

**配置文件语法**

配置文件组成：注释行，指令块配置项和一系列指令配置项组成。

单个指令组成：配置项名称和值参数，值参数可以是一个或多个附加参数，取决于解析该条指令的模块。

# user nobody;
    worker_processes 4;
    events {
        worker_connections 1024;
    }

块配置项组成：一个块配置顶名和一对大括号组成。 块配置后面是否带有参数，如location /webstatic \{\}，取决于解析该配置块的模块。

*  指令配置项总是以分号结尾（;）。
 *  字符“\#”表示改行是注释行，nginx在读取配置文件时将忽略的文本。

**指令特点**

*  指令都有作用域，如上面例子，worker\_connections 只能放在events区块才有意义。
 *  配置块能相互嵌套。在某些情况下不同配置块能够相互嵌套。如在http区段，可以声明一个或多个server区段，server区段又可以插入一个或多个location区段。
 *  最后同样重要的是配置的继承。在一个区段中嵌套其他区段，那么被嵌套的区段会继承其父区段的配置。在嵌套模块中重新声明指令会覆盖该继承。

**指令值的单位**

可以使用下面单位来指定配置文件所在上下文中指令值的单位。

*  k或K:千字节
 *  m或M:兆字节
 *  ms:Milliseconds(毫秒)
 *  s:Seconds(秒)
 *  m:Minutes(分钟)
 *  h:Hours(小时)
 *  d:Days(天)
 *  w:Weeks(星期)
 *  M:Months(月)
 *  y:Years(年)

**字符串值**

注意：如果指令值中包含空格、分号或者是大括号等特殊字符，需要使用单引号或双引号将其括起。

**nginx基本模块**

nginx是由一系列模块组成的，大致可以分为核心模块、Http核心模块和其他模块。其中核心模块在编译时不能被禁用。核心模块包含main模块、events模块和include包含指令。

**main模块重要指令**

main模块位于配置文件根部。提供如进程管理和安全的能力。

daemon on; #启用或禁用守护进程模式。
    
    user  nobody; #worker进程运行的用户和组，如果没有提供则使用nginx的master进程的用户和用户组。   
    worker_processes  4;#定义worker进程数量一般和cpu核数一致。
    
    #错误日志，这里的级别由debug,info,notice,warn,error和crit(debug记录了全部日志，crit仅报告关键错误)
    #作用域：main, http, mail, stream, server, location
    error_log  logs/error.log error; 
    pid        logs/nginx.pid; #存放nginx守护进程的pid文件路径。
    log_not_found on; #开启或禁用记录404错误。
    ...
    #除上面指令外还有worker_rlimit_core、worker_rlimit_nofile、worker_cpu_affinity、worker_priority等。

events模块

事件模块提供的指令可以用来配置网络机制

accept_mutex:on; #默认值on，启用或禁用使用一个接受互斥锁来打开套接字监听。   
    use epoll; #指定nginx所使用的网络事件模型，可选值有/dev/poll,epoll,kqueue等，通常不需要显式指定它，默认情况下nginx将使用最有效方法。
    worker_connections 1024; #定义一个worker进程能够同时连接的数量。

**configuration模块**

提供的include 指令能够将其他文件包含在nginx配置文件中。在配置文件的任何地方均可插入该指令。注意如果没有指定绝对路径，那么文件路径将和配置文件的目录相关。

include /file/path.conf;
    include sites/*.conf;

#### 3.HTTP配置 ####

HTTP 核心模块是Nginx中最大的一个模块，它包含了所有的基本的区段、指令和变量。

**区段结构**

通过下面的例子，来认识http模块的区段结构。

http {
        #在http区段中启用gzip压缩
        gzip on;
        server {
            server_name localhost;
            listen 80;
            location /downloads/ {
                 #在此location区段禁用gzip压缩
                gzip off;
            }
        }
    }

*  http 区段位于配置文件的根部，在这个区段中允许定义HTTP模块的指令和HTTP模块的相关区段。
 *  server区段用于声明一个站点，该区段只能用在http区段中。
 *  location 区段应用于网站特定的URI位置，该区段能够用于server区段中，也能嵌套在其他location中。

**模块指令**

在http/server/location三个层次的每个层次都可以插入指令，下面介绍的指令都主要由http模块引入，对于每条指令都有它的使用环境。指令对应的级别包括http块、server块、location块，另外还有rewrite模块的if块。注意：一些指令不能用于某些级别。  
下面介绍一些常见指令，如无特殊说明作用域为http,server,location。

**套接字和主机配置指令**

下表指令可以根据主机名或IP地址和端口的组合创建一个server区段。并通过一些指令来配置TCP套接字选项，以便调整网络设置。

*  listen:用于设置监听套接字使用的ip端口号。  
    语法：listen \[address\]\[:port\]\[其他选项\]  
    其他选项：  
    default:指定监听的默认套接字，该server区段被用于默认的网站，在该IP地址和端口上接受任何客户端的请求。 ssl：指定的网站提供SSL服务。 其他选项依赖于bind和listen系统调用:backlog=num,rcvbuf=size,sndbuf=size,accept\_filter=filter,deferred和bind。  
    作用域：server
 *  server\_name：在server区段中指定一个或多个主机名。  
    nginx收到http请求时，根据请求header中Host值与所有server区段比较，第一个与主机名匹配的server块将被选中，否则如果没有server区段与客户端请求的主机名匹配，nginx会选择第一个server区段，匹配监听参数（如listen \*:80）,另外具有default选项的listen会被优先选择。注意该指令接受通配符。  
    作用域：server

server_name www.website.com website.com;
    server_name *.website.com;
    server_name *.website.*;

*  tcp\_nodelay：开启或关闭使用TCP\_NODELAY套接字选项，仅用于keep-alive连接。它禁用了Nagle 缓冲算法。
 *  tcp\_nopush  
    开启或禁用TCP\_NOPUSH(FreeBSD)或TCP\_CORK(Linux)的scoket选项。如果tcp\_nopush开启，则nginx将尝试在整个tcp数据包中发送整个http响应头。
 *  sendfile  
    指定nginx是否调用sendfile系统函数来输出文件，减少内核空间和用户空间的上下文切换。对于普通应用设为 on，如果用来进行下载等应用磁盘IO重负载应用，可设置为off，以平衡磁盘与网络I/O处理速度，降低系统的负载。

另外还有sendfile\_max\_chunk、send\_lowat等指令。

**路径和文档**

下表指令用来设置根目录、主页、错误页等。

*  root：定义文档的根目录。  
    作用域：http,server,location,if。
 *  alias：location 指定uri路径的别名，它不会改变root的值。  
    作用域：location

location  /i/ {
      alias  /spool/w3/images/;
    }
    #例如：请求"/i/top.gif",将返回这个文件: "/spool/w3/images/top.gif"。
    #正如你所看到的，uri中location后面的部分会追加到这个目录后面，而location自身指定的uri路径是"丢弃的"

*  error\_page  
    允许修改访问URI所产生的HTTP相应代码，并选择性地将它替换为其他代码。  
    作用域：http,server,location,if。  
    语法：error\_page code1 \[code2 ...\] \[=replacement code\] \[=@block|URI\]  
    例如：

error_page 404 html/404/html;
    error_page 500 502 503 504 html/5x.html;
    #跳转到命名的location区段。
    error_page 404 @notfound; 
    #在出现404错误时 ，内部重定向到index.html,并且返回200 OK响应码。
    error_page 404 =200/index/html;

*  index：定义默认的页面，如果请求中没有指定文件名，nginx则使用默认页面提供服务。默认值index.html。

语法：index file1 \[file2...\]

#例如： 
    index index.php index.html index.htm;

*  try\_files:试图找到指定的文件，如果指定的这些文件都不是，就跳转到命名location区段（最后一个参数）或者指定的URI。  
    作用域：location。

#例如
    location / { 
        try_files $uri $uri.php @proxy; 
    } 
    location @proxy {
        proxy_pass 127.0.0.1:8080;
    }

**客户端请求**

下面描述的是nginx处理客户端请求机制，如配置keepalive、客户端缓冲区设置等。

*  keepalive相关指令：keepalive\_requests、keepalive\_timeout、send\_timeout。
 *  缓冲区相关指令：client\_body\_buffer\_size、client\_header\_buffer\_size、large\_client\_header\_buffers等。
 *  其他客户端指令：client\_body\_timeout、client\_header\_timeout、client\_max\_body\_size、lingering\_time、ligering\_timeout、ignore\_invalid\_header等。

**MIME类型**

MIME类型会在HTTP响应头中Content-Type中发送，这个头通常影响浏览器对文件的处理，如MIME类型是application/octet-stream，那么浏览器会下载该文件，而非显示；如果MEMEE类型是text/plain，那么该文件在浏览器中会作为纯文本而不用html解释提供。

Nginx提供了两个配置MINE类型的指令。分别是types和default\_types；

http {
        include mime.types;
        location /downloads/ {
            #移除所有的MIME类型
            types {};
            default_type application/octet-stream.
        }
    }

**记录相关**

*  log\_not\_found:开启或禁用404没有找到的HTTP错误，如果日志中由于找不到favicon.ico或robots.txt而充满404错误日志，则可以通过这个选项关闭掉。  
    作用域：http,server,location。  
    默认值：on
 *  log\_subrequest:启用或禁用记录子请求（被内部请求指令（如rewrite）或SSI请求触发的请求）。  
    作用域：http,server,location。  
    默认值：off

**其他**

除了以上介绍的指令外，还有限制和约束以及文件处理和缓存相关指令，需要时可查阅相关文档。 但这里有必要介绍下internal指令。

#internal：该指令指定location区段只能用于内部访问。内部重定向参考Rewrite模块。
    server {
        server_name *.website.com;
        location /admin/ {
            internal;
        }
    }

**模块变量**

HTTP核心模块引入了大量的变量，可以使用这些变量应用到配置文件中。nginx的变量分为请求头变量、响应头变量和Nginx产生的各种变量。

**客户端请求头变量**

nginx允许你可以访问客户端请求头，以$http\_为前缀的格式访问，如下表。

*  $http\_host：HTTP头中的Host值。
 *  $http\_referer:HTTP头中的referer值。
 *  $http\_x\_forward\_for：HTTP头中的X-Forward-For的值。 除此之外还有$http\_user\_agent、$http\_via、$http\_cookie等。

**响应头变量**

这类变量发生在响应发送后，nginx允许你访问客户端响应头。以$send\_http...为前缀，如下表。

*  $send\_http\_content\_type：HTTP头中的Content-Type的值。
 *  $send\_http\_content\_length：HTTP头中的Content-Length的值。 除此之外还有$send\_http\_location、$send\_http\_connection等。

**nginx产生的变量**

*  $arg\_XXX：访问查询字符串中的参数。
 *  $args 所有结合在一起的查询字符串，同$query\_string。
 *  $body\_bytes\_sent：在响应头中发送的字节数。
 *  $content\_length:相当于HTTP头中的Content-Length。
 *  $content\_type:相当于HTTP头中的Content-Type。
 *  $cookie\_XXX:允许访问cookie数据，这里XXX替换为具体参数。
 *  $document\_root:返回root指令的值。
 *  $document\_uri:返回当前请求的uri，如果内部重定向被执行，将返回重定向后的uri。它与变量$uri相同。
 *  $request\_uri:原始请求的uri，在整个处理过程中保持不变（不像$document\_uri/$uri）。
 *  $host：相当于HTTP请求头中的Host,如果请求头没有Host，nginx会给这个变量赋一个值。
 *  $hostname：返回服务器的系统名称。
 *  $is\_args：如果$args变量为空，那么$is\_args也为空。
 *  $request\_filename:返回当前请求文件的绝对路径。 除此之外还有$nginx\_version、$hostname、$remote\_addr、$request\_body、$request\_method、$server\_name、$scheme等。

#### 深入location区段 ####

nginx location区段可以通过指定的模式与客户端请求URI相匹配，location区段语法如下：

Syntax:	location [ = | ~ | ~* | ^~ ] uri { ... }
            location @name { ... }
    Default:	—
    Context:	server, location

注意：location只是对URI进行匹配，不管查询字符串参数。

#### **修饰符描述** ####

*  = :URI必须与指定模式精确匹配。这里的模式为简单字符串，不可使用正则表达式。

# uri必须与/abcd精确匹配（优先级最高），如:
    # http://www.website.com/abcd 可用
    location = /abcd {
        ...
    }

*  (无)：URI必须以指定模式开始，不可使用正则表达式。

#uri必须与指定模式开始，以下uri可用:
    # http://www.website.com/abcd
    # http://www.website.com/abcd/
    # http://www.website.com/abcde
    location /abcd {
        ...
    }

*  ～：URI与指定的正则表达式模式匹配，区分大小写。

#正则表达式^/abcd$,指定模式必须以/开始，后根abc，以d字符结尾。如：
    http://website.com/abcd 可用
    http://website.com/abcd?param1&param2 可用
    location ~ ^/abcd$ {
        ...
    }

*  ～\*：URI与指定正则表达式模式匹配，不区分大小写。
 *  ^~：URI以指定模式开始，如果模式匹配，则停止搜索其他模式，
 *  @ 定义命名location区段。这些区段只能由内部产生的请求访问，如try\_files或error\_page。

#### **修饰符优先级** ####

1.  =
2.  无
3.  ^~
4.  ~或～\*
5.  (无)

#### 4.模块配置 ####

主要有关Rewrite模块及可能会用到的其他模块。

**Rewrite模块**

nginx rewrite模块使用Perl兼容正则表达式库，在安装nginx时需要预先安装perl和perl-dev。

**正则表达式**

**元字符**

*  ^ ：以^后跟的字符开始
 *  $ ：以$前的字符结尾
 *  . ：匹配任何字符
 *  \[ \] ：组，匹配指定字符集合内的任何字符。
 *  \[^ \] ：否定组，匹配不包括在指定字符集内的字符。
 *  | ：匹配符号“|”之前或之后的实体。
 *  ( ) ：分组，组成一组匹配的实体，常和“|”配合使用。
 *  \\ ：对特殊字符进行转义。

**量词**

使用量词可以扩展实体匹配次数。

*  \*：0或多次
 *  \+：1或多次
 *  ?：0或1次
 *  \{x\}：x次
 *  \{x,\}：至少x次
 *  \{x,y\}：x到y次

**捕获**

正则表达式最后一个功能是能够捕获自表达式，放在“( )”之间的任何文本，在被捕获后都能用于后面的处理。 例如：

server {
        server_name website.com;
        location ~* ^/(downloads|files)/(.*)$ {
            add_header capture1 $1;
            add_header capture2 $2;
        }
        
    }

**关于内部请求**

nginx有两种类型的内部请求：

1.  内部重定向： nginx在内部重定向客户端的请求。URI被改变，请求可能匹配到其他的location区段。常见的内部重定向指令有error\_page、rewrite、try\_files。
2.  子请求： 另一种触发内部请求而产生内容的就是子请求，如使用Addition模块或SSI模块的指令。

注意：error\_log 日志级别设置为debug时能够捕获到内部请求日志，详情可参阅error\_log指令。

**rewrite模块指令**

**条件结构**

Rewrite模块引入了if条件结构。  
语法：if (condition) \{ ... \}  
作用域：server, location

条件运算符说明：

*  一个变量名 : 如果指定的变量或数据不等于空字符串或0，则条件为真。
 *  =或!= : 相等或不等比较
 *  ~ , ~\* : 模式匹配，除此之外还有,!,!\*
 *  \-f,!-f : 测试文件是否存在
 *  \-d,!-d : 测试一个目录是否存在
 *  \-e,!-e : 测试文件、目录或符号链接是否存在
 *  \-x,!-x : 测试文件是否存在且可执行。

例如：

if ($http_user_agent ~ MSIE) {
            rewrite ^(.*)$ /msie/$1 break;
        }
        
        if ($http_cookie ~* "id=([^;]+)(?:;|$)") {
            set $id $1;
        }
        
        if ($request_method = POST) {
            return 405;
        }
        
        if ($slow) {
            limit_rate 10k;
        }
        
        if ($invalid_referer) {
            return 403;
        }

注意：if和location都能实现类似的效果，它们的不同之处在于能够在这两个区段使用的指令不同。换句话说就是有些指令可以用在if区段，有的则不可以，但几乎所有指令都可以在location中使用。比较常见的是在if区段中使用rewrite指令。  
**rewrite**  
语法：rewrite regex replacement \[flag\];  
如果指定的正则表达式与URI匹配，则URI将按照replacement指定的字符串进行更改。该rewrite指令将按其在配置文件中出现的顺序执行。可以使用flag终止指令的进一步处理。如果replacement以“http://”、“https://”或“$scheme”开头，则处理将停止并将重定向返回给客户端。 flag标志说明：

*  last：停止处理后面的rewrite指令集，并使用新的URI重新发起一个内部请求。
 *  break:停止处理后面的rewrite指令集，相当于执行了break指令。如果重定向后的文件不存在返回404。
 *  redirect:临时重定向，返回302 Moved temporarily HTTP 重定向响应，Location Header显示跳转后的URL地址。
 *  permanent：永久重定向，返回301响应。

server {
        ...
        rewrite ^(/download/.*)/media/(.*)\..*$ $1/mp3/$2.mp3 last;
        rewrite ^(/download/.*)/audio/(.*)\..*$ $1/mp3/$2.ra  last;
        return  403;
        ...
    }
    # 如上配置，如果放到location区块中，则last标志应该替换称break，否则nginx将执行10次循环，并返回500错误。
    location /download/ {
        rewrite ^(/download/.*)/media/(.*)\..*$ $1/mp3/$2.mp3 break;
        rewrite ^(/download/.*)/audio/(.*)\..*$ $1/mp3/$2.ra  break;
        return  403;
    }

注意：

*  如果URI重写后发生循环，则重复该循环，但不超过10次。nginx将返回“500 Internal Server Error”。
 *  last和break都不再匹配后面的rewrite规则，但last应用完当前规则后，会重新发起一个内部请求查找一个location.

**break**  
停止处理后面的rewrite指令集，阻止进一步改写请求URI。

if (-e $request_filename) {
        break;
    }
    //因为break指令，后面的指令集不会执行
    if ($uri ~ ^/search/(.*)$){
        rewrite ^/search.php?q=$1;
    }

**return**  
中断请求处理过程，并返回一个指定的HTTP状态码。  
语法：return code \[text\] | \[codURL\] ; return URL;

if ($uri ~ ^/admin/) {
        return 403;
        #因为已经完成了请求，此条指令不会执行。
        rewrite ^ http://website.com; 
    }

**set**  
初始化或重定义一个变量。注意有些变量不能修改，如$uri。  
语法：set $variable value;

**rewrite\_log**  
如果设置为on，nginx将在“notice”错误级别对rewrite引擎处理的每个操作记录日志。  
默认值：off

**Log模块**

该模块指令作用域：http,server,location  
**access\_log**:设置日志写入的路径，格式。  
语法：access\_log path \[format \[buffer=size\] | off;

*  path：日志记录的文件路径，路径中可以使用变量。
 *  format：用log\_format指令声明一个模版名称。
 *  off：关闭日志记录

**log\_format**:定义一个模版，用于表述日志中一个条目包含的内容。 语法：log\_format template\_name format\_string; 默认的模版为combined。定义为：

log_format combined '$remote_addr - $remote_user [$time_local] '
                        '"$request" $status $body_bytes_sent '
                        '"$http_referer" "$http_user_agent"';

**变量**  
Log模块除了可以使用公用变量之外，也带来了下面一些新的变量，但这些变量只能在写日志条目时使用。

*  $connection：连接号
 *  $msec：写入日志时的微秒时间
 *  $request\_time：处理请求花费的总时间。
 *  $status：响应状态码
 *  $bytes\_sent：发送到客户端的字节总数
 *  $body\_bytes\_sent：发送到客户端body的总字节数
 *  $reqeust\_length 请求体长度。  
    此外还有$time\_ios8601、$time\_local、$connection\_requests、$pipe几个变量。

#### headers模块 ####

该模块允许将“ Expires”和“ Cache-Control”头字段以及任意添加响应头字段。主要有两个指令：

*  add\_header: 允许在响应头中添加一个新行。 如果响应码为200、204、301、302、304，则该行被添加到响应头中。可以在value中使用变量。如果指定了always参数，则无论响应码如何，都会添加到响应头。 语法：add\_header name value \[always\];
 *  expires：该指令能够控制发送到客户端Expires和Cache-Control HTTP header的值，它影响的代码和前面一样。 语法：expires \[modified\] time | epoch | max | off;  
    **参数说明**：
    
     *  time:过期时间值，如expires 30d;
     *  epoch：将文件有效期设置为January 1970。Cache-Control header设置为no-cache。
     *  max：将文件设置为Decemeber 31,2037。Cache-Control header被设置为缓存10年。
     *  off：两个头都不修改

#### referer模块 ####

该模块有一个简单的指令：valid\_referers。它的目的是检查来自客户端请求的referer HTTP头。如果referer被认为无效,则$invalid\_referer设置为1。  
语法：valid\_referers none | blocked | server\_names | string ...;  
例如:

valid_referers none blocked server_names
                   *.example.com example.* www.example.org/galleries/
                   ~\.google\.;
    
    if ($invalid_referer) {
        return 403;
    }

注意：可以使用该模块实现网站防盗链功能，对其他网站链接的图片禁止访问。

#### Secure link模块 ####

该模块与SSL模块无关，对访问的链接提供了基本的保护。该模块提供两种模式：

*  通过 secure\_link\_secret 指令启用，用于检查请求链接的真实性，和保护未授权的资源访问。
 *  通过secure\_link and和secure\_link\_md5 指令请用，也用于限制链接的生存周期。 常用作下载防盗链功能。

#### Image filter模块 ####

该模块提供图像处理功能，通过GD Graphics Library(gdlib)来实现。默认编译的Nginx不包含这个模块

#### 其他模块 ####

除此之外比较重要的还有Index模块、gzip模块、realip模块、ssl模块等。另外在有特殊需要时还有 AutoIndex模块、auth\_basic模块、Limit zone模块、Limit request模块，Empty GIF模块、Addtion模块、Gzip模块、Charset模块、Browser模块、GeoIp模块等等。其他模块根据需要查阅nginx文档。

#### 5.fastcgi模块 ####

**基本概念：**

*  CGI协议（通用网关接口）：描述了Web服务器和应用程序网关之间的信息如何交换。
 *  FastCGI：它是一个基于套接字的通信协议，使Web服务器能够将客户端请求转发到应用程序网关，它使用了能够处理多个请求的常驻进程，因而效率比较高。

默认情况下fastcgi模块默认是启用的，通过该模块提供的指令，能够使nginx将请求传递给FastCGI程序。  
注意：nginx配置目录下的fastcgi.conf，包含了fastcgi预定义的一些参数。对所有fastcgi来说，有两个参数是必须的SCRIPT\_FILENAME和QUERY\_STRING。 例如:

#/etc/nginx/fastcgi.conf 
    
    fastcgi_param  SCRIPT_FILENAME    $document_root$fastcgi_script_name;
    fastcgi_param  QUERY_STRING       $query_string;
    fastcgi_param  REQUEST_METHOD     $request_method;
    fastcgi_param  CONTENT_TYPE       $content_type;
    fastcgi_param  CONTENT_LENGTH     $content_length;
    ....
    
    #示例
    location ~ \.php($|/) {
        fastcgi_pass unix:/dev/shm/php.sock;
        fastcgi_index  index.php;
        # 根据正则表达式分割为$fastcgi_script_name和$fastcgi_path_info两个变量。
        # 比如请求/show.php/article/0001，被分割为/show.php和/article/0001
        fastcgi_split_path_info  ^(.+\.php)(/.*)$;
        fastcgi_param  SCRIPT_FILENAME  $document_root$fastcgi_script_name;
        # 设置PATH_INFO SEVER变量
        fastcgi_param  PATH_INFO $fastcgi_path_info;
        fastcgi_param APP_ENV 'production';
        include fastcgi.conf;
    }

**模块指令**

下面简要介绍几个主要指令，其他指令用是可以查看官方文档。注意：如无特殊说明该模块指令作用域为：http、server、location

*  fastcgi\_pass：将请求转发给fastcgi服务器。 语法：fastcgi\_pass address; 作用域：location, if in location  
    *//对于TCP* fastcgi\_pass localhost:9000; *//对于UNIX* fastcgi\_pass unix:/tmp/fastcgi.socket;
 *  fastcgi\_param：允许将配置传递给Fastcgi服务器。
 *  fastcgi\_index：设置索引文件名，如果请求URI以斜杠结尾，则请求URI，带上由fastcgi\_index指令附加上的索引文件名。
 *  fastcgi\_split\_path\_info：根据正则表达式，将指令分割为$fastcgi\_script\_name和$fastcgi\_path\_info两个变量。

**变量**

*  $fastcgi\_script\_name：请求uri.

#### 6.upstream模块 ####

upstream模块用来定义一组服务器，从而可以由proxy\_pass,fastcgi\_pass等指令引用。在upstream模块中，默认的方法是轮询，这种方法会带来Session会话问题，会出现同一个访问者的两个请求可能会被不同的两个服务器处理。

**模块指令（整理自 [nginx.org upstream模块][nginx.org upstream] ）**

**upstream**:定义一组服务器，服务器可以监听不同端口，另外，可以混合监听TCP和UNIX域套接字。  
语法：upstream name \{ ... \}  
作用域：http  
注意：默认情况下，使用加权轮询均衡方法。在下面例子中，每7个请求，将有5个分配给172.16.0.50，第2和第3个服务器各一个请求。如果服务器通信期间发生错误，该请求将被传递到下一个服务器。依此类推，直到尝试所有正常运行的服务器为止，如果无法从任何一台服务器获得成功响应，则客户端收到最后一台服务器的响应结果。  
示例：

upstream backend {
        server 172.16.0.50 weight=5;
        server 127.0.0.1:8080       max_fails=3 fail_timeout=30s;
        server unix:/tmp/backend3;
    
        server 172.16.0.49  backup;
    }

**除upstream指令外，其他指令的作用域是：upstream**  
  
**server指令**：定义后端服务器的地址和参数，这些参数将影响nginx对后端服务器的选择。

语法：server address \[parameters\];  
参数说明：

*  weight=n:设置服务器的权重，默认为1。注意：如果使用ip\_hash模式，weight选项会被忽略。
 *  max\_conns=number:限制连接到该服务器上的最大活动连接数，默认值为0，表示没有限制。作用是可以对单个服务器进行限流，防止服务器超负荷运转。
 *  max\_fails=n:设置在fail\_timeout参数设置的期间内与服务器通信失败的尝试次数，超过这个次数服务器将不可用，默认设置为1。认定失败的条件由proxy\_next\_upstream、fastcgi\_next\_upstream等指令定义。
 *  fail\_timeout=time：指定服务器不可用的尝试时间范围。默认情况下，该参数设置为10s。
 *  backup：将服务器标记为备份服务器，当主服务器全部不可用时，才传递请求。  
    此参数不能和hash,ip\_hash和random负载均衡方法一起使用。
 *  down：标记服务器为离线状态。

**hash**  
语法：hash key \[consitent\]; 指定服务器组的负载均衡方法。客户端-服务器的映射是基于散列key值。key中可以使用nginx变量。如果指定consistent将使用一致性hash方法，可确保将服务器添加到组中或从组中删除服务器时，只有少量的key被重新映射到不同服务器。  
注意：从组中添加或删除服务器，可能会导致key值重新映射到其他服务器。

**ip\_hash**  
语法：ip\_hash;  
指定服务器组的负载均衡方法，它是基于客户端ip在服务器间分配请求。注意：1.如果其中一台服务器需要临时删除，需使用down参数标记该服务器，以保留客户端ip地址的当前哈希值。2.在运营商移动网络下，ip经常是会变化的。

**keepalive指令**  
语法：keepalive connections;  
每个 worker 进程连接上游服务器的最大长连接数（默认情况下是短连接）。超过此数量时，将关闭最近最少使用的连接。

对于HTTP，应将 proxy\_http\_version指令设置为“1.1”，并清除 “Connection” 头字段：

upstream http_backend {
        server 127.0.0.1:8080;
    
        keepalive 16;
    }
    
    server {
        location /api/ {
            proxy_pass http://http_backend;
            proxy_http_version 1.1;
            #即使客户端和代理服务器使用的是短链接，代理服务器和上游服务器之间也将使用长连接。
            proxy_set_header Connection ""; 
            ...
        }
    }

和它一起使用的还有两个参数，分别是：

*  keepalive\_requests:设置通过一个keepalive连接可以处理的最大请求数。
 *  keepalive\_timeout 空闲keepalive保持打开的超时时间。

注意：对于fastcgi服务器，需要开启fastcgi\_keep\_conn才能使keepalive连接正常工作。

**last\_conn**  
指定服务器组的负载均衡方法,将请求传递到活动连接数最少的服务器，同时需要考虑权重。如果有多个这样的服务器，就使用轮询的方法。

**random**  
语法：random \[two \[method\]\]; 指定服务器组的负载均衡方法，其中将请求随机传递到选择的服务器，同时需要考虑服务器权重。

**resolver**  
语法：resolver address ... \[valid=time\] \[ipv6=on|off\] \[status\_zone=zone\]; 配置用于解析上游服务器名的域名解析服务器。

#### 变量 ####

upstream模块支持以下变量：

*  $upstream\_addr:上游服务器的ip和端口活着UNIX套接字的路径。
 *  $upstream\_bytes\_received:从上游服务器中收到的字节数。
 *  $upstream\_bytes\_send：发送到上游服务器的字节数。
 *  $upstream\_connect\_time：与上游服务器建立连接的时间。
 *  $upstream\_cookie\_name：上游服务器在“Set-Cookie”响应头字段中发送的具有指定值的cookie。
 *  $upstream\_header\_time：从上游服务器接收header耗费的时间。
 *  $upstream\_response\_length：从上游服务器接收响应的长度（bytes）。
 *  $upstream\_response\_time：接收上游服务器接收响应耗费的时间。
 *  $upstream\_status：上游服务器的响应状态。

#### 7.nginx反向代理 ####

默认情况下proxy模块默认是启用的，通过该模块能够将客户端的HTTP请求转发到后端服务器。 注意：如无特殊说明，指令的作用域都为：http,server,location。  
示例：

location / {
        proxy_pass       http://localhost:8000;
        proxy_set_header Host      $host;
        proxy_set_header X-Real-IP $remote_addr;
    }

**模块指令**

下面简要介绍几个主要指令，其他指令用是可以查看官方文档。注意：如无特殊说明该模块指令作用域为：http、server、location

**主要指令**  
**proxy\_pass**：指定转发给后端服务器的协议和地址。

语法：proxy\_pass 协议://地址\[/URI\];

协议可以是http或https。地址可以是TCP套接字（域名或者ip地址+port）、UNIX域套接字，还可以指向upstream区段。URI是可选部分，如果指定了URI，location 后面指定的路径将被替换。

作用域：location, location中的if

proxy_pass http://localhost:8080;
    proxy_pass http://127.0.0.1:8080;
    proxy_pass http://unix:/tmp/backend.sock;
    proxy_pass https://192.168.0.1;
    proxy_pass http://localhost:8080/uri/;
    proxy_pass http://unix:/tmp/backend.sock:/uri/:
    # URL中还可以使用变量
    proxy_pass http://$server_name:8080;
    
    #指向upstream区段
    #格式：proxy_pass http://myblock;
    upstream backend {
        server 127.0.0.1:8080;
        server 127.0.0.1:8081;
    }
    location ~ \.php($|/) {
        fastcgi_pass http://backend;
    }

注意：如果proxy\_pass指定了URI，那么location匹配不能使用正则表达式。如果代理的URI需要使用正则表达式，则可以使用rewrite和proxy\_pass结合的方式来定义转发路径。此时proxy\_pass 后面定义的URL不再生效。

location /static_js/ {
        rewrite /static_js/(._)$ /$1 break;
        proxy_pass http://js.test.com;
    }

参数说明：

*  error：与服务器建立连接或传递请求或读取响应头时发生错误。
 *  timeout：与服务器建立连接或传递请求或读取响应头时发生超时。
 *  invalid\_header：后端服务器返回空或无效的响应
 *  http\_xxx：发生对应HTTP错误。
 *  off:禁止将请求传递到下一个服务器。

proxy_next_upstream error timeout http_504;

**proxy\_ignore\_headers**：禁用来自后端服务器的某些响应头字段。可以忽略以下字段：X-Accel-Redirect、Expires、Cache-Control、Set-Cookie和Vary。

**proxy\_set\_body**：用于重新定义传递给后端服务器的请求正文，一般用于调试目的。

**proxy\_set\_header**：用于重新定义或增加传递给后端服务器的请求头字段。 语法：proxy\_set\_header field value; 默认值：proxy\_set\_header Host $proxy\_host; proxy\_set\_header Connection close;

除以上外还有proxy\_method、proxy\_hide\_header、proxy\_pass\_header、proxy\_pass\_request\_body、proxy\_pass\_request\_header、proxy\_redirect等指令。

**缓冲、缓存和临时文件**  
**proxy\_buffer\_size**：设置缓冲区大小，该缓冲区用于存放来自后端服务器响应数据的开始不分。默认情况下，缓冲区的大小等于一个内存页（根据平台不同,4k或8k）

**porxy\_buffering**:定义是否缓冲后端服务器的响应，如果禁用，响应就直接转发给客户端。  
语法：proxy\_buffering on | off;  
默认：proxy\_buffering on;

**proxy\_buffers** ：设置缓冲区数量和大小，用于存放从后端服务器读取的响应数据。默认情况下，缓冲区的大小等于一个内存页。  
语法：proxy\_buffers number size；  
默认：proxy\_buffers 8 4k | 8k;

**proxy\_busy\_buffers\_size**:在缓冲区中，收到后端服务器数据总大小超过该指令指定大小时，缓冲区就会被刷新，并且数据被发送到客户端。默认为2\*proxy\_buffer\_size。  
默认值：proxy\_busy\_buffers\_size 8k | 16k;

**proxy\_cache\_前缀开头的指令**：用于定义存放缓存文件目录等。  
例如：proxy\_cache、proxy\_cache\_key、proxy\_cache\_path等。

**超时、错误及限制**  
**proxy\_connect\_timeout**:定义连接到后端服务器的超时时间。  
默认：proxy\_connect\_timeout 60s;

**proxy\_read\_timeout**:定义从后端服务器读取数据的超时时间，超时设置仅表示在两个连续的读操作之间，而不是整个响应的传输。如果上游服务器未传输任何内容，则连接被关闭。  
默认：proxy\_read\_timeout 60s;

**proxy\_send\_timeout**：定义从发送数据到后端服务器的超时时间，超时设置仅表示在两个连续写操作之间，而不是整个请求的传输。如果后端服务器在这期间未收到任何数据，则连接被关闭。  
默认：proxy\_send\_timeout 60s;

**proxy\_ignore\_client\_abort**：确定当客户端关闭和代理服务器间的连接时，是否关闭与后端服务器的连接。 默认值：proxy\_ignore\_client\_abort off;

除此之外还有proxy\_intercept\_errors、proxy\_send\_lowat、 proxy\_headers\_hash\_max\_size、proxy\_headers\_hash\_bucket\_size、proxy\_store、proxy\_store\_access等指令等指令。

**变量**

*  $proxy\_host：当前请求后端服务器的名称；
 *  $proxy\_port：当前请求后端服务器的端口。
 *  $proxy\_add\_x\_forwarded\_for：该变量包含“X-Forwarded-For”请求头的值，后跟远程客户端的ip地址，这两个值由逗号分割，如果客户端请求头中不存在“X-Forwarded-For”字段，则该变量等于$remote\_addr的值。

#### 8.扩展阅读 ####

nginx 官方文档：[https://nginx.org/en/docs/][https_nginx.org_en_docs]

nginx全面配置 包括实例：[Nginx全面配置 - 知乎 (zhihu.com)][Nginx_ - _ _zhihu.com]

[Nginx配置文件\_nginx 配置文件-CSDN博客][Nginx_nginx _-CSDN]

[NGINX - _ _nginx-cn.net]: https://www.nginx-cn.net/pricing/?utm_medium=cpc&utm_source=baidu&utm_campaign=apcj_china-nx_ssap_ngx&bd_vid=11977855821247791633/
[418c830ad94d48a48fbc04026c0f7f7c.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/19/0cfd74f3150d4292a7eee9689cd7b50e.png
[NGINX _ nginx_ download]: https://nginx.org/en/download.html
[nginx.org upstream]: https://link.zhihu.com/?target=http%3A//nginx.org/en/docs/http/ngx_http_upstream_module.html
[https_nginx.org_en_docs]: https://link.zhihu.com/?target=https%3A//nginx.org/en/docs/
[Nginx_ - _ _zhihu.com]: https://zhuanlan.zhihu.com/p/625184405
[Nginx_nginx _-CSDN]: https://blog.csdn.net/qq_40811542/article/details/130749579