nginx-Web服务器

客官°小女子只卖身不卖艺 2022-01-05 07:15 371阅读 0赞

nginx最常用的是作为一个web服务器，既能代理静态资源，也能转发请求。

以下是本博客的目录：  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3NzZWhz_size_16_color_FFFFFF_t_70]

## 建立虚拟服务 ##

使用**listen**指令指定ip和端口：

server {
        listen 127.0.0.1:8080;
        # The rest of server configuration
    }

1.  如果没有指定端口，则为默认80；
2.  如果没有指定IP，则监听所有的IP（一台电脑可以有几个IP吧）；
3.  如果没有listen指令，则监听**80/tcp**或者**8000/tcp** ,视系统而定。

如果多个虚拟服务监听相同的IP和端口，那么nginx会比较请求的**Host**参数和**server\_name**来决定选择哪一个虚拟服务。  
sever\_name可以是以下几种形式：

1.  全称
2.  包含通配符（\*）
3.  正则表达式（以~开头）**（注意，nginx采用的是perl语言的正则表达式语法）**

如果有多个虚拟服务的server\_name匹配Host，nginx使用以下次序来选择（由具体到抽象）：

1.  全称
2.  以\*开头
3.  以\*结尾
4.  正则表达式（如果有多个满足，按配置文件的次序选择第一个满足的虚拟服务）

最后，如果Host没有匹配任何server\_name，则选择默认的虚拟服务；一般默认是第一个server块，除非用default\_server指定默认的虚拟服务。

server {
        listen      80 default_server;
        ...
    }

## 配置路径 ##

**location**指令的参数可以是：

1.  前缀字符串（**必须是路径的开头**，不能是路径的中间部分或者末尾部分）
2.  正则表达式（perl正则表达式语法）

对于1，/some/path/能匹配/some/path/document.html，但是不能匹配/my-site/some/path；  
对于2，

1.  如果以~开头，则大小写敏感；
2.  如果~\*开头，则大小写不敏感；

location ~ \.html? {
        ...
    }

上面的代码匹配任何包含.html或者.htm的路径。  
匹配路径时，**正则表达式的优先级要高于前缀字符串**  
nginx处理请求时，选择路径的逻辑如下：

1.  测试所有的前缀字符串；
2.  =定义了uri和前缀字符串的精准匹配，如果精准匹配找到，则搜索停止；
3.  如果匹配的最长前缀字符串以^~开头，则正则表达式不会被检查；
4.  保存最长的前缀字符串；
5.  测试所有的正则表达式；
6.  如果有正则表达式匹配，则选取相应的路径；
7.  如果没有正则表达式匹配，则选取保存的最长前缀字符串所在的路径。

注意，**规则3改变了正则表达式和前缀字符串的优先级**，如果最长的前缀字符串没有以^~开头，则会检查正则表达式，这个最长的前缀字符串是否被选取，要等正则表达式匹配结束才知道。

=一般用在频繁请求的路径，这样可以加快代理速度，因为一旦匹配，搜索停止。

一个location块既可以代理静态资源也可以转发请求：

server {
        location /images/ {
            root /data;
        }
    
        location / {
            proxy_pass http://www.example.com;
        }
    }

如果请求匹配第一个location，则会提供/data目录下的文件；如果请求匹配第二个location，则会转发到http://www.example.com。  
root指令指定了系统文件的服务路径，uri的请求路径会追加到服务路径之后，共同组成目标文件的全路径。上面的例子中，请求/images/example.png的目标路径是/data/images/example.png。  
proxy\_pass指令转发请求到目标服务器，目标服务器的应答会回传给客户端。上面的例子中，任何不以/images/开头的请求都会转发到目标服务器上。

## 使用变量 ##

可以在配置文件中使用变量让nginx在不同的场景有着不同的请求处理方式。变量是具名的值，并且是运行时计算的，通常用作指令的参数。变量以$开头的名称表示。变量是根据nginx的状态定义的信息，比如正被处理请求的属性。

nginx预置了很多的系统变量，比如核心HTTP变量，可以使用set,map和geo指令来定义用户变量。大多变量都是运行时计算的，并且和请求挂钩。比如$remote\_addr包含了客户端的IP地址，$uri保存了URI值。

## 返回状态码 ##

有些网站能够立即返回错误码和重定向码，比如页面被临时或者永久移除。实现这个功能最简单的办法是使用return指令。比如：

location /wrong/url {
        return 404;
    }

return指令的第一个参数是返回码。第二个参数是可选的，可以是重定向地址（针对返回码：301,302,303和307），也可以是应答的文本。例如：

location /permanently/moved/url {
        return 301 http://www.example.com/moved/here;
    }

return指令可以包含在location和server中。

## 资源重写 ##

uri请求在处理的过程中可以被rewrite指令多次修改，该指令有一个可选参数和2个必填参数。第一个参数（必填）定义了uri必须匹配的正则表达式。第二个参数是匹配的uri的代替uri。第三个可选参数是一个标志，用来停止后续的rewrite指令或者发送一个重定向码（301或302）。比如：

location /users/ {
        rewrite ^/users/(.*)$ /show?user=$1 break;
    }

如上，第二个参数通过匹配正则表达式捕获。  
server和location块中可包含多个rewrite指令。nginx按照次序依次执行。当一个server块匹配时，server块中的rewrite指令会执行一次。  
nginx处理完一系列的rewrite指令之后，会根据新的uri来匹配location。如果location块包含rewrite指令，这些rewrite指令会被依次执行。如果有rewrite指令匹配，则会根据新的uri开启新一轮的location搜索。  
下面的例子展示了rewrite和return指令的用法：

server {
        ...
        rewrite ^(/download/.*)/media/(.*)\..*$ $1/mp3/$2.mp3 last;
        rewrite ^(/download/.*)/audio/(.*)\..*$ $1/mp3/$2.ra  last;
        return  403;
        ...
    }

这个配置区别两种uri，类似(**/download/some/media/file**)的uri被重写为(**/download/some/mp3/file.mp3**)。因为last标志，nginx跳过下游指令（第二个rewrite指令和return指令），并继续用新的uri匹配。类似的，像/download/some/audio/file的uri会被替换为 /download/some/mp3/file.ra，如果uri没有匹配任何rewrite指令，nginx返回403给客户端。

有两个打断匹配过程的指令：

*  last-停止执行当前server或者location块的rewrite指令，并且搜索匹配新uri的location块，然后执行里面的rewrite指令（意味着uri可以再次更改）。
 *  break-与last指令类似，停止执行当前块的rewrite指令，但取消搜索匹配新uri的location块。新location块的rewrite指令并不会执行。

## 应答重写 ##

有时需要重写或者改变应答的内容，用一个字符串替换另一个字符串。可以使用sub\_filter指令定义要应用的重写。该指令支持变量和替换链，使更复杂的更改成为可能。

例如，可以更改指向代理以外的服务器的绝对链接。

location / {
        sub_filter      /blog/ /blog-staging/;
        sub_filter_once off;
    }

另一个例子把方法从http://更改为htttp\_s://并把请求头的字段从localhost地址改为主机名。sub\_filter\_once指令指示nginx连续地应用location块中的sub\_filter指令。

location / {
        sub_filter     'href="http://127.0.0.1:8080/'    'href="https://$host/';
        sub_filter     'img src="http://127.0.0.1:8080/' 'img src="https://$host/';
        sub_filter_once on;
    }

要注意的是已经被一个sub\_filter指令修改的应答将不会再被另一个sub\_filter修改。

## 处理错误 ##

使用error\_page指令，可以配置nginx返回一个自定义页面和一个错误页，代替一个不同的错误码，或者重定向浏览器到一个不同的uri。下面这个例子中，error\_page指定（/404.html）和404错误码一起返回。

error_page 404 /404.html;

注意该指令并不表示错误会立即返回（return指令才会立即返回）,只是指示当错误发生时，nginx该如何处理。错误码可以从目标服务器或者nginx运行时发生（例如，当nginx找不到客户端请求的文件时返回404）。

下面的例子中，当nginx不能找到页面时，替换404为301，并且重定向客户端到http:/example.com/new/path.html。当客户端还试着用旧的uri访问该页时会很有用。301告知浏览器该页已经永久性移动，在返回结果时，需自动地将旧的地址换成新的地址。

location /old/path.html {
        error_page 404 =301 http:/example.com/new/path.html;
    }

下面的配置是这样的一个例子，当文件找不到时，nginx会把请求转发到后端。由于error\_page指令的=后面没有指定状态码，返回的状态码将由目标服务器决定（并不一定是404）。

server {
        ...
        location /images/ {
            # Set the root directory to search for the file
            root /data/www;
    
            # Disable logging of errors related to file existence
            open_file_cache_errors off;
    
            # Make an internal redirect if the file is not found
            error_page 404 = /fetch$uri;
        }
    
        location /fetch/ {
            proxy_pass http://backend/;
        }
    }

error\_page指令指示nginx在找不到文件时做一个内部的重定向。error\_page指令的最后一个参数中的$uri变量保存了当前请求的uri，该uri在重定向时传递。

例如，如果/images/some/file未找到，就会被替换成/fetch/images/some/file，开启新一轮的location搜索。最终，请求会被代理到第二个location的http://backend/。

open\_file\_cache\_errors指令防止在文件未找到时写入错误信息。这里没有必要打开该指令因为文件缺失会被正确地处理。

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3NzZWhz_size_16_color_FFFFFF_t_70]: /images/20211229/087b8d3de02e414083b0a00caa1ef4da.png