nginx中的proxy_set_header参数详解

在使用 Nginx 作为反向代理服务器时，proxy_set_header 指令扮演着至关重要的角色。它允许我们自定义请求头信息，将客户端请求传递给上游服务器时，添加或修改特定的信息，从而实现更灵活的代理功能。本文将深入探讨 proxy_set_header 指令的用法，并结合实际场景，分析其在不同应用场景下的作用。

1、proxy_set_header 的指令概述

proxy_set_header 是 Nginx 配置中用于设置代理请求 HTTP 头部的指令。当 Nginx 作为反向代理时，它允许自定义从客户端接收到的请求或添加新的请求头，然后将其转发到后端服务器。这对于维护 HTTP 协议的连贯性、安全性和功能性至关重要。

2、proxy_set_header指令的语法

proxy_set_header 指令的语法如下：

proxy_set_header  ;

• ：要设置或修改的 HTTP 请求头的名称。

• ：请求头的新值，可以是静态字符串、变量或表达式。

• value 可以是字符串、变量或它们的组合。Nginx 提供了丰富的内置变量，可以方便地获取请求信息，例如：

  host: Host头部是 HTTP 请求中用于指定请求资源的服务器地址。在代理设置中，proxy_set_header Host $host; 确保了请求头中的 Host 字段被正确传递，避免了请求中的 Host 头被 Nginx 默认值覆盖。
  X-Forwarded-For：用于记录经过的代理服务器的 IP 地址链。
  X-Forwarded-Proto：指示原始请求使用的协议（HTTP 或 HTTPS）。
  $http_user_agent: 客户端的 User-Agent 信息。
  $request_uri: 客户端请求的 URI。
  X-Real-IP: X-Real-IP头部用于记录客户端的真实 IP 地址。在代理设置中，proxy_set_header X-Real-IP $remote_addr; 可以防止 Nginx 重写原始请求中的 IP 地址，使得后端服务能够识别客户端的真实来源。
  Origin：用于 CORS（跨域资源共享）请求，指示请求的来源。

3、proxy_set_header 指令的应用场景

假设您有一个运行在内网的 Web 应用服务器，您希望通过 Nginx 反向代理将该应用暴露给外网用户。以下是一些可能的配置场景：

1. 传递客户端 IP 地址:

在代理环境中，上游服务器无法直接获取客户端的真实 IP 地址。为了让上游服务器能够识别客户端的真实 IP 地址，可以使用 proxy_set_header 指令传递客户端 IP 地址。

proxy_set_header X-Real-IP $remote_addr;

• X-Real-IP 是一个自定义的请求头字段，用于存储客户端的真实 IP 地址。
• 上游服务器可以通过读取 X-Real-IP 字段获取客户端的 IP 地址。

2. 传递代理信息:

在多级代理环境中，上游服务器可能需要了解请求经过了哪些代理服务器。可以使用 proxy_set_header 指令传递代理信息。

proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;

• X-Forwarded-For 是一个标准的请求头字段，用于存储客户端 IP 地址和所有代理服务器的 IP 地址，以逗号分隔。
• 上游服务器可以通过读取 X-Forwarded-For 字段获取所有代理服务器的 IP 地址。

3. 支持 WebSocket 协议:

WebSocket 协议是一种双向通信协议，需要在请求头中设置 Upgrade 和 Connection 字段。可以使用 proxy_set_header 指令传递 WebSocket 协议信息。

proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";

• $http_upgrade 变量获取客户端请求的 Upgrade 字段的值。
• 将 Connection 字段设置为 upgrade，表示请求升级为 WebSocket 协议。

4. 自定义请求头信息:

除了传递客户端 IP 地址和代理信息，还可以使用 proxy_set_header 指令添加其他自定义的请求头信息，例如：

proxy_set_header X-My-Header "My Value";

• X-My-Header 是一个自定义的请求头字段，用于存储自定义信息。
• 上游服务器可以通过读取 X-My-Header 字段获取自定义信息。

5. 移除请求头信息:

可以使用 proxy_set_header 指令将请求头字段的值设置为 “”，从而移除该请求头字段。

proxy_set_header User-Agent "";

• 这将移除请求头中的 User-Agent 字段。

6、跨域资源共享 (CORS)

在处理跨域请求时，后端服务器需要知道请求的来源。通过设置 Origin 请求头，后端可以根据需要决定是否允许该请求。例如：

proxy_set_header Origin $http_origin;

这将确保后端服务器能够接收到正确的来源信息，从而做出相应的 CORS 响应。

配置示例

server {
    listen 8080;
    server_name your_domain.com;

    location / {
        proxy_pass http://backend_server:80;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_set_header Origin $http_origin;
        proxy_read_timeout 6000s;
        proxy_set_header X-NginX-Proxy true;
        proxy_http_version 1.1;
        chunked_transfer_encoding off;
    }
}

在这个配置中，Nginx将请求转发到backend_server，并通过各种proxy_set_header指令传递客户端的相关信息。

proxy_set_header 指令的注意事项

• 确保设置的请求头字段名称和值符合规范，避免与其他请求头字段冲突。
• 确保 proxy_set_header 指令在正确的 location 块内，以便它们只应用于特定的请求。
• 谨慎使用 proxy_set_header 指令，避免传递敏感信息，例如用户密码等。
• 在使用 proxy_set_header 指令时，需要根据实际情况选择合适的变量和值，以确保上游服务器能够正确识别和处理请求信息。

总结

proxy_set_header 指令是 Nginx 反向代理服务器中一个非常重要的指令，为反向代理配置提供了强大的灵活性。它允许我们自定义请求头信息，传递客户端 IP 地址、代理信息、WebSocket 协议信息等，从而实现更灵活的代理功能。在使用 proxy_set_header 指令时，需要根据实际情况选择合适的变量和值，以确保上游服务器能够正确识别和处理请求信息。