Nginx 教程：配置 Web 服务器

server {
    location /images/ {
        root /data;
    }

    location / {
        proxy_pass http://www.example.com;
    }
}

root 指令指定在其中搜索要提供的静态文件的文件系统路径。与该位置关联的请求 URI 将附加到路径中，以获取要显示的静态文件的全名。上例中，响应/images/logo.png的请求，NGINX在服务器本地实际提供的对应文件为：/data/images/logo.png ❝。指令

proxy_pass 使用配置的 URL 将请求发送到访问代理服务器。然后代理服务器的响应被发送回客户端。在上面的示例中，所有对不以 /images/ 开头的 URI 的请求都将转发到代理服务器（即：www.example.com）。

3。使用变量

您可以使用配置文件中的变量，使NGINX进程的请求根据定义的情况而有所不同。变量是在运行时计算并用作指令参数的命名值。变量由以其名称开头的 $（美元）符号表示。变量根据 NGINX 的状态定义信息，例如正在处理的请求的属性。

有许多预定义变量作为核心 HTTP 变量，您可以使用 set、map 和 gege 定义自定义变量 大多数变量在运行时计算，包含与特定请求相关的信息。例如，$remote_addr 包含客户端的 IP 地址，$uri 包含当前 URI 值。

4。返回特定状态代码

某些站点 URI 必须立即返回带有特定错误或重定向代码的响应，例如当页面临时或永久移动时。最简单的方法是使用命令return。例如，404 返回未找到的状态代码：

location /wrong/url {
    return 404;
}

返回的第一个参数是响应代码。可选的第二个参数可以是重定向的 URL（代码 301、302、303 和 307）或响应正文中返回的文本。例如：

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

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

重写 URI 请求

使用 rewrite 指令可以在请求处理过程中多次更改请求 URI，该指令有 1 个可选参数和 2 个参数。第一个（必需）参数是请求 URI 必须匹配的正则表达式。第二个参数是用于替换匹配 URI 的 URI。可选的第三个参数是一个标志，可以停止处理进一步的重写指令或发送重定向（代码301或302）。例如：

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

如本示例所示，用户通过匹配正则表达式来捕获第二个参数。

您可以在 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。由于最后一个标志，后续指令（第二个rewrite和return指令）将被跳过，但NGINX继续处理请求，该请求现在具有不同的URI。同样，诸如 /download/nogle/lyd/fil 之类的 URI 会替换为 /download/nogle/mp3/fil.ra。如果 URI 与 rewrite 指令不匹配，NGINX 将向客户端返回 403 错误代码。

中断处理重写指令有两个参数：

• last - 在当前服务器或位置上下文中停止执行重写指令，但 NGINX 搜索与重写的 URI 匹配的位置并应用 Any在新位置重写指令（可以再次更改 URI 并继续向下匹配）。
• break - 与 break 类似，停止在当前上下文中处理重写指令，并取消搜索与新 URI 匹配的位置。新位置（位置）处的rewrite指令不会执行。

5。重写 HTTP 响应

有时您需要重写或更改 HTTP 响应的内容，并将一个字符串替换为另一个字符串。您可以使用 sub_filter 指令来定义要应用的覆盖。该指令支持变量和替换链，使更复杂的更改成为可能。
例如，您可以更改引用除代理服务器之外的其他内容的绝对链接：

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

另一个示例将方法从 http:// 更改为 http:// ，并将 localhost 地址替换为请求标头字段中的主机名。指令 sub_filter_once 告诉 NGINX 在某个位置（location）内连续应用 sub_filter。伪命令：

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

注意，如果另一个出现sub_filter，如果匹配，则使用sub_filter修改的响应部分将不再被替换。

1. 错误处理

使用error_page指令，您可以将NGINX配置为返回自定义页面以及错误代码，替换浏览器对不同URI的响应中的其他错误代码。在以下示例中，error_page 指令指定返回404 页面错误代码 (/404.html) 的页面。

error_page 404 /404.html;

请注意，该指令不会立即返回错误（返回指令会），而只是指定错误发生时如何处理。该错误代码可能来自代理服务器或在 NGINX 处理过程中发生（例如，当 NGINX 找不到客户端请求的文件时，会显示404）。

在以下示例中，当 NGINX 找不到页面时，它会将代码 301 替换为代码 404 并将客户端重定向到 http://example.com/new/path .html 。当客户端仍尝试使用旧 URI 访问页面时，此配置非常有用。 301 代码通知浏览器页面已永久移动，并且必须在返回时自动替换旧地址。

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

以下配置是在找不到文件时向后端发送请求的示例。由于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。

例如，如果/images/some/file不存在，则会被/fetch/images/some/file❀,替换为新的搜索位置位置）开始。最后，请求在第二个 location 上下文中结束，并发送到 http://backend/。

open_file_cache_errors 指令可防止在文件不存在时写入错误消息。由于可以正确处理丢失的文件，因此这不是必需的。