nginx代理转发说明

叁歲伎倆 2022-12-16 09:05 464阅读 0赞

## 1、nginx 默认转发header，个别字段除外 ##

说明：

（1）**proxy\_hide\_header**

<table> 
 <tbody> 
  <tr> 
   <td>语法:</td> 
   <td><code><strong>proxy_hide_header</strong>&nbsp;<code><em>field</em></code>;</code></td> 
  </tr> 
  <tr> 
   <td>默认值:</td> 
   <td>—</td> 
  </tr> 
  <tr> 
   <td>上下文:</td> 
   <td><code>http</code>,&nbsp;<code>server</code>,&nbsp;<code>location</code></td> 
  </tr> 
 </tbody> 
</table>

nginx默认不会将**“Date”、“Server”、“X-Pad”，和“X-Accel-...”**响应头发送给客户端。`proxy_hide_header`指令则可以设置额外的响应头，这些响应头也不会发送给客户端。相反的，如果希望允许传递某些响应头给客户端，可以使用[proxy\_pass\_header][proxy_pass_header]指令。

（2）**proxy\_pass\_header（其功能与proxy\_hide\_header相反，会将原来不允许转发的改为允许转发）**

<table> 
 <tbody> 
  <tr> 
   <td>语法:</td> 
   <td><code><strong>proxy_pass_header</strong>&nbsp;<code><em>field</em></code>;</code></td> 
  </tr> 
  <tr> 
   <td>默认值:</td> 
   <td>—</td> 
  </tr> 
  <tr> 
   <td>上下文:</td> 
   <td><code>http</code>,&nbsp;<code>server</code>,&nbsp;<code>location</code></td> 
  </tr> 
 </tbody> 
</table>

允许传送[被屏蔽][Link 1]的后端服务器响应头到客户端。

（3）**proxy\_set\_header**

<table> 
 <tbody> 
  <tr> 
   <td>语法:</td> 
   <td><code><strong>proxy_set_header</strong>&nbsp;<code><em>field</em></code>&nbsp;<code><em>value</em></code>;</code></td> 
  </tr> 
  <tr> 
   <td>默认值:</td> 
   <td> <pre><code>proxy_set_header Host $proxy_host;</code></pre> <pre><code>proxy_set_header Connection close;</code></pre> </td> 
  </tr> 
  <tr> 
   <td>上下文:</td> 
   <td><code>http</code>,&nbsp;<code>server</code>,&nbsp;<code>location</code></td> 
  </tr> 
 </tbody> 
</table>

允许重新定义或者添加发往后端服务器的请求头。`value`可以包含文本、变量或者它们的组合。 当且仅当当前配置级别中没有定义`proxy_set_header`指令时，会从上面的级别继承配置。 默认情况下，只有两个请求头会被重新定义：

>     proxy_set_header Host       $proxy_host;
>     proxy_set_header Connection close;

如果不想改变请求头“Host”的值，可以这样来设置：

>     proxy_set_header Host       $http_host;

但是，如果客户端请求头中没有携带这个头部，那么传递到后端服务器的请求也不含这个头部。 这种情况下，更好的方式是使用`$host`变量——它的值在请求包含“Host”请求头时为“Host”字段的值，在请求未携带“Host”请求头时为虚拟主机的主域名：

>     proxy_set_header Host       $host;

此外，服务器名可以和后端服务器的端口一起传送：

>     proxy_set_header Host       $host:$proxy_port;

如果某个请求头的值为空，那么这个请求头将不会传送给后端服务器：

>     proxy_set_header Accept-Encoding "";

## 2、nginx 默认转发body ##

说明：

**proxy\_pass\_request\_body（默认是打开的）**

<table> 
 <tbody> 
  <tr> 
   <th>Syntax:</th> 
   <td><code><strong>proxy_pass_request_body</strong>&nbsp;<code>on</code>&nbsp;|&nbsp;<code>off</code>;</code></td> 
  </tr> 
  <tr> 
   <th>Default:</th> 
   <td> <pre><code>proxy_pass_request_body on;</code></pre> </td> 
  </tr> 
  <tr> 
   <th>Context:</th> 
   <td><code>http</code>,&nbsp;<code>server</code>,&nbsp;<code>location</code></td> 
  </tr> 
 </tbody> 
</table>

Indicates whether the original request body is passed to the proxied server.

>     location /x-accel-redirect-here/ {
>         proxy_method GET;
>         proxy_pass_request_body off;
>         proxy_set_header Content-Length "";
>     
>         proxy_pass ...
>     }

See also the [proxy\_set\_header][proxy_set_header] and [proxy\_pass\_request\_headers][proxy_pass_request_headers] directives.

参考：

（1）Nginx基础入门之proxy反向代理常用配置项说明：[https://blog.51cto.com/blief/1739178][https_blog.51cto.com_blief_1739178]

（2）Nginx中文手册：[http://tengine.taobao.org/nginx\_docs/cn/docs/http/ngx\_http\_proxy\_module.html\#proxy\_hide\_header][Link 1]

（3）Nginx英文手册：[http://nginx.org/en/docs/http/ngx\_http\_proxy\_module.html\#proxy\_pass\_header][http_nginx.org_en_docs_http_ngx_http_proxy_module.html_proxy_pass_header]

[proxy_pass_header]: http://tengine.taobao.org/nginx_docs/cn/docs/http/ngx_http_proxy_module.html#proxy_pass_header
[Link 1]: http://tengine.taobao.org/nginx_docs/cn/docs/http/ngx_http_proxy_module.html#proxy_hide_header
[proxy_set_header]: http://nginx.org/en/docs/http/ngx_http_proxy_module.html#proxy_set_header
[proxy_pass_request_headers]: http://nginx.org/en/docs/http/ngx_http_proxy_module.html#proxy_pass_request_headers
[https_blog.51cto.com_blief_1739178]: https://blog.51cto.com/blief/1739178
[http_nginx.org_en_docs_http_ngx_http_proxy_module.html_proxy_pass_header]: http://nginx.org/en/docs/http/ngx_http_proxy_module.html#proxy_pass_header