当前位置： 首页 > news >正文

Nginx(十三) 配置文件详解 - 反向代理（超详细）

news 2025/7/5 18:25:46

        本篇文章主要讲ngx_http_proxy_module和ngx_stream_proxy_module模块下各指令的使用方法。

1. 代理请求 proxy_pass 

1.1 proxy_pass 代理请求

Syntax:    proxy_pass URL;
Default:    —
Context:    location, if in location, limit_except

        设置代理服务器的协议和地址以及location应映射到的可选 URI。协议可指定为 "http "或 "https"。地址可指定为域名或 IP 地址，以及一个可选端口，如：

proxy_pass http://localhost:8000/uri/;

        如果一个域名解析到多个地址，所有地址都将以循环方式使用。另外，还可以将一个地址指定为一个服务器组（即负载均衡组，proxy_pass配合upstream一起使用）。

        参数值可以包含变量。在这种情况下，如果将地址指定为域名，则在描述的服务器组中搜索该名称，如果找不到，则使用resolver指令确定。

如果proxy_pass指令已指定URI，请求URI将按如下步骤发送给服务器：

	location /pages/ {proxy_pass http://127.0.0.1:8688/test/;}

  1. 原始请求为：http://47.**.**.80:8688/pages/test/mg.js

  2. 最终请求为：http://127.0.0.1:8688/test/test/mg.js。将原始请求中与location匹配的部分替换成指定的URI。

  3. 使用替换后的请求URL进行代理转发。

Nginx记录日志如下

{"time_iso8601":"2023-12-30T15:16:50+08:00","http_host":"127.0.0.1:8688","remote_addr":"127.0.0.1","request_uri":"/test/test/mg.js","status":"404","bytes_sent":"720","request_time":"0.000","gzip_ratio":"",}
{"time_iso8601":"2023-12-30T15:16:50+08:00","http_host":"47.**.**.80:8688","remote_addr":"14.145.163.198","request_uri":"/pages/test/mg.js","status":"404","bytes_sent":"749","request_time":"0.000","gzip_ratio":"",}

结论：

        如果 proxy_pass 指定了 URI，Nginx 会将原始请求中与location完全匹配的部分替换成指定的URI，原始请求URI之后的内容仍保持不变。

再看一个小测试。修改Nginx配置如下，去掉location name “/pages/” 后面的“/”

	location /pages {proxy_pass http://127.0.0.1:8688/test/;}

原始请求URL：http://47.**.**.80:8688/pagesttt/test/mg.js，大胆猜测下Nginx代理请求URL会是什么。

请求请求URL：http://47.**.**.80:8688/test/ttt/test/mg.js

Nginx日志如下

{"time_iso8601":"2023-12-30T15:23:54+08:00","http_host":"127.0.0.1:8688","remote_addr":"127.0.0.1","request_uri":"/test/ttt/test/mg.js","status":"404","bytes_sent":"720","request_time":"0.000","gzip_ratio":"",}
{"time_iso8601":"2023-12-30T15:23:54+08:00","http_host":"47.**.**.80:8688","remote_addr":"14.145.163.198","request_uri":"/pagesttt/test/mg.js","status":"404","bytes_sent":"749","request_time":"0.000","gzip_ratio":"",}

        一定要注意上面结论里提到的完全匹配！！！ 所以，我们在配置代理请求时要尽量把location配置成精确匹配 = ，如果只能配置成通用匹配，那就尽量在location name后面也加上"/"。location的匹配规则及优先级可以参考这篇文章 Nginx(六) Nginx location 匹配顺序及优先级深究(亲测有效)_ng location 先后顺序

如果proxy_pass指令未指定URI，请求URI将按如下步骤发送给服务器：

	location /pages/ {proxy_pass http://127.0.0.1:8080;}

  1. 原始请求为：http://47.**.**.80:8688/pages/test/mg.js

  2. 最终请求为：http://127.0.0.1:8080/pages/test/mg.js。URI保持不变。

  3. 使用最终请求URL进行代理转发。

Nginx输出日志

{"time_iso8601":"2023-12-30T16:55:15+08:00","http_host":"127.0.0.1:8080","remote_addr":"127.0.0.1","request_uri":"/pages/test/mg.js","status":"404","bytes_sent":"720","request_time":"0.000","gzip_ratio":"",}
{"time_iso8601":"2023-12-30T16:55:15+08:00","http_host":"47.**.**.80:8688","remote_addr":"14.145.163.198","request_uri":"/pages/test/mg.js","status":"404","bytes_sent":"749","request_time":"0.000","gzip_ratio":"",}

结论：

        如果 proxy_pass 未指定 URI，且仅指定了代理服务器的IP(和端口)，后面未加"/"，那么代理请求URL中的URI还使用原始请求中的URI。

再看个小测试。修改Nginx配置如下，代理地址后增加一个"/"

	location /pages/ {proxy_pass http://127.0.0.1:8080/;}

  1. 原始请求为：http://47.**.**.80:8688/pages/test/mg.js

  2. 最终请求为：http://127.0.0.1:8080/test/mg.js。将原始请求中与location匹配的部分替换成空字符串（也可以理解成删除匹配部分）。

  3. 使用替换后的请求URL进行代理转发。

Nginx输出日志

{"time_iso8601":"2023-12-30T17:02:02+08:00","http_host":"127.0.0.1:8080","remote_addr":"127.0.0.1","request_uri":"/test/mg.js","status":"404","bytes_sent":"720","request_time":"0.000","gzip_ratio":"",}
{"time_iso8601":"2023-12-30T17:02:02+08:00","http_host":"47.**.**.80:8688","remote_addr":"14.145.163.198","request_uri":"/pages/test/mg.js","status":"404","bytes_sent":"749","request_time":"0.000","gzip_ratio":"",}

切记，如果location是正则表达式匹配， proxy_pass指令不能指定URI。

1.2 proxy_redirect 代理响应重定向

Syntax:    proxy_redirect default;
                proxy_redirect off;
                proxy_redirect redirect replacement;
Default:    proxy_redirect default;
Context:    http, server, location

        该指令用于设置如何处理代理服务器返回的重定向响应（301或302响应码）。简单直白的理解就是修改后端服务器返回的请求重定向路径，避免暴露后端服务器IP和端口。

  • proxy_redirect default：默认配置。当proxy_pass的URL与响应头字段Location的URL部分内容完全匹配时，Nginx此时会用server_name + listen port + 当前location的URI组合起来替换掉Location中与proxy_pass完全匹配的部分。没有完全匹配内容时，相当于proxy_redirect = off，后端服务器返回的Location是什么就给客户端返回什么。
  • proxy_redirect off：禁用proxy_redirect功能。后端服务器返回的Location是什么就给客户端返回什么。
  • proxy_redirect redirect replacement：指定用什么来替换哪部分内容。
    • redirect：替换哪部分。截取/完全匹配响应头字段Location的URL部分内容。
    • replacement：用什么替换。用该值替换掉redirect。该参数可以仅配置URI，省略掉HOST和Port，如果省略则使用当前server的server_name和listen port（80端口除外）组合起来代理host+port。

proxy_redirect 支持同时配置多个，可根据不同的需求配置多个proxy_redirect。

proxy_redirect default;
proxy_redirect http://localhost:8000/  /;
proxy_redirect http://www.example.com/ /;

        proxy_redirect 指令不同配置的重定向结果请参考这篇文章 Nginx(十五) proxy_pass和proxy_redirect指令的组合测试 

1.3 proxy_http_version Http协议版本

Syntax:    proxy_http_version 1.0 | 1.1;
Default:    proxy_http_version 1.0;
Context:    http, server, location
This directive appeared in version 1.1.4.

        设置代理请求时要使用的HTTP协议版本，默认是1.0。建议设置成1.1版本，使用1.1版本自带的“Connection：keep-alive”请求体字段来开启HTTP长连接。

1.4 proxy_set_header 设置请求头

Syntax:    proxy_set_header field value;
Default:    proxy_set_header Host $proxy_host;
                 proxy_set_header Connection close;
Context:    http, server, location

        在发送代理请求前，可通过该指令来新增或修改请求头字段信息。value可包含文本和变量。该指令可被继承，但只有在当前级别未配置该指令时，才会继承上一级的配置。默认情况下。只配置了如下两个请求头字段：

proxy_set_header Host       $proxy_host;
proxy_set_header Connection close;

        如果启用了代理缓存，那么原始请求头中的“ If-Modified-Since”，“ If-Unmodified-Since”，“ If-None-Match”，“ If-Match”，“ Range”和“ If-Range”字段不会传递到代理服务器。 

# 给代理服务器传递原始请求的host信息，如果请求头中没有http_host字段，那么传递的内容为空
proxy_set_header Host       $http_host;
# 如果原始请求头总没有http_host字段，也可使用$host变量来传递host信息
proxy_set_header Host       $host;
host也可以和代理服务器端口一起传递
proxy_set_header Host       $host:$proxy_port;
# 向后端服务器传递客户端真实IP
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;

1.5 proxy_set_body 设置请求体

Syntax:    proxy_set_body value;
Default:    —
Context:    http, server, location

        在发送代理请求前，可通过该指令来修改请求体信息。 value可包含文本和变量。

1.6 proxy_pass_header 允许传递的响应头

Syntax:    proxy_pass_header field;
Default:    —
Context:    http, server, location

        设置允许将后端服务器返回的响应头中的哪些原本被禁用的字段传递给客户端，默认情况下，Nginx不会把后端服务器返回的响应头中的“Date”、“Server”、“X-Pad”和“X-Accel-...”等字段返回给客户端。参考proxy_hide_header指令。

1.7 proxy_hide_header 禁止传递的响应头

Syntax:    proxy_hide_header field;
Default:    —
Context:    http, server, location

        默认情况下，nginx不会将后端服务器响应中的 “Date”、“Server”、“X-Pad”和“X-Accel-...” 等字段返回给客户端。proxy_hide_header 指令可设置不传递的其他字段。相反，如果需要允许传递字段，则可以使用 proxy_pass_header 指令。

1.8 proxy_pass_request_body 传递请求体

Syntax:    proxy_pass_request_body on | off;
Default:    proxy_pass_request_body on;
Context:    http, server, location

        设置是否将原始请求中的body传递给后端服务器。默认是on，表示传递。

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

1.9 proxy_pass_request_headers 传递请求头

Syntax:    proxy_pass_request_headers on | off;
Default:    proxy_pass_request_headers on;
Context:    http, server, location

        设置是否将原始请求中的header传递给后端服务器。默认是on，表示传递。

location /x-accel-redirect-here/ {proxy_method GET;proxy_pass_request_headers off;proxy_pass_request_body off;proxy_pass ...
}

1.10 proxy_protocol  代理协议

Syntax:    proxy_protocol on | off;
Default:    proxy_protocol off;
Context:    stream, server
This directive appeared in version 1.9.2.

        设置在与代理服务器进行通信时是否启用代理协议。

1.11 proxy_requests 接收数据包数量

Syntax:    proxy_requests number;
Default:    proxy_requests 0;
Context:    stream, server
This directive appeared in version 1.15.7.

        设置在终止客户端与现有UDP数据流绑定的会话前，允许客户端发送的数据包数量。当服务端接收的数据包数量达到该值后，将建立新的会话来接收下一个数据包。当所有客户端的数据包都传输到代理服务器并收到指定数量（proxy_responses）的响应后，或者是连接达到超时时间（proxy_timeout）后，会话将终止。设为0表示不受限制。

1.12 proxy_responses 预期响应数据包数量

Syntax:    proxy_responses number;
Default:    —
Context:    stream, server
This directive appeared in version 1.9.13.

        如果使用UDP协议，设置代理服务器给客户端返回响应时的预期数据包数量。该数字可作为会话终止的提示。默认情况下，数据包数量不受限制。如果设为零，则客户端不会收到任何响应。但是，如果收到响应但会话仍未结束，则将处理该响应。

1.13 proxy_session_drop 终止会话

Syntax:    proxy_session_drop on | off;
Default:    proxy_session_drop off;
Context:    stream, server
This directive appeared in version 1.15.8.

        当代理服务器从服务器组中删除或被标记为永久不可用后，设置是否要终止与该代理服务器建立的所有会话。可能会因为重新解析或使用 API DELETE 命令而发生这种情况。当服务器被认定为不健康，或使用 API PATCH 命令时，这台服务器将被标记成永久不可用。当客户端或代理服务器处理完下一个read或write事件后，每个会话就会终止。

2. 代理缓冲 proxy_buffer

        代理缓冲区用于临时存储从后端服务器返回的响应数据。启用代理缓冲时，Nginx是等待接收完整个响应后再将其返回给客户端，可提高服务器性能和效率。禁用代理缓冲时，响应数据是立即同步给客户端，响应速度会有所提高，适用于对实时性要求较高的场景。

2.1 proxy_buffering 是否开启缓冲

Syntax:     proxy_buffering on | off;
Default:     proxy_buffering on;
Context:    http, server, location

        设置是否缓存后端服务器返回的响应。默认开启缓存。

        启用缓存后，nginx 会尽快接收后端服务器的响应，并将其保存到由 proxy_buffer_size 和 proxy_buffers 指令设置的缓冲区中。如果整个响应无法存入内存，可以将其中一部分保存到磁盘上的临时文件中。临时文件的写入由 proxy_max_temp_file_size 和 proxy_temp_file_write_size 指令控制。

        禁用缓存后，nginx在收到响应后会立即将其同步传递给客户端，而不会尝试从后端服务器读取整个响应。nginx每次从后端服务器接收数据的最大值由proxy_buffer_size指令设定。

        还可以通过在 "X-Accel-Buffering "响应头字段中输入 "yes"或 "no"来启用或禁用缓冲。可以使用 proxy_ignore_headers 指令禁用这一功能。

2.2 proxy_buffers

Syntax:     proxy_buffers number size;
Default:     proxy_buffers 8 4k|8k;
Context:    http, server, location

        该指令用于设置Nginx从后端服务器读取单个连接响应数据的缓冲区数量和大小。默认情况下，缓冲区大小等于一个内存页。根据平台不同，缓冲区大小为 4K 或 8K。

2.3 proxy_buffer_size

Syntax:     proxy_buffer_size size;
Default:     proxy_buffer_size 4k|8k;
Context:    http, server, location

        该指令用于设置Nginx从后端服务器读取响应头数据的缓冲区大小，这个缓冲区通常存储一些较小的响应头信息。默认情况下，缓冲区大小等于一个内存页。根据平台的不同，缓冲区大小为 4K 或 8K。不过，它也可以变小。

2.4 proxy_busy_buffers_size

Syntax:     proxy_busy_buffers_size size;
Default:     proxy_busy_buffers_size 8k|16k;
Context:    http, server, location

        启用代理服务器响应缓冲后，将限制正在忙于给客户端发送响应而代理服务器响应尚未被完全读取的缓冲区总大小。在此期间，其余缓冲区可用于读取响应，并在必要时将部分响应缓冲到临时文件中。默认情况下，size 受 proxy_buffer_size 和 proxy_buffers 指令设置的两个缓冲区大小限制。

2.5 proxy_request_buffering 请求体缓冲

Syntax:    proxy_request_buffering on | off;
Default:    proxy_request_buffering on;
Context:    http, server, location
This directive appeared in version 1.7.11.

3. 代理缓存 proxy_cache

        启用代理缓存后，Nginx可以把后端服务器返回的响应数据缓存在磁盘文件中，客户端下次请求同一数据时，Nginx可以直接返回缓存数据，从而提高响应速度，减少向后端发送请求的次数，降低后端服务器的负载。

3.1 proxy_cache_path 缓存配置

Syntax:    proxy_cache_path path [levels=levels] [use_temp_path=on|off] keys_zone=name:size [inactive=time] [max_size=size] [min_free=size] [manager_files=number] [manager_sleep=time] [manager_threshold=time] [loader_files=number] [loader_sleep=time] [loader_threshold=time] [purger=on|off] [purger_files=number] [purger_sleep=time] [purger_threshold=time];
Default:    —
Context:    http

        指定缓存的存储路径、目录结构、格式、最大缓存大小和失效时间等参数。

  • path：缓存文件存储路径。缓存文件名是对 cache key 使用 MD5 算法计算后生成的结果。
/data/nginx/cache/c/29/b7f54b2df7773722d382f4809d65029c
  • [levels=levels]：levels=[level1]:[level2]:[level3]，设置缓存文件存储目录的层数和层级，层数最多是3层，层级最大是2。
# 层数是2层，第一层层级是1，第二层层级是2，如：/data/nginx/cache/7/82
proxy_cache_path /data/nginx/cache levels=1:2# 层数是2层，第一层层级是2，第二层层级是2，如：/data/nginx/cache/17/28
proxy_cache_path /data/nginx/cache levels=2:2# 层数是3层，第一层层级是1，第二层层级是1，第二层层级是2，如：/data/nginx/cache/7/4/s7
proxy_cache_path /data/nginx/cache levels=1:1:2# 层数是3层，第一层层级是2，第二层层级是1，第二层层级是2，如：/data/nginx/cache/7/43/b8
proxy_cache_path /data/nginx/cache levels=1:2:2
  • keys_zone=name:size：设置缓存文件键值对的存储共享内存区及大小。所有活动密钥和有关数据信息都存储在共享内存区中，共享内存区的名称和大小由 keys_zone 参数配置。1 MB 的区域大约可存储8000个密钥。
proxy_cache_path /data/nginx/cache levels=1:2 keys_zone=myCache:10m;
  • [use_temp_path=on|off]：设置是否将使用临时文件目录，如果开启(on)，会将临时文件存放到临时目录中。Nginx缓存代理响应数据时，会先将响应数据写入到一个临时文件，然后再重命名该文件。从 0.8.9 版开始，可以把临时文件和缓存放在不同的文件系统上。但要注意的是，在这种情况下，文件会在两个文件系统之间复制，而不是进行简单的重命名操作。因此，建议在任何给定位置都将缓存和由proxy_temp_path 指令设置的临时文件目录放在同一个文件系统中。如果省略该参数或将其值设为 on，则将使用 proxy_temp_path 指令为临时文件指定目录。如果设置为 off，临时文件将直接存放在缓存目录中，建议将 use_temp_path 设置为off，这样可避免不必要的数据拷贝。
  • [inactive=time]：设置缓存文件的失效时间，单位是秒。如果某个缓存文件在inactive指定时间内未被访问，则删除该缓存文件，默认是10分钟。
  • [max_size=size]：设置缓存空间上限值，如果不指定，表示不限制缓存大小，有可能会占用完所有磁盘空间。
  • [min_free=size]：设置缓存空间最小可用值，用于清除不常用的缓存。
  • [manager_ ***]：当缓存数据总大小超过缓存空间上限值或缓存可用空间不足时，系统会删除最近使用最少的数据。数据会在 manager_files、manager_threshold 和 manager_sleep 参数（1.11.5）配置的迭代中删除。在一次迭代中，删除的 manager_files 条目不会超过（默认为 100）。一次迭代的持续时间受 manager_threshold 参数限制（默认为 200 毫秒）。在两次迭代之间，会有一个由 manager_sleep 参数（默认为 50 毫秒）设置的暂停。启动一分钟后，特殊的 "缓存加载器 "进程被激活。它将以前存储在文件系统中的缓存数据信息加载到缓存区。加载也是迭代进行的。在一次迭代中，加载的加载器文件项不会超过 100 个（默认为 100 个）。此外，一次迭代的持续时间受 loader_threshold 参数的限制（默认为 200 毫秒）。在两次迭代之间，会有一个由 loader_sleep 参数（默认为 50 毫秒）设置的暂停。

  • [manager_files=number]：manager进程每次移除缓存文件数量的上限。
  • [manager_sleep=time]：manager进程每次移除缓存文件的时间上限。
  • [manager_threshold=time]：manager进程每次移除缓存后的间隔时间。
  • [loader_files=number]：重启Nginx载入缓存时，每次加载的个数，默认100。
  • [loader_sleep=time]：每次载入时，允许的最大时间上限，默认200ms。
  • [loader_threshold=time]：一次载入后，停顿的时间间隔，默认50ms。
proxy_cache_path /data/nginx/cache levels=1:2 keys_zone=myCache:10m max_size=1g inactive=60m use_temp_path=off;

        另外，Nginx商用版还提供以下几个参数：

  • [purger=on|off]：指示是否通过缓存清除器（1.7.12）从磁盘中删除与通配符匹配的缓存条目。将该参数设置为开（默认为关）将激活 "缓存清除器 "进程，永久遍历所有缓存条目并删除与通配符键匹配的条目。
  • [purger_files=number]：设置一次迭代（1.7.12）中扫描的项目数。默认情况下，purger_files 设置为 10。
  • [purger_threshold=number]：设置一次迭代的持续时间（1.7.12）。默认情况下，purger_threshold 设置为 50 毫秒。
  • [purger_sleep=number]：设置迭代之间的暂停时间（1.7.12）。默认情况下，purger_sleep 设置为 50 毫秒。

3.2 proxy_cache 开启缓存

Syntax:    proxy_cache zone | off;
Default:    proxy_cache off;
Context:    http, server, location

        开启代理缓存并配置用于缓存的共享内存区。同一区域可用于多个地方。off参数表示禁用缓存，且不继承上一级的配置。

proxy_cache myCache;
proxy_cache_key $host$uri$is_args$args;
proxy_cache_valid 200 304 302 1d;

3.3 proxy_cache_valid 缓存有效期

Syntax:    proxy_cache_valid [code ...] time;
Default:    —
Context:    http, server, location

        设置不同响应状态码的响应数据缓存时间。可选参数code可以配置多个，中间用空格分隔，如果不配置code，那么仅缓存200、301和302状态码的响应数据。time表示缓存的过期时间。如果需要给不同响应状态码设置不同的缓存策略，可以同时配置多个。

# 状态码为200和302的响应缓存10分钟
proxy_cache_valid 200 302 10m;
# 状态码为404的响应缓存10分钟
proxy_cache_valid 404      1m;
# 仅缓存200、301和302状态码的响应数据
proxy_cache_valid 5m;
# 所有状态码的响应都缓存1分钟
proxy_cache_valid any      1m;

        默认情况下，缓存文件会永久保存，除非缓存数据总量超过了缓存上限值或最小可用空间不足时，才会清理不常用的缓存文件。

3.4 proxy_cache_key 缓存维度/键值

Syntax:    proxy_cache_key string;
Default:    proxy_cache_key $scheme$proxy_host$request_uri;
Context:    http, server, location

        定义缓存key，也可以称为设置缓存维度，Nginx会用这个key来缓存不同的请求响应结果（缓存文件名就是根据key来生成的）。同样的，获取缓存时也是根据这个key来获取对应的缓存文件。

proxy_cache_key "$host$request_uri $cookie_user";

        默认情况下，该指令的值应接近于字符串 

proxy_cache_key $scheme$proxy_host$uri$is_args$args;

3.5 proxy_no_cache 不被缓存

Syntax:    proxy_no_cache string ...;
Default:    —
Context:    http, server, location

        设置哪些代理请求的响应不会被缓存。如果字符串参数中至少有一个值不为空且不等于 "0"，则响应数据不会被缓存，可以与proxy_cache_bypass指令一起使用。

proxy_no_cache $cookie_nocache $arg_nocache $arg_comment;
proxy_no_cache $http_pragma    $http_authorization;

3.6 proxy_cache_bypass 不读缓存

Syntax:    proxy_cache_bypass string ...;
Default:    —
Context:    http, server, location

        设置哪些代理请求不从缓存中读取数据，而是直接请求代理服务器。如果字符串参数中至少有一个值不为空且不等于 "0"，那么将不会从缓存中获取响应数据，可以与proxy_no_cache指令一起使用。

proxy_cache_bypass $cookie_nocache $arg_nocache$arg_comment;
proxy_cache_bypass $http_pragma    $http_authorization;

3.7 proxy_cache_min_uses  最少请求次数

Syntax:    proxy_cache_min_uses number;
Default:    proxy_cache_min_uses 1;
Context:    http, server, location

        设置代理请求达到指定请求次数后，才对其响应进行缓存，防止低频请求的响应数据被缓存。

3.8 proxy_cache_purge 清除指定请求的缓存

Syntax:    proxy_cache_purge string ...;
Default:    —
Context:    http, server, location
This directive appeared in version 1.5.7.

        设置哪些请求的缓存文件需要被清除。如果字符串参数中至少有一个值不为空且不等于 "0"，那么对应cache key的缓存文件将被清除。这个请求需要手动发起，Nginx无法主动发起，返回 204(无内容)响应表示操作成功。

        如果设定请求的cache key以星号("*")结尾，则所有与通配符匹配的缓存文件都将从缓存中清除。不过，这些文件仍将保留在磁盘上，直到它们因inactivity（对应proxy_cache_path指令中的inactive参数）而被删除，或被缓存清除器处理，或客户端尝试访问它们。

proxy_cache_purge    myCache   $host$1$is_args$args;

        假设一个URL为'http://192.168.8.42/test.txt'，那么通过访问'http://192.168.8.42/purge/test.txt'就可以清除该URL的缓存！ 

        该指令属于第三方模块，需要单独配置。

wget http://labs.frickle.com/files/ngx_cache_purge-2.3.tar.gztar -xf ngx_cache_purge-2.3.tar.gz  && cd nginx-1.12.2./configure --prefix=/usr/local/nginx --user=nginx --group=nginx --with-http_ssl_module\
--with-http_realip_module --with-http_addition_module --with-http_gzip_static_module\
--with-http_stub_status_module  --with-http_sub_module  --with-pcre\
--add-module=../'ngx_cache_purge-2.3' --add-module=./'nginx_upstream_check_module'

3.9 proxy_cache_methods 指定方法缓存

Syntax:    proxy_cache_methods GET | HEAD | POST ...;
Default:    proxy_cache_methods GET HEAD;
Context:    http, server, location
This directive appeared in version 0.7.59.

        指定哪些请求方法的响应数据会被缓存，如果客户端请求方法在该指令值队列中，则响应将被缓存。Nginx默认始终缓存"GET"和 "HEAD"方法的响应数据，虽然"GET "和 "HEAD "方法总会被添加到该指令值队列中，但在配置时还是建议明确指定它们。

3.10 proxy_cache_use_stale  使用旧缓存

Syntax:    proxy_cache_use_stale error | timeout | invalid_header | updating | http_500 | http_502 | http_503 | http_504 | http_403 | http_404 | http_429 | off ...;
Default:   proxy_cache_use_stale off;
Context:    http, server, location

        设置在什么情况下可以使用旧缓存，如服务端返回500或404错误信息等，或者是Nginx正在更新旧缓存，那么这时候Nginx可以选择是否要把旧缓存数据返回给客户端。可配合 proxy_next_upstream 指令一起使用。

3.11 proxy_cache_background_update 后台更新缓存

Syntax:    proxy_cache_background_update on | off;
Default:    proxy_cache_background_update off;
Context:    http, server, location
This directive appeared in version 1.11.10.

        允许启动后台子请求来更新已过期的缓存文件，由Nginx向上游主动发送请求来更新过期缓存。请注意，在更新过期缓存响应时，有必要允许使用过期缓存响应。

3.12 proxy_cache_convert_head

Syntax:    proxy_cache_convert_head on | off;
Default:    proxy_cache_convert_head on;
Context:    http, server, location
This directive appeared in version 1.9.7.

        设置是否将 "HEAD"方法转换为 "GET "方法进行缓存。禁用转换时，proxy_cache_key 指令配置内容应包含 $request_method。

3.13 proxy_cache_lock 代理缓存锁

Syntax:    proxy_cache_lock on | off;
Default:    proxy_cache_lock off;
Context:    http, server, location
This directive appeared in version 1.1.12.

        设置是否开启代理缓存锁。启用后，如果同一时间内有多个相同cache key的代理请求需要发送给代理服务器，那么此时只允许一个（按序选择最靠前的）请求发送给代理服务器，而其它请求要么是等待上一个请求的响应被返回后再读取缓存数据，要么是等待上一个请求超时后（proxy_cache_lock_age指令设置）再发送给代理服务器，要么是等代理缓存锁超时被释放后再发送给代理服务器。缓存锁超时时间由proxy_cache_lock_timeout 指定设置。

3.14 proxy_cache_lock_age 代理缓存锁有效期

Syntax:    proxy_cache_lock_age time;
Default:    proxy_cache_lock_age 5s;
Context:    http, server, location
This directive appeared in version 1.7.8.

        设置上一个请求返回响应的超时时间，超时后下一个请求才能发送给代理服务器。

3.15 proxy_cache_lock_timeout 等待缓存锁超时时间

Syntax:    proxy_cache_lock_timeout time;
Default:    proxy_cache_lock_timeout 5s;
Context:    http, server, location
This directive appeared in version 1.1.12.

        设置 proxy_cache_lock 的等待超时时间。超时后，其它请求才能发送给代理服务器，但响应数据不会被缓存。

3.16 proxy_cache_max_range_offset 

Syntax:    proxy_cache_max_range_offset number;
Default:    —
Context:    http, server, location
This directive appeared in version 1.11.6.

        设置range请求的字节偏移量，单位是字节。如果超出偏移量，range请求将被传递给代理服务器，但响应数据不会被缓存。

3.17 proxy_cache_revalidate 重验缓存

Syntax:    proxy_cache_revalidate on | off;
Default:    proxy_cache_revalidate off;
Context:    http, server, location
This directive appeared in version 1.5.7.

        设置是否开启重新验证已过期的缓存文件。当缓存文件过期后，可在请求头中增加 "If-Modified-Since "和 "If-None-Match "字段来重新验证已过期的缓存内容是否仍有效。

4. 超时时间 timeout

4.1 proxy_timeout 连接超时时间

Syntax:    proxy_timeout timeout;
Default:    proxy_timeout 10m;
Context:    stream, server

        设置客户端或代理服务器连接上两次连续read或write操作之间的超时时间。如果在这段时间内没有数据传输，连接就会关闭。 类似于keepalive_timeout。

4.2 proxy_connect_timeout 建立连接超时

Syntax:    proxy_connect_timeout time;
Default:    proxy_connect_timeout 60s;
Context:    http, server, location

        设置Nginx与代理服务器尝试建立连接的超时时间。请注意，这个指令限制的是尝试建立连接的超时时间，并不是连接建立成功后的保活时长。默认设置是60秒，但并不是说非要等60秒后才反馈连接建立失败，因为Nginx与后端代理服务器建立连接时，也是通过TCP协议建立的连接，那么就会受内核参数net.ipv4.tcp_syn_retries的影响，如果我们把syn_retries的次数配置的较小（默认配置是5次，大约相当于180秒），Nginx重传SYN报文的次数达到上限并等待完成后，有可能总耗时都不到60秒，此时照样会反馈连接建立失败。如果syn_retries配置的较大，SYN报文重传次数虽未达到上限，但总耗时已达到proxy_connect_timeout指定的时间，此时也会反馈连接建立失败，所以Nginx与代理服务器尝试建立连接的超时时间是取proxy_connect_timeout与SYN报文重传用时的最小值。

        实际使用中不建议调整该值，要调整也是调小，不要调大，最大值尽量不要超过75秒。

4.3 proxy_read_timeout 接收响应超时

Syntax:    proxy_read_timeout time;
Default:    proxy_read_timeout 60s;
Context:    http, server, location

        设置接收代理服务器响应的超时时间。这个超时并不是接收一个响应的用时时间，而是两次连续接收响应（read操作）的最大间隔时间。当接收完一个响应后，如果在proxy_read_timeout指定时间内未接收到第二次响应，Nginx将关闭该连接。

4.4 proxy_send_timeout 发送请求超时

Syntax:    proxy_send_timeout time;
Default:    proxy_send_timeout 60s;
Context:    http, server, location

        设置向代理服务器发送请求的超时时间。同样的，这个超时也不是发送一次请求的用时时间，而是两次连续发送请求（write操作）的最大间隔时间。所以当发送完第一次代理请求后，如果在proxy_send_timeout指定时间内未发送第二次请求，Nginx将关闭该连接。

5. 使用下一台上游服务器 proxy_next_upstream

        当向一台上游服务器发送代理请求出错或无响应内容时，可认定该服务器异常，此时Nginx可通过配置 proxy_next_upstream 指令来选择是否要换下一台上游服务器继续处理当前这个请求，向下一台服务器发送请求可能还要受尝试次数（proxy_next_upstream_tries）和时间（proxy_next_upstream_timeout）的限制。具体说明请参考5.4章节。

5.1 proxy_next_upstream 尝试下一台服务器

Syntax:    proxy_next_upstream error | timeout | invalid_header | http_500 | http_502 | http_503 | http_504 | http_403 | http_404 | http_429 | non_idempotent | off ...;
Default:    proxy_next_upstream error timeout;
Context:    http, server, location

        指定在哪种情况下可以将请求转发给下一台上游服务器继续进行处理。需要注意的是，只有在尚未向客户端发送任何内容的情况下，才能将请求传递给下一个服务器。也就是说，如果在传输响应的过程中出现错误或超时，则无法修复。

        该指令还定义了与服务器通信失败的判定标准。error、timeout 和 invalid_header 会始终被视为通信失败，即使指令中没有指定它们。只有在该指令中指定了 http_500、http_502、http_503、http_504 和 http_429 的情况下，它们才会被视为通信失败，而http_403 和 http_404 永远不会被视为通信失败。

  • error：在与上游服务器建立连接、发送请求或读取响应头时发生错误；
  • timeout：在与上游服务器建立连接、发送请求或读取响应头时发生超时；
  • invalid_header：上游服务器返回空响应或无效响应；
  • http_500：上游服务器返回的响应码为500；
  • http_502：上游服务器返回的响应码为502；
  • http_503：上游服务器返回的响应码为503；
  • http_504：上游服务器返回的响应码为504；
  • http_404：上游服务器返回的响应码为404；
  • http_429：上游服务器返回的响应码为429；
  • non_idempotent：通常情况下，如果请求已发送到上游服务器（1.9.13），那么使用non-idempotent方法（POST、LOCK、PATCH）的请求不会传递给下一台服务器；启用该选项后，可以明确允许重试此类请求。
  • off：禁止将请求传递给下一台上游服务器。

5.2 proxy_next_upstream_timeout 重试超时

Syntax:    proxy_next_upstream_timeout time;
Default:    proxy_next_upstream_timeout 0;
Context:    http, server, location
This directive appeared in version 1.7.5.

        限制尝试向下一台上游服务器转发请求的总耗时，默认是0，表示不受时间限制。

proxy_next_upstream_timeout 10s;

5.3 proxy_next_upstream_tries 重试次数

Syntax:    proxy_next_upstream_tries number;
Default:    proxy_next_upstream_tries 0;
Context:    http, server, location
This directive appeared in version 1.7.5.

        限制向下一台上游服务器转发请求的尝试次数，默认是0，表示不受次数限制。

        proxy_next_upstream_timeout 时间范围内最多允许尝试 proxy_next_upstream_tries 次，含第一次。

proxy_next_upstream_tries 2;

5.4 综合说明（已测试） 

proxy_next_upstream error timeout http_500;
proxy_next_upstream_timeout 10s;
proxy_next_upstream_tries 5;

        假设我们针对某一server或location配置了多台后端服务器，Nginx首次转发请求给第一台服务器后返回的响应码为500，此时Nginx把请求转发给Next Server（可用，server指令中的max_fails、fail_timeout参数设置）进行处理，并开启一个计时器，时间设定为proxy_next_upstream_timeout指令配置的值。如果Next Server返回的响应码还是500，则继续将请求转发给Next Next Server，直到满足以下任意一个条件，Nginx才会停止转发并将最终的响应结果返回给客户端：

  • 计时时间超过了proxy_next_upstream_timeout设定的时间，也就是我们上面配置的10秒；
  • 向Next Server转发的次数达到了proxy_next_upstream_tries设定的次数限制，也就是我们上面配置的5次；
  • 响应结果不满足proxy_next_upstream指定设定的条件，比如返回结果是404或301；
  • 所有可用后端服务器都被尝试请求过了，不管最后一个服务器返回的响应是什么都会停止转发。

Q：如果后端服务器只有3个，每个服务器的失败尝试次数为1 ，不可用时长是20秒，proxy_next_upstream_tries =5，会尝试请求几次？

A：如果请求第一台服务器返回500，则转发请求给第二台可用服务器，如果第二台服务器还是返回500，则再请求第三台可用服务，无论第三台服务器返回结果是什么都会终止请求，并将结果返回给客户端（具体给客户端返回什么样的响应还要看proxy_intercept_errors和error_page指令的配置结果）。此时配置的proxy_next_upstream_timeout和proxy_next_upstream_tries将失效。也就是服务器不会被循环再次请求。请注意，如果请求完第一台服务器后返回500，而后面的服务器在fail_timeout时间内都被判定为不可用，那么就不再尝试转发请求给其他服务器，retry次数为0，直接将第一台服务器的响应返回给客户端。

6. 代理服务器SSL验证 proxy_ssl

6.1 proxy_ssl_certificate 

Syntax:    proxy_ssl_certificate file;
Default:    —
Context:    http, server, location
This directive appeared in version 1.7.8.

        与ssl_certificate指令一样，指定包含 PEM 格式证书的文件，用于代理 HTTPS 服务器的身份验证。

6.2 proxy_ssl_certificate_key 

Syntax:    proxy_ssl_certificate_key file;
Default:    —
Context:    http, server, location
This directive appeared in version 1.7.8.

        与ssl_certificate_key指令一样，指定包含 PEM 格式秘钥的证书文件，用于代理 HTTPS 服务器的身份验证。

6.3 proxy_ssl_ciphers 

Syntax:    proxy_ssl_ciphers ciphers;
Default:    proxy_ssl_ciphers DEFAULT;
Context:    http, server, location
This directive appeared in version 1.5.6.

        与ssl_ciphers指令一样，指定对代理请求 HTTPS 服务器启用的密码。密码以 OpenSSL 库能理解的格式指定。具体配置可参考 Module ngx_http_ssl_module

6.4 proxy_ssl_conf_command 

Syntax:    proxy_ssl_conf_command name value;
Default:    —
Context:    http, server, location
This directive appeared in version 1.19.4.

        与ssl_conf_command指令一样，在与代理 HTTPS 服务器建立连接时设置任意 OpenSSL 配置命令。

        同一配置层中可以指定多个 proxy_ssl_conf_command 指令。只有在当前配置层没有定义 proxy_ssl_conf_command 指令时，这些指令才会继承上一级配置。

6.5 proxy_ssl_crl 

Syntax:    proxy_ssl_crl file;
Default:    —
Context:    http, server, location
This directive appeared in version 1.7.0.

        与ssl_crl指令一样，指定用于验证代理 HTTPS 服务器的 PEM 格式的已撤销证书(CRL)。

6.6 proxy_ssl_name 

Syntax:    proxy_ssl_name name;
Default:    proxy_ssl_name $proxy_host;
Context:    http, server, location
This directive appeared in version 1.7.0.

        允许重设服务器名称，该名称用于验证代理 HTTPS 服务器的证书，并在与代理 HTTPS 服务器建立连接时通过 SNI 传递。默认情况下，使用 proxy_pass URL 的Host部分。

6.7 proxy_ssl_password_file 

Syntax:    proxy_ssl_password_file file;
Default:    —
Context:    http, server, location
This directive appeared in version 1.7.8.

        与ssl_password_file指令一样，指定一个包含密钥口令的文件，每个口令单独一行。在加载密钥时，会依次尝试使用口令。

6.8 proxy_ssl_protocols 

Syntax:    proxy_ssl_protocols [SSLv2] [SSLv3] [TLSv1] [TLSv1.1] [TLSv1.2] [TLSv1.3];
Default:    proxy_ssl_protocols TLSv1 TLSv1.1 TLSv1.2 TLSv1.3;
Context:    http, server, location
This directive appeared in version 1.5.6.

        与ssl_protocols指令一样，为向代理 HTTPS 服务器发出的请求启用指定协议。

6.9 proxy_ssl_server_name 

Syntax:    proxy_ssl_server_name on | off;
Default:    proxy_ssl_server_name off;
Context:    http, server, location
This directive appeared in version 1.7.0.

        与代理 HTTPS 服务器建立连接时，启用或禁用通过 TLS 服务器名称指示扩展（SNI，RFC 6066）传递服务器名称。

6.10 proxy_ssl_session_reuse 

Syntax:    proxy_ssl_session_reuse on | off;
Default:    proxy_ssl_session_reuse on;
Context:    http, server, location

        确定在使用代理服务器时是否可以重复使用 SSL 会话。如果日志中出现 "SSL3_GET_FINISHED:digest check failed"（SSL3_GET_FINISHED:摘要检查失败）错误，请尝试禁用会话重用。

6.11 proxy_ssl_trusted_certificate 

Syntax:    proxy_ssl_trusted_certificate file;
Default:    —
Context:    http, server, location
This directive appeared in version 1.7.0.

        与ssl_trusted_certificate指令一样，指定用于验证代理 HTTPS 服务器证书的 PEM 格式可信 CA 证书的文件。

6.12 proxy_ssl_verify 

Syntax:    proxy_ssl_verify on | off;
Default:    proxy_ssl_verify off;
Context:    http, server, location
This directive appeared in version 1.7.0.

        启用或禁用代理 HTTPS 服务器证书验证。

6.13 proxy_ssl_verify_depth 

Syntax:    proxy_ssl_verify_depth number;
Default:    proxy_ssl_verify_depth 1;
Context:    http, server, location
This directive appeared in version 1.7.0.

        与ssl_verify_depth指令一样，设置代理 HTTPS 服务器证书链的验证深度。

7. proxy_socket_keepalive TCP保活

Syntax:    proxy_socket_keepalive on | off;
Default:    proxy_socket_keepalive off;
Context:    http, server, location
This directive appeared in version 1.15.6.

        设置是否开启与代理服务器间的TCP保活机制，类似于listen指令中的so_keepalive参数。如果设置为on，表示开启，socket将打开SO_KEEPALIVE选项，参数使用系统内核参数。

8. proxy_method 代理请求方法

Syntax:    proxy_method method;
Default:    —
Context:    http, server, location

        指定转发到代理服务器的请求要使用的HTTP方法（GET/POST/DELETE/UPDATE），而不使用客户端请求中的方法。如果不指定，代理请求方法与客户端的请求方法保持一致。

9. proxy_bind 绑定地址

Syntax:     proxy_bind address [transparent] | off;
Default:     —
Context:    http, server, location
This directive appeared in version 0.8.22.

        该指令用于指定Nginx在向后端服务器发送请求时应绑定的本机IP地址，端口号可选。参数值可包含变量。配置为off时，表示不继承上级配置的 proxy_bind，此时，系统将自动分配本地 IP 地址和端口。transparent 是可选参数，表示使用透明代理模式，允许使用非本机IP向代后端服务器发送请求。

proxy_bind $remote_addr transparent;

10. proxy_ignore_headers 忽略响应头

Syntax:    proxy_ignore_headers field ...;
Default:    —
Context:    http, server, location

        后端服务器返回的响应中某些响应头字段可能会影响Nginx的行为，可通过该指令来设置Nginx可忽略处理响应头中的哪些字段。可忽略以下字段： "X-Accel-Redirect"、"X-Accel-Expires"、"X-Accel-Limit-Rate" (1.1.6)、"X-Accel-Buffering" (1.1.6)、"X-Accel-Charset" (1.1.6)、"Expires"、"Cache-Control"、"Set-Cookie" (0.8.44) 和 "Vary" (1.7.7)。

  • "X-Accel-Expires"、"Expires"、"Cache-Control"、"Set-Cookie "和 "Vary "设置了响应缓存的参数；
  • "X-Accel-Redirect"：执行内部重定向到指定 URI；
  • "X-Accel-Limit-Rate "：设置向客户端传输响应的速率限制；
  • "X-Accel-Buffering"：启用或禁用响应缓冲；
  • "X-Accel-Charset"：设置所需的响应字符集。

11. proxy_ignore_client_abort 是否关闭连接

Syntax:    proxy_ignore_client_abort on | off;
Default:    proxy_ignore_client_abort off;
Context:    http, server, location

        设置当客户端关闭连接而不再等待响应时，是否应关闭与代理服务器的连接。

12. limit_rate 限速

12.1 proxy_limit_rate 限制读取服务端速率

Syntax:    proxy_limit_rate rate;
Default:    proxy_limit_rate 0;
Context:    http, server, location
This directive appeared in version 1.7.7.

        限制从代理服务器读取响应的速率。速率以每秒字节数为单位。设为0时将禁用速率限制。该指令限制的是单个连接的速率，如果 nginx 同时打开两个连接到代理服务器，总速率将是限定速率的两倍。只有启用了代理服务器响应缓冲后，该限制才会生效。

12.2 proxy_download_rate 限制读取服务端速率

Syntax:    proxy_download_rate rate;
Default:    proxy_download_rate 0;
Context:    stream, server
This directive appeared in version 1.9.3.

        限制从代理服务器读取响应的速率。速率以每秒字节数为单位。设为0时将禁用速率限制。该指令限制的是单个连接的速率，如果 nginx 同时打开两个连接到代理服务器，总速率将是限定速率的两倍。

        参数值可包含变量（1.17.0）。可根据不同条件做出不同限速：

map $slow $rate {1     4k;2     8k;
}
proxy_download_rate $rate;

12.3 proxy_upload_rate 限制读取客户端速率

Syntax:    proxy_upload_rate rate;
Default:    proxy_upload_rate 0;
Context:    stream, server
This directive appeared in version 1.9.3.

        限制从客户端读取数据的速率。速率以每秒字节数为单位。设为0时将禁用速率限制。该指令限制的是单个连接的速率，如果客户端同时打开两个连接到 nginx ，总速率将是限定速率的两倍。

        参数值可包含变量（1.17.0）。可根据不同条件做出不同限速：

map $slow $rate {1     4k;2     8k;
}
proxy_upload_rate $rate;

13. proxy_cookie 

13.1 proxy_cookie_domain  

Syntax:    proxy_cookie_domain off;
                proxy_cookie_domain domain replacement;
Default:    proxy_cookie_domain off;
Context:    http, server, location
This directive appeared in version 1.1.15.

        为代理响应头字段"Set-Cookie"的domain属性设置应替换的文本，匹配不区分大小写。假设代理服务器返回的响应头"Set-Cookie "字段的domain属性为"domain=localhost"，可以将该指令配置为

# 把localhost更改为实际域名返回给客户端
proxy_cookie_domain localhost example.org;

domain属性将被重写为“domain=example.org” 。

        如果domain和replacement字符串以点"."开头，那么domain属性将被忽略。

# domain和replacement参数可包括变量。
proxy_cookie_domain www.$host $host;

        该指令也可以使用正则表达式指定。此时domain应以“~”符号开头。正则表达式可以包含命名捕获和位置捕获，replacement可以引用它们： 

proxy_cookie_domain ~\.(?P<sl_domain>[-0-9a-z]+\.[a-z]+)$ $sl_domain;

# 同一配置层可同时配置多个proxy_cookie_domain指令，如果一个 cookie 匹配到多个该指令，则选择第一个匹配到的。
proxy_cookie_domain localhost example.org;
proxy_cookie_domain ~\.([a-z]+\.[a-z]+)$ $1;

         参数off表示禁用proxy_cookie_domain功能，且当前配置层级所有proxy_cookie_domain配置也会失效。

proxy_cookie_domain off;
proxy_cookie_domain localhost example.org;
proxy_cookie_domain www.example.org example.org;

13.2 proxy_cookie_flags 

Syntax:    proxy_cookie_flags off | cookie [flag ...];
Default:    proxy_cookie_flags off;
Context:    http, server, location
This directive appeared in version 1.19.3.

        为 cookie 设置一个或多个flags。cookie 可以包含文本、变量及其组合。flag 可包含文本、变量及其组合（1.19.8）。secure、httponly、samesite=strict、samesite=lax、samesite=none 参数会添加相应的标志。nosecure、nohttponly、nosamesite 参数会删除相应标记。

        也可以使用正则表达式指定 cookie，在这种情况下，cookie 应以"~"符号开头。

# 同一配置层可同时配置多个proxy_cookie_flags指令，如果一个cookie匹配到多个该指令，则选择第一个匹配到的。
# 表示将 httponly 标志添加到 cookie “one”中
proxy_cookie_flags one httponly;
# 而对于所有其他 cookie，则会添加 samesite=strict 标记，并删除 secure 标记。
proxy_cookie_flags ~ nosecure samesite=strict;

        参数off表示禁止向cookie中添加flag，且不会继承上一层级的配置。 

13.3 proxy_cookie_path 

Syntax:    proxy_cookie_path off;
                proxy_cookie_path path replacement;
Default:    proxy_cookie_path off;
Context:    http, server, location
This directive appeared in version 1.1.15.

        为代理响应头字段"Set-Cookie"的path属性设置应替换的文本。假设代理服务器返回的响应头"Set-Cookie "字段的path属性为"path=/two/some/uri/"，可以将该指令配置为

proxy_cookie_path /two/ /;

path属性将被重写为“path=/some/uri/” 。

# path和 replacement 参数可包含变量
proxy_cookie_path $uri /some$uri;

        该指令也可以使用正则表达式指定。此时path应以"~"符号开头（区分大小写），或以"~*"符号开头（不区分大小写）。正则表达式可以包含命名捕获和位置捕获，replacement可以引用它们：

proxy_cookie_path ~*^/user/([^/]+) /u/$1;

# 同一配置层可同时配置多个proxy_cookie_path指令，如果一个cookie匹配到多个该指令，则选择第一个匹配到的。
proxy_cookie_path /one/ /;
proxy_cookie_path / /two/;

        参数off表示禁用proxy_cookie_path功能，且当前配置层级所有proxy_cookie_path配置也会失效。

proxy_cookie_path off;
proxy_cookie_path /two/ /;
proxy_cookie_path ~*^/user/([^/]+) /u/$1;

14. proxy_force_ranges 强制range请求

Syntax:    proxy_force_ranges on | off;
Default:    proxy_force_ranges off;
Context:    http, server, location
This directive appeared in version 1.7.7.

        无论代理响应头中的"Accept-Ranges "字段值是什么，Nginx都可选择是否开启byte-range功能来缓存或不缓存响应数据，默认是不开启。

15. proxy_headers_hash_bucket_size  

Syntax:    proxy_headers_hash_bucket_size size;
Default:    proxy_headers_hash_bucket_size 64;
Context:    http, server, location

        为 proxy_hide_header 和 proxy_set_header 指令使用的哈希表设置存储桶的大小。

16. proxy_headers_hash_max_size 

Syntax:    proxy_headers_hash_max_size size;
Default:    proxy_headers_hash_max_size 512;
Context:    http, server, location

        为 proxy_hide_header 和 proxy_set_header 指令使用的哈希表设置存储桶的最大值。

17. proxy_intercept_errors 拦截error

Syntax:    proxy_intercept_errors on | off;
Default:    proxy_intercept_errors off;
Context:    http, server, location

        设置是否拦截代理服务器返回的响应码大于300的响应，如果开启拦截则重定向到由Nginx配置的error_page页面，如果不拦截则直接返回原始响应给客户端。默认是不拦截，给客户端返回原始响应。

18. proxy_send_lowat 

Syntax:    proxy_send_lowat size;
Default:    proxy_send_lowat 0;
Context:    http, server, location

        如果将该指令设置为非零，nginx将尝试使用kqueue方法的NOTE_LOWAT标志，或指定大小的SO_SNDLOWAT套接字选项，尽量减少代理服务器的外发连接的发送操作次数。

        Linux，Solaris 和 Windows 系统会忽略该指令。

19. proxy_store 持久保存文件

Syntax:    proxy_store on | off | string;
Default:    proxy_store off;
Context:    http, server, location

        设置是否将文件保存到磁盘。如果设置为on，文件将保存到 alias 或 root 指令指定的路径下。另外，还可以使用带有变量的字符串明确设置文件名：

proxy_store /data/www$original_uri;

        文件的修改时间是根据接收到的 "Last-Modified "响应头字段设置的。首先将响应写入到临时文件，然后再重命名该文件。从 0.8.9 版开始，可以把临时文件和持久保存文件存放在不同的文件系统上。但要注意的是，在这种情况下，文件会在两个文件系统之间复制，而不是进行简单的重命名操作。因此，建议在任何给定位置，都将持久保存文件和由 proxy_temp_path 指令设置的临时文件目录放在同一个文件系统中。

        该指令可用于创建静态不可更改文件的本地副本

location /images/ {root               /data/www;error_page         404 = /fetch$uri;
}location /fetch/ {internal;proxy_pass         http://backend/;proxy_store        on;proxy_store_access user:rw group:rw all:r;proxy_temp_path    /data/temp;alias              /data/www/;
}

        或者类似这样

location /images/ {root               /data/www;error_page         404 = @fetch;
}location @fetch {internal;proxy_pass         http://backend;proxy_store        on;proxy_store_access user:rw group:rw all:r;proxy_temp_path    /data/temp;root               /data/www;
}

20. proxy_store_access 文件访问权限

Syntax:    proxy_store_access users:permissions ...;
Default:    proxy_store_access user:rw;
Context:    http, server, location

        为新创建的文件和目录设置访问权限，如：

proxy_store_access user:rw group:rw all:r;

        如果指定了任何组或所有访问权限，则可以省略用户权限：

proxy_store_access group:rw all:r;

21. proxy_temp_file_write_size 单次最多写入

Syntax:    proxy_temp_file_write_size size;
Default:    proxy_temp_file_write_size 8k|16k;
Context:    http, server, location

        当启用将代理服务器响应数据写入临时文件（use_temp_path=on）时，该指令用于限制每次写入临时文件的数据大小。默认情况下，大小受 proxy_buffer_size 和 proxy_buffers 指令设置的两个缓冲区限制。临时文件的最大大小由 proxy_max_temp_file_size 指令设置。

22. proxy_max_temp_file_size 临时文件最大值

Syntax:    proxy_max_temp_file_size size;
Default:    proxy_max_temp_file_size 1024m;
Context:    http, server, location

        限制临时文件的最大值，默认是1024M。

23. proxy_temp_path 临时文件目录

Syntax:    proxy_temp_path path [level1 [level2 [level3]]];
Default:    proxy_temp_path proxy_temp;
Context:    http, server, location

        设置临时文件的存放目录，默认是Nginx安装目录下的proxy_temp目录。最多可指定三层子目录，类似于proxy_cache_path指令中的levels参数。

24.可用参数

  • $proxy_host：代理服务器的名称和端口，如 proxy_pass 指令所指定；
  • $proxy_port：proxy_pass 指令中指定的代理服务器端口，或协议默认端口；
  • $proxy_add_x_forwarded_for：客户端请求头中的 "X-Forwarded-For "字段，并附加 $remote_addr 变量，以逗号分隔。如果客户端请求头中没有 "X-Forwarded-For "字段，则 $proxy_add_x_forwarded_for 变量等于 $remote_addr 变量。

相关文章：

Nginx(十三) 配置文件详解 - 反向代理（超详细）

本篇文章主要讲ngx_http_proxy_module和ngx_stream_proxy_module模块下各指令的使用方法。 1. 代理请求 proxy_pass 1.1 proxy_pass 代理请求 Syntax: proxy_pass URL; Default: — Context: location, if in location, limit_except 设置代理服务器的协议和地址以…...

编程日记 2024/1/6 1:49:27

谷歌浏览器启用实时字幕功能

在 Chrome 中使用“实时字幕”功能 - Google Chrome帮助 在 Chrome 中使用“实时字幕”功能 从计算机上的 Chrome 浏览器中&#xff0c;您可以使用“实时字幕”功能自动为视频、播客、游戏、直播、视频通话或其他音频媒体生成字幕。音频和字幕均在本地处理&#xff0c;并会保…...

编程日记 2024/1/6 1:48:26

php接口优化 使用curl_multi_init批量请求

PHP使用CURL同时抓取多个URL地址 抓取多个URL地址是Web开发中常见的需求&#xff0c;使用PHP的curl库可以简化这个过程。本文将详细介绍如何使用PHP的curl库同时请求多个URL地址&#xff0c;并提供具体的代码案例和注释。 curl库介绍 curl是一个常用的开源网络传输工具&…...

编程日记 2024/1/6 1:47:25

联邦拜占庭共识算法的工作流程

1 前言 联邦拜占庭共识算法&#xff08;Federated Byzantine Agreement&#xff0c;简称FBA&#xff09;是一种解决分布式系统中拜占庭问题的共识算法&#xff0c;是拜占庭容错共识算法里的其中一种&#xff0c;主要应用于区块链技术中。这种算法允许系统内部的各种节点自由进…...

编程日记 2024/1/6 1:44:22

国家开放大学形成性考核 统一考试 学习资料参考

试卷代号&#xff1a;11119 机械CAD/CAM 参考试题 一、单项选择题&#xff08;从所给的四个选项中&#xff0c;找出你认为是正确的答案&#xff0c;将其编号填入括号内。每小题3分&#xff0c;共45分&#xff09; 1.下述CAD/CAM过程的概念中&#xff0c;属于CAM范畴的是&am…...

编程日记 2024/1/6 1:42:21

2401C++,实现文件服务器和聊天室

文件服务器 使用yalantinglibs,几行代码开发静态文件服务器 最近的workshop上的一个任务,就是实现一个文件服务器,只要设置下载目录之后,就可下载目录里面的文件. 看看用yalantinglibs怎么实现一个静态文件服务器的吧. coro_http::coro_http_server server(1, 9001); server.…...

编程日记 2024/1/6 1:40:19

【ESP-NOW 入门（ESP32 with Arduino IDE）】

ESP-NOW 入门（ESP32 with Arduino IDE） 1. 前言2. Arduino集成开发环境3. ESP-NOW 简介3.1 ESP-NOW 支持以下功能：3.2 ESP-NOW 技术还存在以下局限性：4. ESP-NOW 单向通信4.1 一个 ESP32 开发板向另一个 ESP32 开发板发送数据4.2 一个“主”ESP32 向多个 ESP32“slave”发送…...

编程日记 2024/1/6 1:39:18

PHP序列化总结2--常见的魔术方法

魔术方法的概念 PHP的魔术方法是一种特殊的方法&#xff0c;用于覆盖PHP的默认操作。它们以双下划线&#xff08;__&#xff09;开头&#xff0c;后面跟着一些特定的字符串&#xff0c;如__construct()、__destruct()、__get()等。这些魔术方法在对象执行特定操作时被自动调用…...

编程日记 2024/1/6 1:38:17

Docker 入门 ------容器互通以及Dockerfile

1. 端口映射以及容器互联 Docker 除了通过网络访问&#xff0c;还提供了两种很方便的功能来满足服务访问的基本需求&#xff1a; 允许映射容器内应用的服务端口到本地宿主主机互联机制实现多个容器间通过容器名来快速访问 1.1 容器映射实现访问容器 1.1.1 从外部访问容器应…...

编程日记 2024/1/6 1:33:11

AI绘图模型不会写字的难题解决了

介绍 大家好&#xff0c;最近有个开源项目比较有意思&#xff0c;解决了图像中不支持带有中文的问题。 https://github.com/tyxsspa/AnyText。 为什么不能带有中文&#xff1f; 数据集局限 Stable Diffusion的训练数据集以英文数据为主&#xff0c;没有大量包含其他语言文本的…...

编程日记 2024/1/6 1:32:10

vue-cli创建项目时由esLint校验导致报错或警告的问题及解决

vue-cli创建项目时由esLint校验导致报错或警告的问题及解决 一、万能办法 一、万能办法 //就是在报错的JS文件中第一行写上 /* eslint-disable */链接: https://www.yii666.com/blog/288808.html 其它的方法我遇见了再补充...

编程日记 2024/1/6 1:28:05

uniapp：实现手机端APP登录强制更新，从本地服务器下载新的apk更新,并使用WebSocket，实时强制在线用户更新

实现登录即更新&#xff0c;或实时监听更新 本文介绍的是在App打开启动的时候调用更新&#xff0c;点击下方链接&#xff0c;查看使用WebSocket实现实时通知在线用户更新。 uniapp&#xff1a;全局消息是推送&#xff0c;实现app在线更新&#xff0c;WebSocket&#xff0c;ap…...

编程日记 2024/1/6 1:25:02

设计循环队列——oj题622

. 个人主页&#xff1a;晓风飞 专栏&#xff1a;LeetCode刷题|数据结构|Linux 路漫漫其修远兮&#xff0c;吾将上下而求索 文章目录 题目要求&#xff1a;应该支持如下操作&#xff1a;示例&#xff1a;提示&#xff1a; 结构体定义队列的创建基本操作判断队列是否为空&#xf…...

编程日记 2024/1/6 1:15:56

阿里后端实习一面面经

阿里后端实习一面面经 项目中使用到了es&#xff0c;es的作用&#xff1f; elasticsearch是一款非常强大的开源搜索引擎&#xff0c;具备非常多强大功能&#xff0c;可以帮助我们从海量数据中快速找到需要的内容 es中的重要概念&#xff1f; 群集&#xff1a;一个或多个节点…...

编程日记 2024/1/6 1:13:54

element-ui组件DatePicker日期选择器移动端兼容

element-ui组件DatePicker日期选择器移动端兼容 css /** 移动端展示 **/ media screen and (max-width: 500px) {.el-picker-panel__sidebar {width: 100%;}.el-picker-panel {width: 400px!important;}.el-picker-panel__content {width: 100%;}.el-picker-panel__body{marg…...

编程日记 2024/1/6 1:09:50

burpsuite 爆破

靶场搭建：phpstudy的安装与靶场搭建 - junlin623 - 博客园 (cnblogs.com) 账号字典：XXTK: 一些弱口令、fuzz字典 (gitee.com) 网盘链接：https://pan.baidu.com/s/1v5pAwaTwoeCnJgkUXf3iLQ?pwd=mllm 提取码：mllm --来自百度网盘超级会员V2的分享 一、暴力破解 - 基于…...

编程日记 2024/1/6 1:06:47

SparkSQL基础解析（三）

1、 Spark SQL概述 1.1什么是Spark SQL Spark SQL是Spark用来处理结构化数据的一个模块&#xff0c;它提供了2个编程抽象&#xff1a;DataFrame和 DataSet&#xff0c;并且作为分布式SQL查询引擎的作用。 我们已经学习了Hive&#xff0c;它是将Hive SQL转换成MapReduce然后提…...

编程日记 2024/1/6 1:00:42

gz-hamonic 安装提示缺少许多依赖无法安装

在软件更新源中增加gz-hamonic的软件源&#xff0c; 点击添加&#xff0c;在输入框中填入如下语句&#xff1a; deb http://packages.osrfoundation.org/ubuntu jammy main 如图所示&#xff1a; 然后执行 sudo apt -get install gz-hamonic即可安装。 如下图 在终端中输入…...

编程日记 2024/1/6 0:58:40

新版Edge卸载

新版Edge卸载&#xff1a;步骤与注意事项 随着Windows 10的发布&#xff0c;微软推出了新版Edge浏览器。虽然新版Edge浏览器具有许多优秀的新功能和改进&#xff0c;但有时您可能希望卸载它并使用其他浏览器。在本文中&#xff0c;我们将向您介绍如何卸载新版Edge浏览器&#…...

编程日记 2024/1/6 0:52:35

Ansibe自动化基础

目录 一.Ansibe自动化概述 1.特点 2.工作特性 3.应用场合 二.ansibe安装即相关文件说明 1.安装 2.相关文件 3.主配置文件内容详解 4.ansibe运行机制 三.ansibe管理节点命令 1.Ansibe 四.主机组配置 1.基本配置 第一种&#xff1a; 第二种&#xff1a; 2.设置SSH…...

编程日记 2024/1/6 0:50:33

OpenLayers 可视化之热力图

注&#xff1a;当前使用的是 ol 5.3.0 版本&#xff0c;天地图使用的key请到天地图官网申请&#xff0c;并替换为自己的key 热力图&#xff08;Heatmap&#xff09;又叫热点图&#xff0c;是一种通过特殊高亮显示事物密度分布、变化趋势的数据可视化技术。采用颜色的深浅来显示…...

编程新知 2025/6/18 7:54:42

深入剖析AI大模型：大模型时代的 Prompt 工程全解析

今天聊的内容&#xff0c;我认为是AI开发里面非常重要的内容。它在AI开发里无处不在&#xff0c;当你对 AI 助手说 "用李白的风格写一首关于人工智能的诗"&#xff0c;或者让翻译模型 "将这段合同翻译成商务日语" 时&#xff0c;输入的这句话就是 Prompt。…...

编程新知 2025/7/1 6:09:18

React Native 导航系统实战（React Navigation）

导航系统实战&#xff08;React Navigation&#xff09; React Navigation 是 React Native 应用中最常用的导航库之一&#xff0c;它提供了多种导航模式&#xff0c;如堆栈导航&#xff08;Stack Navigator&#xff09;、标签导航&#xff08;Tab Navigator&#xff09;和抽屉…...

编程新知 2025/6/21 7:48:44

在rocky linux 9.5上在线安装 docker

前面是指南&#xff0c;后面是日志 sudo dnf config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo sudo dnf install docker-ce docker-ce-cli containerd.io -y docker version sudo systemctl start docker sudo systemctl status docker …...

编程新知 2025/6/17 6:27:36

Opencv中的addweighted函数

一.addweighted函数作用 addweighted&#xff08;&#xff09;是OpenCV库中用于图像处理的函数&#xff0c;主要功能是将两个输入图像&#xff08;尺寸和类型相同&#xff09;按照指定的权重进行加权叠加&#xff08;图像融合&#xff09;&#xff0c;并添加一个标量值&#x…...

编程新知 2025/7/4 11:10:06

全球首个30米分辨率湿地数据集(2000—2022)

数据简介 今天我们分享的数据是全球30米分辨率湿地数据集&#xff0c;包含8种湿地亚类&#xff0c;该数据以0.5X0.5的瓦片存储&#xff0c;我们整理了所有属于中国的瓦片名称与其对应省份&#xff0c;方便大家研究使用。 该数据集作为全球首个30米分辨率、覆盖2000–2022年时间…...

编程新知 2025/7/4 14:06:52

Qwen3-Embedding-0.6B深度解析：多语言语义检索的轻量级利器

第一章 引言&#xff1a;语义表示的新时代挑战与Qwen3的破局之路 1.1 文本嵌入的核心价值与技术演进 在人工智能领域&#xff0c;文本嵌入技术如同连接自然语言与机器理解的“神经突触”——它将人类语言转化为计算机可计算的语义向量&#xff0c;支撑着搜索引擎、推荐系统、…...

编程新知 2025/6/15 15:47:35

【OSG学习笔记】Day 16: 骨骼动画与蒙皮（osgAnimation）

骨骼动画基础 骨骼动画是 3D 计算机图形中常用的技术&#xff0c;它通过以下两个主要组件实现角色动画。 骨骼系统 (Skeleton)&#xff1a;由层级结构的骨头组成&#xff0c;类似于人体骨骼蒙皮 (Mesh Skinning)&#xff1a;将模型网格顶点绑定到骨骼上&#xff0c;使骨骼移动…...

编程新知 2025/7/4 19:12:45

Maven 概述、安装、配置、仓库、私服详解

目录 1、Maven 概述 1.1 Maven 的定义 1.2 Maven 解决的问题 1.3 Maven 的核心特性与优势 2、Maven 安装 2.1 下载 Maven 2.2 安装配置 Maven 2.3 测试安装 2.4 修改 Maven 本地仓库的默认路径 3、Maven 配置 3.1 配置本地仓库 3.2 配置 JDK 3.3 IDEA 配置本地 Ma…...

编程新知 2025/7/5 14:04:11

基于Java+MySQL实现（GUI）客户管理系统

客户资料管理系统的设计与实现 第一章 需求分析 1.1 需求总体介绍 本项目为了方便维护客户信息为了方便维护客户信息&#xff0c;对客户进行统一管理&#xff0c;可以把所有客户信息录入系统&#xff0c;进行维护和统计功能。可通过文件的方式保存相关录入数据&#xff0c;对…...

编程新知 2025/7/4 10:38:01