[系统运维]硬核！全网最全Nginx配置指令，建议收藏~

1、前言

1.1、Nginx配置文件各个主配置块说明

1.2、Nginx配置符号参考

示例：“13k”、“9m”

示例：“1h20m"代表"1小时30分”，“2y7M"代表"2年零7个月”

1.3、本文出现的一些词汇介绍

2、正文

2.1、位于全局块的配置指令

daemon

• 语法： daemon on|off;
• 默认： daemon on;
• 上下文： 全局块
• 说明： 是否以守护进程方式启动Nginx。

master_process

• 语法： master_process on|off;
• 默认： master_process on;
• 上下文： 全局块
• 说明： 是否启动worker进程。

timer_resolution

• 语法： timer_resolution time;
• 默认： —
• 上下文： 全局块
• 说明： 通过减少工作进程中计时器的分辨率，从而减少 gettimeofday() 系统调用的次数。默认情况下，每次接收到内核事件时都会调用 gettimeofday()。

  # 表示gettimeofday()调用间隔为1秒
  timer_resolution 100ms;
  
  # 表示gettimeofday()调用间隔为1秒
  timer_resolution 1;
  

pid

• 语法： pid file;
• 参数说明：
  • file – 可以是相对路径或绝对路径，相对路径最终形式为 ${prefix}/file，绝对路径最终形式为 file
• 默认： pid ${prefix}/logs/nginx.pid;
• 上下文： 全局块
• 说明： 设置保存主进程PID的文件路径。

  pid logs/nginx.pid;
  

lock_file

• 语法： lock_file file;
• 参数说明：
  • file – 可以是相对路径或绝对路径，相对路径最终形式为 ${prefix}/file，绝对路径最终形式为 file
• 默认： lock_file ${prefix}/logs/nginx.lock;
• 上下文： 全局块
• 说明： Nginx使用锁机制来实现accept_mutex和序列化访问共享内存。在大多数系统中，锁是使用原子操作实现的，所以这个指令会被忽略。而在那些使用“锁文件”机制的系统上，这个指令为锁文件的名称指定了一个前缀。

  lock_file logs/nginx.lock;
  

worker_processes

• 语法： worker_processes number|auto;
• 参数说明：
  • auto – 表示worker进程数等于当前的CPU个数
• 默认： worker_processes 1;
• 上下文： 全局块
• 说明： 设置worker进程的个数。

debug_points

• 语法： debug_points stop|abort;
• 参数说明：
  • stop – 当进程出现异常时停止当前进程
  • abort – 当进程出现异常时产生一个coredump文件
• 默认： —
• 上下文： 全局块
• 说明： 该配置指令用于调试。

user

• 语法： user user [group];
• 参数说明：
  • group – 如果没有显式配置，将 user 的值赋给 group
• 默认： user nobody nobody;
• 上下文： 全局块
• 说明： 设置worker进程所属的用户及组。

  user nobody;
  # 等同于
  user nobody nobody;
  

worker_priority

• 语法： worker_priority [-]number;
• 默认： worker_priority 1;
• 上下文： 全局块
• 说明： 设置worker进程的优先级(参考nice命令)。

  worker_priority 20;
  worker_priority -20;
  

worker_cpu_affinity

• 语法： worker_cpu_affinity cpumask [cpumask…];
  ????worker_cpu_affinity auto [cpumask…];
• 默认： —
• 上下文： 全局块
• 说明： 将worker进程与特定的cpu进行绑定。

  # 用掩码来表示CPU，这里表示CPU0绑定到第一个worker进程，CPU1绑定到第二个worker进程，CPU3绑定到第三个worker进程，CPU4绑定到第四个worker进程
  worker_proceses     4;
  worker_cpu_affinity 0001 0010 0100 1000;
  
  # 这里表示CPU0和CPU2绑定到第一个worker进程，CPU1和CPU3绑定到第二个worker进程
  worker_proceses     2;
  worker_cpu_affinity 0101 1010;
  
  # 也可以使用自动绑定
  worker_proceses     atuo;
  worker_cpu_affinity atuo;
  
  # 指定被拿去自动绑定的CPU
  worker_proceses     atuo;
  worker_cpu_affinity atuo 01010101;
  

worker_rlimit_nofile

• 语法： worker_rlimit_nofile number;
• 默认： —
• 上下文： 全局块
• 说明： 设置worker进程打开的最大文件描述述个数。

  worker_rlimit_nofile 2048;
  

worker_rlimit_core

• 语法： worker_rlimit_core size;
• 默认： —
• 上下文： 全局块
• 说明： 设置worker进程生成的coredump文件的最大大小。

  worker_rlimit_core 512000;
  worker_rlimit_core 1000K;
  

worker_shutdown_timeout

• 语法： worker_shutdown_timeout time;
• 默认： —
• 上下文： 全局块
• 说明： 配置工作进程正常关闭的超时时间。当时间到期时，Nginx将尝试关闭所有当前打开的连接。

working_directory

• 语法： working_directory path;
• 默认： working_directory ${prefix};
• 上下文： 全局块
• 说明： 设置worker进程的工作目录。

  working_directory /usr/local/nginx;
  

env

• 语法： env variable[=value];
• 默认： env TZ;
• 上下文： 全局块
• 说明： 默认情况下，Nginx会删除除了TZ变量之外从其父进程继承的所有环境变量。该指令允许保留一些继承的变量，改变它们的值或创建新的环境变量。

  env MALLOC_OPTIONS;
  env PERL5LIB=/data/site/modules;
  env OPENSSL_ALLOW_PROXY_CERTS=1;
  

ssl_engine

• 语法： ssl_engine engine;
• 默认： —
• 上下文： 全局块
• 说明： 允许指定要使用的OpenSSL引擎，这需要环境支持更新版本的OpenSSL。

  # 可以使用以下命令查看当前环境支持的OpenSSL引擎
  openssl engine -time
  

google_perftools_profiles

• 语法： google_perftools_profiles path;
• 默认： —
• 上下文： 全局块
• 说明： 该指令指定了Google Perftools分析器收集的概要文件的基本文件名，并且worker进程pid将被附加到指定的基本文件名。要使用此指令需在构建Nginx时加上配置选项： –with-google_perftools_module。

  google_perftools_profiles /tmp/tcmalloc/;
  

pcre_jit

• 语法： pcre_jit on|off;
• 默认： pcre_jit off;
• 上下文： 全局块
• 说明： 使用pcre_jit优化正则表达式。要使用此指令需在构建Nginx时加上配置选项： –with-pcre-jit。

thread_pool

• 语法： thread_pool name threads=number [max_queue=number];
• 参数说明：
  • name – 线程池名称
  • threads – 线程池中的最大线程数
  • max_queue – 允许在队列中等待的任务数
• 默认： thread_pool default threads=32 max_queue=65536;
• 上下文： 全局块
• 说明： 定义线程池的名称和参数，用于多线程读取和发送文件，而不阻塞工作进程。如果池中的所有线程都忙，则新任务将在队列中等待。默认情况下，队列中最多可以等待65536个任务，当队列溢出时，任务完成并出错。

events

• 语法： events {…}
• 上下文： 全局块
• 说明： 设置一个事件模块。

  events {
  	...
  }
  

http

• 语法： http {…}
• 上下文： 全局块
• 说明： 设置一个HTTP模块。

  http {
  	...
  }
  

mail

• 语法： mail {…}
• 上下文： 全局块
• 说明： 设置一个MAIL模块。要使用此指令需在构建Nginx时加上配置选项： –with-mail。

  mail {
  	...
  }
  

stream

• 语法： stream {…}
• 上下文： 全局块
• 说明： 设置一个STREAM模块。要使用此指令需在构建Nginx时加上配置选项： –with-stream。

  stream {
  	...
  }
  

2.2、位于events块的配置指令

worker_connections

• 语法： worker_connections number;
• 默认： worker_connections 512;
• 上下文： events块
• 说明： 单个工作进程可以允许同时建立外部连接的数量。

  events {
  	worker_connections 10000;
  }
  

use

• 语法： use event_module;
• 参数说明：
  • event_module – 表示事件模型，可选项：select、poll、epoll、kqueue、/dev/poll、eventport
• 默认： —
• 上下文： events块
• 说明： 选择使用的事件模型。一般不用自己设置，因为Nginx会默认使用当前平台下最高效合适的事件模型。

multi_accept

• 语法： multi_accept on|off;
• 默认： multi_accept off;
• 上下文： events块
• 说明： 如果multi_accept被禁用，工作进程将一次接受一个新连接，否则，工作进程将一次接受所有新连接。

  events {
  	multi_accept on;
  }
  

accept_mutex

• 语法： accept_mutex on|off;
• 默认： accept_mutex off;
• 上下文： events块
• 说明： 使用互斥锁进行顺序的 accept() 系统调用，避免惊群。以前的版本中这个是默认开启的，但是后来Linux内核自己解决了 accept() 的惊群问题，就不需要使用这个了。

  events {
  	accept_mutex off;
  }
  

accept_mutex_delay

• 语法： accept_mutex_delay time;
• 默认： accept_mutex_delay 500ms;
• 上下文： events块
• 说明： 如果启用了accept_mutex，该指令将指定工作进程重新尝试获取互斥锁的延迟时间。

  events {
  	accept_mutex_delay 1s;
  }
  

debug_connection

• 语法： debug_connection ip|CIDR|unix:;
• 默认： —
• 上下文： events块
• 说明： 为选定的客户端连接启用调试日志，其它连接将使用由error_log指令设置的日志记录级别。调试连接由IPv4、IPv6地址或网络指定，也可以使用主机名指定连接，对于使用UNIX域套接字的连接，调试日志由"unix:"参数启用。要使用此指令需在构建Nginx时加上配置选项： –with-debug。

  events {
  	debug_connection 127.0.0.1;
  	debug_connection localhost;
  	debug_connection 192.0.2.0/24;
  	debug_connection ::1;
  	debug_connection 2001:0db8::/32;
  	debug_connection unix:;
  }
  

worker_aio_requests

• 语法： worker_aio_requests number;
• 默认： worker_aio_requests 32;
• 上下文： events块
• 说明： 将aio与epoll连接处理方法一起使用时，为单个工作进程设置未完成的异步I/O操作的最大数目。

  events {
  	worker_aio_requests 64;
  }
  

2.3、位于http块的配置指令

2.3.1、ngx_http_access_module模块

allow

• 语法： allow address|CIDR|unix:|all;
• 默认： —
• 上下文： http块、http块中的server块、http块中的location块、http块中的limit_except块
• 说明： 表示描述的网络地址有权直接访问。如果指定unix:，则允许所有UNIX域套接字的访问。注意：allow和deny的规则是按顺序执行的。

deny

• 语法： deny address|CIDR|unix:|all;
• 默认： —
• 上下文： http块、http块中的server块、http块中的location块、http块中的limit_except块
• 说明： 表示描述的网络地址将被拒绝访问。如果指定unix:，则将拒绝所有UNIX域套接字的访问。注意：allow和deny的规则是按顺序执行的。

  # 在下面的例子中，仅允许网段 10.1.1.0/16 和 192.168.1.0/24 中除 192.168.1.1 之外的ip访问
  http {
  	deny    192.168.1.1;
  	allow   192.168.1.0/24;
  	allow   10.1.1.0/16;
  	deny    all;
  }
  

2.3.2、ngx_http_addition_module模块

要使用该模块需要在构建Nginx时加上配置选项： –with-http_addition_module

add_before_body

• 语法： add_before_body uri;
• 默认： —
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 在回复正文的最前面加入一段文字，Nginx会发起一个子请求去获取这些文字。空字符串作为参数时会取消从先前配置级别继承的添加。

add_after_body

• 语法： add_after_body uri;
• 默认： —
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 在回复正文的最后面加入一段文字，Nginx会发起一个子请求去获取这些文字。空字符串作为参数时会取消从先前配置级别继承的添加。

addition_types

• 语法： addition_types mime-type [mime-type …];
• 默认： addition_types text/html;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 指定在响应中回复的MIME类型。默认始终包含 text/html。如果设置类型为"*"，就会匹配任何MIME类型。

  # 对于如下配置，客户端在请求index.html文件之后，发送给它的是依次是before.html、index.html、after.html，是整合为一个body的
  http {
  	server {
  		listen 80;
  		
  		location / {
  			root html;
  			addition_types text/html;
  			add_before_body /before.html;
  			add_after_body /after.html;
  			index index.html;
  		}
  	}
  }
  

2.3.3、ngx_http_auth_basic_module模块

auth_basic

• 语法： auth_basic string|off;
• 默认： auth_basic off;
• 上下文： http块、http块中的server块、http块中的location块、http块中的limit_except块
• 说明： 启用使用“HTTP基本身份验证”协议验证用户名和密码。指定的参数用作 realm，并且参数值可以包含变量。特殊值off表示取消从上一个配置级别继承的auth_basic指令的影响。

auth_basic_user_file

• 语法： auth_basic_user_file file;
• 默认： —
• 上下文： http块、http块中的server块、http块中的location块、http块中的limit_except块
• 说明： 指定保存用户名和密码的文件。

  http {
  	server {
  		listen 80;
  		
  		location / {
  			auth_basic           "gude";
  			auth_basic_user_file conf/htpasswd;
  
  			root html;
  			index index.html;
  		}
  	}
  }
  

2.3.4、ngx_http_auth_request_module模块

要使用该模块需要在构建Nginx时加上配置选项： –with-http_auth_request_module

auth_request

• 语法： auth_request uri|off;
• 默认： auth_request off;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 根据子请求的结果启用授权并设置子请求将发送到指定的URI。

  http {
  	server {
  		location /private/ {
  			auth_request /auth;
  			...
  		}
  
  		location = /auth {
  			...
  		}
  	}
  }
  

auth_request_set

• 语法： auth_request_set $variable value;
• 默认： —
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 在授权请求完成后，将请求变量设置为给定值。该值可能包含来自授权请求的变量，例如 $upstream_http.*。

2.3.5、ngx_http_autoindex_module模块

autoindex

• 语法： autoindex on|off;
• 默认： autoindex off;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 开启或关闭目录列表输出功能。

autoindex_format

• 语法： autoindex_format html|json|jsonp|xml;
• 默认： autoindex_format html;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 设置回显文件格式。

autoindex_localtime

• 语法： autoindex_localtime on|off;
• 参数说明：
  • on – 表示显示的是服务器时间
  • off – 表示显示的是GMT时间
• 默认： autoindex_localtime off;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 设置目录中列出的文件时间是服务器时间还是GMT时间。

autoindex_exact_size

• 语法： autoindex_exact_size on|off;
• 参数说明：
  • on – 表示显示的是精确大小，单位为字节
  • off – 表示显示的带容量单位的粗略时间
• 默认： autoindex_exact_size on;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 设置目录中列出的文件是显示精确大小，还是对KB，MB，GB进行四舍五入。

  http {
  	server {
  		listen 80;
  		
  		location /autoindex {
  			alias /home/bifang/src;
  			autoindex on;
  			autoindex_format html;
  			autoindex_localtime on;
  			autoindex_exact_size off;
  		}
  	}
  }
  

2.3.6、ngx_http_browser_module模块

modern_browser

• 语法： modern_browser browser version;
  ????modern_browser unlisted;
• 默认： —
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 指定一个版本，此版本及后续版本的浏览器都被认定为新式浏览器。浏览器可以是下列之一：msie、gecko(基于Mozilla)、opera、safari或者konqueror。版本可被指定为以下形式：X、X.X、X.X.X 或 X.X.X.X。每一形式的最大值分别是4000、4000.99、4000.99.99和4000.99.99.99。当浏览器既没有在modern_browser中列出，又没有在ancient_browser中列出时，如果配置了特殊值unlisted，那么浏览器将被认定为新式浏览器，否则认定为旧式浏览器。如果请求头中没有"User-Agent"域，浏览器以没有列出对待。

ancient_browser

• 语法： ancient_browser string [string …];
• 默认： —
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 如果任一指定的子串在请求头的"User-Agent"域中被发现，浏览器将被认定为旧式浏览器。特殊字符串"netscape4"相当于正则表达式"^Mozilla/[1-4]"。

modern_browser_value

• 语法： modern_browser_value string;
• 默认： modern_browser_value 1;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 设定变量 $modern_browser 的值。

ancient_browser_value

• 语法： ancient_browser_value string;
• 默认： ancient_browser_value 1;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 设定变量 $ancient_browser 的值。如果浏览器被为识别为新式浏览器， $modern_browser 被设置为modern_browser_value指令设置的值；如果浏览器被识别为旧式浏览器， $ancient_browser 被设置为ancient_browser_value指令设置的值；如果浏览器被识别为任何版本的MSIE， $msie 被设置为"1"。

  # 为指定的浏览器版本指定index页面
  http {
  	server {
  		listen 80;
  		
  		location / {
  			modern_browser_value "modern.";
  			
  			modern_browser msie      5.5;
  			modern_browser gecko     1.0.0;
  			modern_browser opera     9.0;
  			modern_browser safari    413;
  			modern_browser konqueror 3.0;
  			
  			root /usr/local/nginx/html/browser/;
  			
  			index index.${modern_browser}html index.html;
  		}
  	}
  }
  
  # 引导旧式浏览器重定向到指定页面
  http {
  	server {
  		listen 80;
  		
  		location / {
  			modern_browser msie 5.0;
  			
  			modern_browser gecko 0.9.1;
  			modern_browser opera 8.0;
  			modern_browser safari 413;
  			modern_browser konqueror 3.0;
  			
  			modern_browser unlisted;
  			ancient_browser Links Lynx Netscape4;
  			
  			if ($ancient_browser){
  			  rewrite  ^  /ancient.html;
  			}
  		}
  	}
  }
  

2.3.7、ngx_http_charset_filter_module模块

charset

• 语法： charset charset|off;
• 默认： charset off;
• 上下文： http块、http块中的server块、http块中的location块、http块中的location块中的if块
• 说明： 为响应头的"Content-Type"添加指定的字符集。如果这个字符集和source_charset指令设置的字符集不同，就会进行转换。参数off表明不在响应头的"Content-Type"中添加字符集。字符集可以当作变量来定义：charset $charset; 这种情况下，一个变量所有可能的值，至少使用charset_map charset或者source_charset指令中的一种来配置。对于utf-8、windows-1251和koi8-r字符集，在配置中包含conf/koi-win、conf/koi-utf和conf/win-utf这些文件就足够了。对于其它字符集，简单地做一个虚构转换表就可以了， 比如：charset_map iso-8859-5 _ { } 。此外，字符集也可以在响应头的"X-Accel-Charset"中设置。

source_charset

• 语法： source_charset charset;
• 默认： —
• 上下文： http块、http块中的server块、http块中的location块、http块中的location块中的if块
• 说明： 定义响应中的原始字符集，如果这个字符集和charset指令设置字符集的不同，就会进行转换。

  # 转换表示例
  http {
  	include        conf/koi-win;
  	
  	charset        windows-1251;
  	source_charset koi8-r;
  }
  

override_charset

• 语法： override_charset on|off;
• 默认： override_charset off;
• 上下文： http块、http块中的server块、http块中的location块、http块中的location块中的if块
• 说明： 对于接收到的代理服务器或者FastCGI服务器的响应头中"Content-Type"已经带有字符集的情况，确定是否进行字符集转换。如果开启转换，接收到的响应中指定的字符集会被当作原始字符集。需要注意的是，如果在子请求中接收到的应答，始终会将应答的字符集转换为主请求的字符集，无论override_charset指令是否开启。

charset_types

• 语法： charset_types mime-type [mime-type …];
• 默认： charset_types text/html text/xml text/plain text/vnd.wap.wml application/x-javascript application/rss+xml;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 使模块在响应时能处理除了"text/html"之外其他指定的MIME类型。特殊值"*"表示匹配任意的MIME类型。

charset_map

• 语法： charset_map charset1 charset2 {…};
• 默认： —
• 上下文： http块
• 说明： 描述了从一个字符集到另一个字符集的转换表。发行文件conf/koi-win、conf/koi-utf以及conf/win-utf中已经提供了从koi8-r到windows-1251、从koi8-r到utf-8以及从windows-1251到utf-8的完整转换表。

  # 转换表示例如下
  http {
  	charset_map koi8-r utf-8 {
  		C0 D18E ;
  		C1 D0B0 ;
  		C2 D0B1 ;
  		C3 D186 ;
  		...
  	}
  }
  

2.3.8、ngx_http_copy_filter_module模块

output_buffers

• 语法： output_buffers number size;
• 默认： —
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 设置用于从磁盘读取响应信息的缓冲区的数量和大小。

  http {
  	server {
  		output_buffers 1 32k;
  	}
  }
  

2.3.9、ngx_http_core_module模块

variables_hash_max_size

• 语法： variables_hash_max_size size;
• 默认： variables_hash_max_size 1024;
• 上下文： http块
• 说明： 设置变量哈希表的最大容量。

variables_hash_bucket_size

• 语法： variables_hash_bucket_size size;
• 默认： variables_hash_bucket_size 64;
• 上下文： http块
• 说明： 设置变量哈希桶的容量。

server_names_hash_max_size

• 语法： server_names_hash_max_size size;
• 默认： server_names_hash_max_size 512;
• 上下文： http块
• 说明： 设置主机名哈希表的最大容量。

server_names_hash_bucket_size

• 语法： server_names_hash_bucket_size size;
• 默认： server_names_hash_bucket_size 32|64|128;
• 上下文： http块
• 说明： 设置主机名哈希桶的容量，其默认值取决于处理器的缓存行的大小。

server

• 语法： server {…}
• 上下文： http块
• 说明： 设置一个属于http块的server块。

  http {
  	server {
  		...
  	}
  }
  

connection_pool_size

• 语法： connection_pool_size size;
• 默认： connection_pool_size 256|512;
• 上下文： http块、http块中的server块
• 说明： 允许精确调整每个连接的内存分配。该指令对性能的影响很小，一般不应使用。默认情况下，在32位平台上等于256字节，在64位平台上等于512字节。

request_pool_size

• 语法： request_pool_size size;
• 默认： request_pool_size 4k;
• 上下文： http块、http块中的server块
• 说明： 允许准确调整每个请求的内存分配。该指令对性能的影响很小，一般不应使用。

client_header_timeout

• 语法： client_header_timeout time;
• 默认： client_header_timeout 60s;
• 上下文： http块、http块中的server块
• 说明： 定义读取客户端请求头部的超时时间。如果客户端在这段时间内没有传送完整个头部，Nginx将返回错误408(Request Time-out)到客户端。

client_header_buffer_size

• 语法： client_header_buffer_size size;
• 默认： client_header_buffer_size 1k;
• 上下文： http块、http块中的server块
• 说明： 设置读取客户端请求头部的缓冲区大小。对于大多数请求，1K的缓冲区就足够了。但是，如果请求包含长cookie或来自WAP客户端，1K可能不太够。如果请求行或请求头字段不适合此缓冲区，则分配由large_client_header_buffers指令配置的更大缓冲区。

large_client_header_buffers

• 语法： large_client_header_buffers number size;
• 默认： large_client_header_buffers 4 8k;
• 上下文： http块、http块中的server块
• 说明： 设置读取客户端超大请求的缓冲区的数量和每块缓冲的容量。HTTP请求行的长度不能超过一块缓冲的容量，否则Nginx返回错误414(Request-URI Too Large)到客户端。每个请求头的长度也不能超过一块缓冲的容量，否则Nginx返回错误400(Bad Request)到客户端。缓冲区仅在需要时才分配，默认每块的容量是8K字节。如果在请求处理结束后连接转换为保持活动状态，则这些缓冲区将被释放。

ignore_invalid_headers

• 语法： ignore_invalid_headers on|off;
• 默认： ignore_invalid_headers on;
• 上下文： http块、http块中的server块
• 说明： 控制是否忽略非法的请求头字段名。合法的名字是由英文字母、数字和连字符组成，当然也可以包含下划线。本指令可以在默认虚拟主机的server配置层级中定义一次，那么这个值在监听在相同地址和端口的所有虚拟主机上都生效。

merge_slashes

• 语法： merge_slashes on|off;
• 默认： merge_slashes on;
• 上下文： http块、http块中的server块
• 说明： 开启或者关闭将请求URI中相邻两个或更多斜线合并成一个的功能。

  # 关闭该功能之后请求"//html/index.html"将不能匹配以下内容
  http {
  	merge_slashes ff;
  	
  	location /html/ {
  		...
  	}
  }
  

underscores_in_headers

• 语法： underscores_in_headers on|off;
• 默认： underscores_in_headers off;
• 上下文： http块、http块中的server块
• 说明： 启用或禁用在客户端请求头中使用下划线。如果禁止，含有下划线的请求头将被标志为非法请求头并接受ignore_invalid_headers指令的处理。可以在默认主机的server配置级别定义此命令。这样，指令设置将覆盖监听同一地址和端口的所有虚拟主机。

location

• 语法： location [=|_|*|^~] uri {…}
  ????location @name {…}
• 参数说明：
  • = – 该修饰符表示定义的URI和location进行精确匹配，如果找到完全匹配，则搜索终止。例如，如果"/"请求频繁发生，定义"location = /"将加快这些请求的处理速度，因为搜索在第一次比较后立即终止，这样的location显然不能进行嵌套包含另一个location的
  • ~ – 该修饰符表示区分大小的匹配
  • ~* – 该修饰符表示不区分大小的匹配
  • ^~ – 该修饰符表示如果把这个前缀用于一个常规字符串，那么告诉Nginx如果路径匹配那么不测试正则表达式
• 上下文： http块中的server块、http块中的location块
• 说明： 设置一个location模块。

  location = / {
  	[ A ]
  }
  
  location / {
  	[ B ]
  }
  
  location /documents/ {
  	[ C ]
  }
  
  location ^~ /images/ {
  	[ D ]
  }
  
  location ~* \.(gif|jpg|jpeg)$ {
  	[ E ]
  }
  # 对于上述配置，"/"请求匹配A，"/index.html"请求匹配B，"/documents/document.html"请求匹配C，
  # "/images/1.gif"请求匹配配置D，"/documents/1.jpg"请求匹配配置E。
  

listen

• 语法： listen address[:port] [default_server] [ssl] [http2 | spdy] [proxy_protocol] [setfib=number] [fastopen=number] [backlog=number] [rcvbuf=size] [sndbuf=size] [accept_filter=filter] [deferred] [bind] [ipv6only=on|off] [reuseport] [so_keepalive=on|off|[keepidle]:[keepintvl]:[keepcnt]];
  ????listen port [default_server] [ssl] [http2 | spdy] [proxy_protocol] [setfib=number] [fastopen=number] [backlog=number] [rcvbuf=size] [sndbuf=size] [accept_filter=filter] [deferred] [bind] [ipv6only=on|off] [reuseport] [so_keepalive=on|off|[keepidle]:[keepintvl]:[keepcnt]];
  ????listen unix:path [default_server] [ssl] [http2 | spdy] [proxy_protocol] [backlog=number] [rcvbuf=size] [sndbuf=size] [accept_filter=filter] [deferred] [bind] [so_keepalive=on|off|[keepidle]:[keepintvl]:[keepcnt]];
• 默认： listen *:80 | *:8000;
• 上下文： http块中的server块
• 说明： 设置Nginx监听地址，Nginx从这里接受请求。对于IP协议，这个地址就是address和port；对于UNIX域套接字协议，这个地址就是path。一条listen指令只能指定一个address或者por，当然address也可以是主机名。

  http {
  	server {
  		# IPv4
  		listen 127.0.0.1:80;
  		listen 127.0.0.1;
  		listen 80;
  		listen *:80;
  		listen localhost:80;
  		
  		# IPv6
  		listen [::]:80;
  		listen [fe80::1];
  		
  		# UNIX
  		listen unix:/usr/local/nginx/logs/nginx.sock;
  	}
  }
  

server_name

• 语法： server_name name [name …];
• 默认： server_name “”;
• 上下文： http块中的server块
• 说明： 设置虚拟主机名。

  # 以下示例中bifang.com为主服务器名称
  http {
  	server {
  		server_name bifang.com www.bifang.com;
  	}
  }
  

types_hash_max_size

• 语法： types_hash_max_size size;
• 默认： types_hash_max_size 1024;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 设置类型哈希表的最大容量。

types_hash_bucket_size

• 语法： types_hash_bucket_size size;
• 默认： types_hash_bucket_size 64;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 设置类型哈希桶的容量。

types

• 语法： types {…}
• 默认： types {
  ??????text/html html;
  ??????image/gif gif;
  ??????image/jpeg jpg;
  ????}
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 设置文件扩展名和响应的MIME类型的映射表，可以将多个扩展名映射到同一种类型。随Nginx发行的conf/mime.types文件中包含了足够全面的映射表，一般不用自己搞这些。

  http {
  	types {
  		video/3gpp    3gpp 3gp;
  		video/mp2t    ts;
  		video/mp4     mp4;
  		video/mpeg    mpeg mpg;
  	}
  }
  

default_type

• 语法： default_type mime-type;
• 默认： default_type text/plain;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 定义响应的默认MIME类型。

root

• 语法： root path;
• 默认： root html;
• 上下文： http块、http块中的server块、http块中的location块、http块中的location块中的if块
• 说明： 为请求设置根目录。文件路径的构造仅仅是将URI拼在root指令的值后面，如果需要修改URI，应该使用alias指令。

  # /autoindex/test.txt 将由 /home/src/autoindex/test.txt 文件来响应。
  http {
  	server {
  		location /autoindex {
  				root /home/src;
  			}
  	}
  }
  

alias

• 语法： alias path;
• 默认： —
• 上下文： http块中的location块
• 说明： 定义指定路径的替换路径。

  # /autoindex/test.txt 将由 /home/src/test.txt 文件来响应
  http {
  	server {
  		location /autoindex {
  				alias /home/src;
  			}
  	}
  }
  

limit_except

• 语法： limit_except method [method …] {…}
• 默认： —
• 上下文： http块中的location块
• 说明： 允许按请求的HTTP方法限制对某路径的请求。method用于指定不由这些限制条件进行过滤的HTTP方法，可选值有GET、HEAD、POST、PUT、DELETE、MKCOL、COPY、MOVE、OPTIONS、PROPFIND、PROPPATCH、LOCK、UNLOCK和PATCH。指定method为GET方法的同时，Nginx会自动添加HEAD方法。

  # 以下示例将对除GET和HEAD方法以外的所有HTTP方法的请求进行访问限制
  http {
  	server {
  		location / {
  			limit_except GET {
  				allow 192.168.31.1;
  				deny  all;
  			}
  		}
  	}
  }
  

client_max_body_size

• 语法： client_max_body_size size;
• 参数说明：
  • size – 设置为0时可以使Nginx不检查客户端请求正文的长度
• 默认： client_max_body_size 1m;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 设置允许客户端请求正文的最大长度，请求的长度由"Content-Length"请求头指定。如果请求的长度超过设定值，Nginx将返回错误413(Request Entity Too Large)到客户端。

client_body_buffer_size

• 语法： client_body_buffer_size size;
• 默认： client_body_buffer_size 8k|16k;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 设置读取客户端请求正文的缓冲容量，如果请求正文大于缓冲容量，整个正文或者正文的一部分将写入临时文件。

client_body_timeout

• 语法： client_body_timeout time;
• 默认： client_body_timeout 60s;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 定义读取客户端请求正文的超时。超时是指相邻两次读操作之间的最大时间间隔，而不是整个请求正文完成传输的最大时间。如果客户端在这段时间内没有传输任何数据，Nginx将返回408(Request Time-out)错误到客户端。

client_body_temp_path

• 语法： client_body_temp_path path [level1 [level2 [level3]]];
• 默认： client_body_temp_path client_body_temp;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 定义存储客户端请求正文的临时文件的目录，支持在指定目录下多达3层的子目录结构。

  # 对于以下配置，临时文件可能为：/usr/local/nginx/client_temp/3/18/00000123456
  http {
  	client_body_temp_path /usr/local/nginx/client_temp 1 2;
  }
  

client_body_in_file_only

• 语法： client_body_in_file_only on|clean|off;
• 参数说明：
  • on – 表示请求处理结束后不会删除临时文件
  • clean – 表示请求处理结束后会删除临时文件
• 默认： client_body_in_file_only off;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 决定Nginx是否将客户端请求正文整个写入文件。这条指令在调试、使用 $request_body_file 变量或者使用ngx_http_perl_module模块的 $r->request_body_file 方法时都可以使用。

client_body_in_single_buffer

• 语法： client_body_in_single_buffer on|off;
• 默认： client_body_in_single_buffer off;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 决定是否将Nginx将整个客户端请求正文保存在一块缓冲中。

sendfile

• 语法： sendfile on|off;
• 默认： sendfile off;
• 上下文： http块、http块中的server块、http块中的location块、http块中的location块中的if块
• 说明： 启用或禁用 sendfile() 。

sendfile_max_chunk

• 语法： sendfile_max_chunk size;
• 默认： sendfile_max_chunk 0;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 设置为非0值时，可以限制在一次 sendfile() 调用时传输的数据量。如果不进行限制，一个快速的连接可能会霸占整个worker进程的所有资源。

subrequest_output_buffer_size

• 语法： subrequest_output_buffer_size size;
• 默认： subrequest_output_buffer_size 4k|8k;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 设置用于存储子请求响应主体的缓冲区的大小。默认情况下，缓冲区大小等于一页内存，即4K或8K，具体取决于平台。

aio

• 语法： aio on|off|sendfile;
• 默认： aio off;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 启用或者禁用异步文件I/O(AIO)。

aio_write

• 语法： aio_write on|off;
• 默认： aio_write off;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 如果启用了aio，则指定是否将其用于写入文件。

read_ahead

• 语法： read_ahead size;
• 默认： read_ahead 0;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 设置内核参数，控制文件预读的数量。在Linux上无效。

directio

• 语法： directio size|off;
• 默认： directio off;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 当读入长度大于等于指定size的文件时，开启DirectIO功能。它在处理大文件或者在Linux系统使用aio时比较有用。

directio_alignment

• 语法： directio_alignment size;
• 默认： directio_alignment 512;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 为directio设置文件偏移量对齐。

tcp_nopush

• 语法： tcp_nopush on|off;
• 默认： tcp_nopush off;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 启用或禁用在Linux上使用TCP_CORK套接字选项，选项仅在使用sendfile的时候才开启。开启此选项允许在Linux上将响应头和正文的开始部分一起发送或一次性发送整个文件。

tcp_nodelay

• 语法： tcp_nodelay on|off;
• 默认： tcp_nodelay on;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 启用或禁用TCP_NODELAY选项。当连接转变为长连接或upstream发送响应到客户端时启用该选项。此外，它还在SSL连接、无缓冲代理和WebSocket代理上启用。

send_timeout

• 语法： send_timeout time;
• 默认： send_timeout 60s;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 设置向客户端传输响应的超时时间。超时仅指两次相邻写操作之间的时间间隔，而非整个响应的传输时间。如果客户端在这段时间中没有收到任何数据，连接将关闭。

send_lowat

• 语法： send_lowat size;
• 默认： send_lowat 0;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 如果设置成非0值，Nginx将尝试最小化向客户端发送数据的次数。在Linux中改配置无效。

postpone_output

• 语法： postpone_output size;
• 参数说明：
  • size – 为0表示关闭推迟发送的功能
• 默认： postpone_output 1460;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 如果可能，到客户端的数据将被推迟发送，直到Nginx需要发送的数据至少有size字节。

limit_rate

• 语法： limit_rate rate;
• 参数说明：
  • rate – 为0表示不限速
• 默认： limit_rate 0;
• 上下文： http块、http块中的server块、http块中的location块、http块中的location块中的if块
• 说明： 限制向客户端传送响应的速率限制。Nginx按连接限速，所以如果某个客户端同时开启了两个连接，那么客户端的整体速率是这条指令设置值的2倍。

limit_rate_after

• 语法： limit_rate_after size;
• 默认： limit_rate_after 0;
• 上下文： http块、http块中的server块、http块中的location块、http块中的location块中的if块
• 说明： 当传输量大于size时，超出部分将限速传送。

keepalive_timeout

• 语法： keepalive_timeout timeout [header_timeout];
• 默认： keepalive_timeout 75s;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 第一个参数设置客户端的长连接在服务器端保持的最长时间（在此时间客户端未发起新请求，则长连接关闭），第二个参数为可选项，设置"Keep-Alive: timeout=time"响应头的值。

keepalive_requests

• 语法： keepalive_requests number;
• 默认： keepalive_requests 100;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 设置通过一个长连接可以处理的最大请求数，请求数超过此值，长连接将关闭。

keepalive_disable

• 语法： keepalive_disable none|browser [browser …];
• 默认： keepalive_disable msie6;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 针对行为异常的浏览器关闭长连接功能，browser参数指定那些浏览器会受到影响。值为msie6表示在遇到POST请求时，关闭与老版MSIE浏览器建立长连接。值为safari表示在遇到MacOS X和类MacOS X操作系统下的Safari浏览器和类Safari浏览器时，不与浏览器建立长连接。值为none表示为所有浏览器开启长连接功能。

satisfy

• 语法： satisfy all|any;
• 默认： satisfy all;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： Nginx进行访问限制的有ngx_http_access_module模块、ngx_http_auth_basic_module模块、ngx_http_auth_request_module模块和ngx_http_auth_jwt_module模块。本指令设置成all时，表示只有当所有模块的所有限制条件(写入配置的)都授权访问时，允许请求访问；设置成any时，表示如果当任意模块的任意限制条件授权访问时，允许请求访问。

auth_delay

• 语法： auth_delay time;
• 默认： auth_delay 0s;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 当访问受密码、子请求结果或JWT限制时，使用401响应代码延迟处理未经授权的请求，以防止计时攻击。

internal

• 语法： internal;
• 默认： —
• 上下文： http块中的location块
• 说明： 指定一个路径是否只能用于内部访问。如果是外部访问，客户端将收到404(Not Found)错误。内部请求如下：
  1. 由error_page、index、random_index和try_files指令重定向的请求
  2. 来自上游服务器的"X-Accel-Redirect"响应头字段重定向的请求
  3. 由ngx_http_ssi_module模块的"include virtual"命令、ngx_http_addition_modul模块指令以及auth_request和mirror指令形成的子请求
  4. 由rewrite指令更改的请求。

  # 每个请求有10个内部重定向的限制，以防止在不正确的配置中可能发生的请求处理周期。如果达到此限制，则返回错误500（Internal Server Error）。在这种情况下，可以在错误日志中看到“重写或内部重定向循环”消息
  http {
  	error_page 404 /404.html;
  	location /404.html {
  		internal;
  	}
  }
  

lingering_close

• 语法： lingering_close off|on|always;
• 参数说明：
  • off – 表示Nginx立即关闭连接，绝不等待客户端传送额外数据，这样做违反了协议，不应在正常情况下使用
  • on – 表示Nginx在完成关闭连接前等待和处理客户端发来的额外数据，但只有在预测客户端可能发送更多数据的情况才会做此处理
  • always – 表示Nginx无条件等待和处理客户端的额外数据
• 默认： lingering_close on;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 控制Nginx如何关闭客户端连接。

lingering_time

• 语法： lingering_time time;
• 默认： lingering_time 30s;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： lingering_close生效时，这条指令定义Nginx处理(读取但忽略)客户端额外数据的最长时间。超过这段时间后，Nginx将关闭连接，不论是否还有更多数据待处理。

lingering_timeout

• 语法： lingering_timeout time;
• 默认： lingering_timeout 5s;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： lingering_close生效时，这条指令定义Nginx等待客户端更多数据到来的最长时间。如果在这段时间内，Nginx没有接收到数据，Nginx将关闭连接。否则，Nginx将接收数据，忽略它，然后再等待更多数据。这个“等待——接收——忽略”的循环一直重复，但总时间不会超过lingering_time指令定义的时间。

reset_timedout_connection

• 语法： reset_timedout_connection on|off;
• 默认： reset_timedout_connection off;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 开启或关闭重置超时连接的功能。重置连接是这样执行的：关闭套接字以前，设置SO_LINGER选项的超时值为0，那么当关闭套接字时，Nginx向客户端发送TCP RST，并且释放此套接字占用的所有内存。这样可以避免某个已关闭的套接字长时间处于FIN_WAIT1状态，并占用内存缓冲区。应该注意的事，超时的长连接仍然是正常关闭。

absolute_redirect

• 语法： absolute_redirect on|off;
• 默认： absolute_redirect on;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 如果禁用，Nginx发出的重定向将是相对的。

server_name_in_redirect

• 语法： server_name_in_redirect on|off;
• 默认： server_name_in_redirect off;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 启用或禁用Nginx将server_name指令指定的首要虚拟主机名用于发起的重定向的功能。关闭此功能时，Nginx将使用"Host"请求头的中的名字，如果没有此请求头，将使用虚拟主机所在的IP地址。重定向中端口的使用由port_in_redirect指令控制。

port_in_redirect

• 语法： port_in_redirect on|off;
• 默认： port_in_redirect on;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 启用或禁用在Nginx发出的绝对重定向中指定端口。重定向中首要主机名的使用由server_name_in_redirect指令控制。

msie_padding

• 语法： msie_padding on|off;
• 默认： msie_padding on;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 启用或禁用向状态码大于400的MSIE客户端的响应添加注释，以将响应大小增加到512字节。

msie_refresh

• 语法： msie_refresh on|off;
• 默认： msie_refresh on;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 为MSIE客户端开启或者关闭用页面刷新取代页面重定向的功能。

log_not_found

• 语法： log_not_found on|off;
• 默认： log_not_found on;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 启用或禁用在error_log中记录文件不存在的错误。

log_subrequest

• 语法： log_subrequest on|off;
• 默认： log_subrequest off;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 启用或禁用在access_log中记录子请求的访问日志。

recursive_error_pages

• 语法： recursive_error_pages on|off;
• 默认： recursive_error_pages off;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 启用或禁用error_page指令进行多次重定向。允许的话，重定向次数也有限制。而禁止此功能时，当访问error_page指令重定向的错误页面出现任何问题时，Nginx将直接输出默认错误页面。

server_tokens

• 语法： server_tokens on|off;
• 默认： server_tokens on;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 启用或禁用在错误信息的"Server"响应头中添加Nginx版本号。

if_modified_since

• 语法： if_modified_since off|exact|before;
• 参数说明：
  • off – 表示"If-Modified-Since"请求头字段被忽略
  • exact – 表示响应信息的修改时间与"If-Modified-Since"请求头字段中的时间必须完全一致
  • before – 表示响应信息的修改时间小于或等于"If-Modified-Since"请求头字段中的时间
• 默认： if_modified_since exact;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 指定如何将响应信息的修改时间与"If-Modified-Since"请求头字段中的时间进行比较。

max_ranges

• 语法： max_ranges number;
• 参数说明： 参数number为0时表示完全禁用字节范围请求
• 默认： —
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 限制字节范围请求中允许的最大范围数。如果没有指定字节范围，则会处理超过限制的请求。默认情况下，范围的数量不受限制。

chunked_transfer_encoding

• 语法： chunked_transfer_encoding on|off;
• 默认： chunked_transfer_encoding on;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 启用或禁用在HTTP/1.1中使用分块传输编码。尽管标准要求必须实现，但在使用无法支持分块编码的软件时，它可能会派上用场。

etag

• 语法： etag on|off;
• 默认： etag on;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 启用或禁用静态资源的"ETag"响应头字段的自动生成。

error_page

• 语法： error_page code … [=[response]] uri;
• 默认： —
• 上下文： http块、http块中的server块、http块中的location块、http块中的location块中的if块
• 说明： 设置指定的错误码对应显示的URI，uri可以包含变量。

  http {
  	server {
  		# 这会导致内部重定向到指定uri的客户端请求方法更改为"GET"（对于"GET"和"HEAD"以外的所有方法）
  		error_page 404 /404.html;
  		error_page 500 502 503 504 /50x.html;
  		
  		# 可以使用"=response"语法将响应代码更改为另一个
  		error_page 404 =200 /empty.gif;
  		
  		# 如果错误响应由代理服务器或FastCGI/uwsgi/SCGI/gRPC服务器处理，并且服务器可能返回不同的响应代码（例如200、302、401或404），则可以使用它的代码进行响应返回
  		error_page 404 = /404.php;
  		
  		# 如果在内部重定向期间不需要更改URI和请求方法，则可以将错误处理传递到命名位置
  		location / { 
  			error_page 404 = @fallback; 
  		} 
  
  		location @fallback { 
  			proxy_pass http://backend; 
  		}
  		
  		#也可以使用URL重定向进行错误处理
  		error_page 403 http://example.com/forbidden.html;
  		error_page 404 =301 http://example.com/notfound.html;
  	}
  }
  

post_action

• 语法： post_action action;
• 默认： —
• 上下文： http块、http块中的server块、http块中的location块、http块中的location块中的if块
• 说明： 该指令会在http请求结束时产生一个新请求，产生一个内部跳转。

  # 以下示例在http://www.a.com/访问结束时，会产生一个内部跳转请求，跳转到@action，访问上游www.a-post-action.com
  http {
  	server {
  		listen  80;
  		server_name www.a.com;
  
  		location / {
  				proxy_set_header Host "www.a-upstream.com";
  				proxy_pass http://127.0.0.1:8000;
  				post_action @action;
  		}
  
  		location @action {
  				proxy_set_header Host "www.a-post-action.com";
  				proxy_pass http://127.0.0.1:8001;
  		}
  	}
  }
  

}
```

error_log

• 语法： error_log file [level];
• 参数说明：
  • file – 表示存储日志的文件，特殊值stderr表示选择标准错误文件，可以通过指定"syslog:"前缀来配置日志到syslog，可以通过指定"memory:"前缀和缓冲区大小来配置到循环内存缓冲区的日志记录
  • level – 表示日志记录的级别，可以是以下级别之一：debug、info、notice、warn、error、crit、alert或emerg。以上的日志级别是按严重性递增的顺序列出的，设置某个日志级别将导致记录指定的和更严重的日志级别的所有消息，如果省略此参数，则默认使用error级别记录日志
• 默认： error_log logs/error.log error;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 配置日志记录，可以在同一配置级别上指定多个日志，如果在全局配置级别上未明确定义将日志写入文件，则将使用默认文件。如果要打印DEBUG级别的日志，需在构建Nginx时加上配置选项： –with-debug。

open_file_cache

• 语法： open_file_cache off|max=N [inactive=time];
• 参数说明：
  • off – 表示禁用缓存
  • max – 表示设置缓存中元素的最大数量，当缓存溢出时，最近最少使用的元素被删除(LRU)
  • inactive – 表示定义一个时间，如果元素在这段时间内未被访问，则在该时间之后从缓存中删除该元素，默认为60秒
• 默认： open_file_cache off;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 配置可以存储的缓存：
  1. 打开文件描述符，它们的大小和修改时间；
  2. 有关目录存在的信息；
  3. 文件查找错误，例如“找不到文件”、“没有读取权限”等。

open_file_cache_valid

• 语法： open_file_cache_valid time;
• 默认： open_file_cache_valid 60s;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 设置验证open_file_cache缓存元素的时间。

open_file_cache_min_uses

• 语法： open_file_cache_min_uses number;
• 默认： open_file_cache_min_uses 1;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 在open_file_cache指令number的inactive参数配置的时间段内设置文件访问的最小值，这是文件描述符在缓存中保持打开状态所必需的。

open_file_cache_errors

• 语法： open_file_cache_errors on|off;
• 默认： open_file_cache_errors off;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 通过open_file_cache启用或禁用文件查找错误的缓存。

open_file_cache_events

• 语法： open_file_cache_events on|off;
• 默认： open_file_cache_events off;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 通过open_file_cache启用或禁用事件缓存。

resolver

• 语法： resolver address [address …] [valid=time] [ipv6=on|off] [status_zone=zone];
• 参数说明：
  • address – 表示指定的域名或IP地址，如果未指定端口，则默认使用53端口
  • valid – 表示允许缓存的时间，默认情况下，Nginx使用响应的TTL值来作为缓存应答的时间
  • ipv6 – 表示是否查找IPv6地址，默认解析时会同时查找IPv4和IPv6地址，可以显示地使用"ipv6=off"来取消查找IPv6地址
  • status_zone – 表示收集指定区域内请求和响应的DNS服务器统计信息
• 默认： —
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 配置用于将上游服务器的名称解析为地址的名称服务器，解析时以循环方式进行查询。

  http {
  	resolver 127.0.0.1 [::1]:5353;
  	resolver 127.0.0.1 [::1]:5353 valid=30s;
  }
  

resolver_timeout

• 语法： resolver_timeout time;
• 默认： resolver_timeout 30s;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 设置DNS操作的超时时间。

gzip_vary

• 语法： gzip_vary on|off;
• 默认： gzip_vary off;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 如果gzip、gzip_static或gunzip是激活的，启用或禁用插入"Vary: Accept-Encoding"响应头字段。

gzip_http_version

• 语法： gzip_http_version 1.0|1.1;
• 默认： gzip_http_version 1.1;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 设置压缩响应所需请求的最低HTTP版本。

gzip_proxied

• 语法： gzip_proxied off|expired|no-cache|no-store|private|no_last_modified|no_etag|auth|any […];
• 参数说明：
  • off – 表示禁用所有代理请求的压缩，忽略其他参数
  • expired – 表示如果响应头包含具有禁用缓存值的"Expires"字段，则启用压缩
  • no-cache – 表示如果响应头包含"Cache-Control"字段，并且其值为"no-cache"，则启用压缩
  • no-store – 表示如果响应头包含"Cache-Control"字段，并且其值为"no-store"，则启用压缩
  • private – 表示如果响应头包含"Cache-Control"字段，并且其值为"private"，则启用压缩
  • no_last_modified – 表示如果响应头不包含"Last-Modified"字段，则启用压缩
  • no_etag – 表示如果响应头不包含"ETag"字段，则启用压缩
  • auth – 表示如果请求头包含"Authorization"字段，则启用压缩
  • any – 表示为所有代理请求启用压缩
• 默认： gzip_proxied off;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 根据请求和响应启用或禁用对代理请求的响应进行gzip压缩，该指令接受多个参数。

gzip_disable

• 语法： gzip_disable regex [regex …];
• 默认： —
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 禁止对"User-Agent"标头字段匹配任何指定正则表达式的请求的响应进行gzip压缩。

disable_symlinks

• 语法： disable_symlinks off;
  ????disable_symlinks on|if_not_owner [from=part];
• 参数说明：
  • off – 表示路径名中的符号链接是允许的，不需要进行检查，这是默认行为
  • on – 表示如果路径名的任何组成部分是符号链接，则拒绝访问文件
  • if_not_owner – 表示如果路径名的任何组成部分是符号链接，并且链接指向的链接和对象具有不同的所有者，则拒绝访问文件
  • from=part – 表示检查符号链接（参数on和if_not_owner）时，通常会检查路径名的所有组成部分，通过额外指定from=part参数，可以避免检查路径名初始部分中的符号链接，在这种情况下，仅从指定初始部分之后的路径名组件检查符号链接，如果该值不是检查的路径名的初始部分，则检查整个路径名，就好像根本没有指定此参数一样，如果该值与整个文件名匹配，则不会检查符号链接，参数值可以包含变量
• 默认： disable_symlinks off;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 确定打开的文件是一个符号链接时应如何进行处理。

  http {
  	disable_symlinks on from=$document_root;
  }
  

2.3.10、ngx_http_dav_module模块

要使用该模块需要在构建Nginx时加上配置选项： –with-http_dav_module
该模块无法单独使用，需要与提供WebDAV操作方法的模块一起使用，可以 点击这里 获取配合WebDAV使用的第三方模块

dav_methods

• 语法： dav_methods off | method [method …];
• 默认： dav_methods off;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 允许指定的HTTP和WebDAV接受的方法。参数off表示拒绝此模块处理的所有方法，支持的方法有：PUT，DELETE，MKCOL，COPY和MOVE。

create_full_put_path

• 语法： create_full_put_path on|off;
• 默认： create_full_put_path off;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： WebDAV规范只允许在现有目录中创建文件，该指令允许创建所有需要的中间目录。

min_delete_depth

• 语法： min_delete_depth number;
• 默认： min_delete_depth 0;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 允许DELETE方法删除文件，前提是请求路径中的元素数不小于指定的数量。

  # 对于以下配置，允许根据请求删除/users/00/00/name文件，不允许删除/users/11/name文件
  http {
  	server {
  		location / {
  			root    /home/bifang;
  			
  			dav_methods PUT DELETE MKCOL COPY MOVE;
  			create_full_put_path  on;
  			min_delete_depth 4;
  		}
  	}
  }
  

dav_access

• 语法： dav_access users:permissions [users:permissions …];
• 默认： dav_access user:rw;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 为新创建的文件和目录设置访问权限。

  http {
  	server {
  		location / {
  			...
  			# 正常设置权限
  			dav_access user:rw group:rw all:r;
  			# 如果指定了任意group或all访问权限，则user可以省略权限
  			dav_access group:rw all:r;
  		}
  	}
  }
  

2.3.11、ngx_http_degradation_module模块

要使用该模块需要在构建Nginx时加上配置选项： –with-http_degradation_module

degradation

• 语法： degradation sbrk=size;
• 默认： —
• 上下文： http块
• 说明： 设置Nginx内存使用限制，超过此限制将返回错误响应给客户端。

degrade

• 语法： degrade 204|444;
• 默认： —
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 当内存限制达到时（degradation指令），选择返回给客户端的是204响应还是444响应。

2.3.12、ngx_http_empty_gif_module模块

empty_gif

• 语法： empty_gif;
• 默认： —
• 上下文： http块中的location块
• 说明： 浏览器在访问网页时会请求一个ico文件来作为收藏夹的小图标，如果不想实现这个功能又不想报错的话可以使用该模块，该模块向浏览器发出单像素透明GIF，以此来骗浏览器。

2.3.13、ngx_http_fastcgi_module模块

fastcgi_pass

• 语法： fastcgi_pass address;
• 默认： —
• 上下文： http块中的location块、http块中的location块中的if块
• 说明： 设置FastCGI服务器的地址，地址可以指定为域名或IP地址，也可以是UNIX域套接字。

  http {
  	server {
  		location / {
  			fastcgi_pass localhost:9000;
  			# UNIX域套接字路径
  			fastcgi_pass unix:/tmp/fastcgi.socket;
  			
  		}
  	}
  }
  

fastcgi_index

• 语法： fastcgi_index name;
• 默认： —
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 在 $fastcgi_script_name 变量的值中设置一个文件名，该文件名将附加在以斜杠结尾的URI之后。

  http {
  	server {
  		location / {
  			# 对于"/page.php"请求，SCRIPT_FILENAME参数将等于"/home/www/scripts/php/page.php"
  			# 对于"/"请求，它将等于"/home/www/scripts/php/index.php"
  			fastcgi_index index.php;
  			fastcgi_param SCRIPT_FILENAME /home/www/scripts/php$fastcgi_script_name;
  		}
  	}
  }
  

fastcgi_split_path_info

• 语法： fastcgi_split_path_info regex;
• 默认： —
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 定义捕获 $fastcgi_path_info 变量值的正则表达式。正则表达式应该有两个捕获：第一个成为 $fastcgi_script_name 变量的值，第二个成为 $fastcgi_path_info 变量的值。

  # 以下设置对于"/show.php/article/0001"请求，SCRIPT_FILENAME参数等于"/path/to/php/show.php"，PATH_INFO参数等于"/article/0001"
  http {
  	server {
  		location ~ ^(.+\.php)(.*)$ {
  			fastcgi_split_path_info       ^(.+\.php)(.*)$;
  			fastcgi_param SCRIPT_FILENAME /path/to/php$fastcgi_script_name;
  			fastcgi_param PATH_INFO       $fastcgi_path_info;
  		}
  	}
  }
  

fastcgi_store

• 语法： fastcgi_store on|off|string;
• 参数说明：
  • on – 表示将文件保存到alias或root对应的路径
  • off – 表示禁止保存文件
  • string – 表示显式地设置文件名，文件名可以使用变量来代替
• 默认： fastcgi_store off;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 启用或禁止将文件保存到磁盘。

fastcgi_store_access

• 语法： fastcgi_store_access users:permissions [users:permissions …];
• 默认： fastcgi_store_access user:rw;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 为新创建的文件和目录设置访问权限。

  http {
  	server {
  		location ~ ^(.+\.php)(.*)$ {
  			...
  			# 正常设置权限
  			fastcgi_store_access user:rw group:rw all:r;
  			# 如果指定了任意group或all访问权限，则user可以省略权限
  			fastcgi_store_access group:rw all:r;
  		}
  	}
  }
  

fastcgi_buffering

• 语法： fastcgi_buffering on|off;
• 默认： fastcgi_buffering on;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 启用或禁用来自FastCGI服务器的响应缓冲。启用缓冲后，Nginx会尽快收到来自FastCGI服务器的响应，将其保存到由fastcgi_buffer_size和fastcgi_buffers指令设置的缓冲区中。如果整个响应过大，可以将其中的一部分保存到磁盘上的临时文件中。写入临时文件由fastcgi_max_temp_file_size和fastcgi_temp_file_write_size指令控制。当缓冲被禁用时，响应会在收到时立即同步传递给客户端。Nginx不会尝试从FastCGI服务器读取整个响应。Nginx一次可以从服务器接收的最大数据大小由fastcgi_buffer_size指令设置。也可以通过在"X-Accel-Buffering"响应头字段中传递"yes"或"no"来启用或禁用缓冲。可以使用fastcgi_ignore_headers指令禁用此功能。

fastcgi_request_buffering

• 语法： fastcgi_request_buffering on|off;
• 默认： fastcgi_request_buffering on;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 启用或禁用客户端请求正文的缓冲。启用缓冲后，在将请求发送到FastCGI服务器之前，将从客户端读取整个请求正文。当缓冲被禁用时，请求正文在收到时立即发送到FastCGI服务器。在这种情况下，如果Nginx已经开始发送请求正文，则请求无法传递到下一个服务器。

fastcgi_ignore_client_abort

• 语法： fastcgi_ignore_client_abort on|off;
• 默认： fastcgi_ignore_client_abort off;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 确定当客户端在不等待响应的情况下关闭连接时，是否应关闭与FastCGI服务器的连接。

fastcgi_bind

• 语法： fastcgi_bind address [transparent]|off;
• 参数说明：
  • address – 表示IP地址，可以包含变量
  • transparent – 表示允许从非本地IP地址发起到FastCGI服务器的连接
  • off – 表示取消了fastcgi_bind指令从上一个配置级别继承的影响，它允许系统自动分配本地IP地址和端口
• 默认： —
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 从指定的带有可选端口的本地IP地址向FastCGI服务器发起连接，

  http {
  	fastcgi_bind $remote_addr transparent;
  }
  

fastcgi_socket_keepalive

• 语法： fastcgi_socket_keepalive on|off;
• 默认： fastcgi_socket_keepalive off;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 为发送到FastCGI服务器的连接配置"TCP keepalive"选项。默认情况下，操作系统的设置对套接字有效。如果该指令的值被设置为"on"，则该套接字的SO_KEEPALIVE选项将被打开。

fastcgi_connect_timeout

• 语法： fastcgi_connect_timeout time;
• 默认： fastcgi_connect_timeout 60s;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 定义与FastCGI服务器建立连接的超时时间。需要注意的是，这个超时时间通常不能超过75秒。

fastcgi_send_lowat

• 语法： fastcgi_send_lowat size;
• 默认： fastcgi_send_lowat 0;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 该指令在Linux上无效。

fastcgi_buffer_size

• 语法： fastcgi_buffer_size size;
• 默认： fastcgi_buffer_size 4k|8k;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 设置用于读取从FastCGI服务器接收的响应的第一部分的缓冲区的大小，这部分通常包含一个小的响应头。默认情况下，缓冲区大小等于一页内存，有可能是4K或8K，具体取决于平台。

fastcgi_pass_request_headers

• 语法： fastcgi_pass_request_headers on|off;
• 默认： fastcgi_pass_request_headers on;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 指示是否将原始请求的报头字段传递给FastCGI服务器。

fastcgi_pass_request_body

• 语法： fastcgi_pass_request_body on|off;
• 默认： fastcgi_pass_request_body on;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 指示是否将原始请求正文信息传递给FastCGI服务器。

fastcgi_intercept_errors

• 语法： fastcgi_intercept_errors on|off;
• 默认： fastcgi_intercept_errors off;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 确定是否应该将响应码大于或等于300的FastCGI服务器响应传递给客户端，或者拦截并重定向到Nginx以使用error_page指令进行处理。

fastcgi_read_timeout

• 语法： fastcgi_read_timeout time;
• 默认： fastcgi_read_timeout 60s;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 定义从FastCGI服务器读取响应的超时时间。这里指的是在两次连续读取操作之间间隔，而不是针对整个响应的传输。如果FastCGI服务器在此时间内没有传输任何内容，则连接关闭。

fastcgi_buffers

• 语法： fastcgi_buffers number size;
• 默认： fastcgi_buffers 8 4k|8k;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 为单个连接设置用于从FastCGI服务器读取响应的缓冲区的数量和大小。默认情况下，缓冲区大小等于一页内存，有可能是4K或8K，具体取决于平台。

fastcgi_busy_buffers_size

• 语法： fastcgi_busy_buffers_size size;
• 默认： fastcgi_busy_buffers_size 8k|16k;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 当启用了对来自FastCGI服务器的响应的缓存时，该指令可以限制缓冲区的总大小，可以是正忙于发送到客户端的响应，而响应还没有完全读取。同时，其余的缓冲区可用于读取响应，如果需要，还可以缓冲对临时文件的部分响应。默认情况下，大小受fastcgi_buffer_size和fastcgi_buffers两个缓冲区大小的限制。

fastcgi_force_ranges

• 语法： fastcgi_force_ranges on|off;
• 默认： fastcgi_force_ranges off;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 无论这些响应中的"Accept-Ranges"字段如何，都为来自FastCGI服务器的缓存和未缓存响应启用字节范围支持。

fastcgi_limit_rate

• 语法： fastcgi_limit_rate rate;
• 参数说明：
  • rate – 为0时表示不限速
• 默认： fastcgi_limit_rate 0;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 限制从FastCGI服务器读取响应的速度。该限制是针对每个请求设置的，因此如果Nginx同时打开两个到FastCFI服务器的连接，则总体速率将是指定限制的两倍。仅当启用了FastCGI服务器的响应缓冲时，此限制才有效。

fastcgi_cache

• 语法： fastcgi_cache zone|off;
• 参数说明：
  • zone – 表示缓存的区域,可以包含变量
  • off – 表示禁用从先前配置级别继承缓存信息
• 默认： fastcgi_cache off;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 定义用于缓存的共享内存区域，同一个区域可以在多个地方使用。

fastcgi_cache_key

• 语法： fastcgi_cache_key string;
• 默认： —
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 定义一个用于缓存的键。

fastcgi_cache_path

• 语法： fastcgi_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];
• 默认： —
• 上下文： http块
• 说明： 设置缓存的路径和其他参数，缓存数据存储在文件中，缓存中的键名和文件名都是对代理URL使用MD5函数生成的结果。

fastcgi_cache_bypass

• 语法： fastcgi_cache_bypass string [string …];
• 默认： —
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 定义不从缓存中获取响应的条件，如果字符串参数中至少有一个值不为空且不等于"0"，则不会从缓存中获取响应。

  http {
  	fastcgi_cache_bypass $cookie_nocache $arg_nocache$arg_comment; 
  	fastcgi_cache_bypass $http_pragma $http_authorization;
  }
  

fastcgi_no_cache

• 语法： fastcgi_no_cache string [string …];
• 默认： —
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 定义不将响应保存到缓存的条件。如果字符串参数中至少有一个值不为空且不等于"0"，则不会保存响应。

  http {
  	fastcgi_no_cache $cookie_nocache $arg_nocache$arg_comment; 
  	fastcgi_no_cache $http_pragma $http_authorization;
  }
  

fastcgi_cache_valid

• 语法： fastcgi_cache_valid [code …] time;
• 默认： —
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 为不同的响应码设置缓存时间。

  http {
  	# 为响应码200和302的响应信息设置10分钟的缓存
  	fastcgi_cache_valid 200 302 10m;
  	# 为响应码404的响应信息设置1分钟的缓存
  	fastcgi_cache_valid 404 1m;
  	
  	# 如果没有指定响应码，则只有200、301和302响应被缓存。
  	fastcgi_cache_valid 5m;
  	
  	# 可以指定any参数来表示缓存任何响应
  	fastcgi_cache_valid any 1m;
  }
  

fastcgi_cache_min_uses

• 语法： fastcgi_cache_min_uses number;
• 默认： fastcgi_cache_min_uses 1;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 设置一个请求数，当超过该请求数之后将缓存响应。

fastcgi_cache_max_range_offset

• 语法： fastcgi_cache_max_range_offset number;
• 默认： —
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 设置字节范围请求的字节偏移量，如果范围超出了偏移量，范围请求将被传递到FastCGI服务器，而响应将不会被缓存。

fastcgi_cache_use_stale

• 语法： fastcgi_cache_use_stale error|timeout|invalid_header|updating|http_500|http_503|http_403|http_404|http_429|off …;
• 默认： fastcgi_cache_use_stale off;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 确定在什么情况下，当与FastCGI服务器通信时发生错误时，可以使用过时的缓存响应，该指令的参数与fastcgi_next_upstream指令的参数匹配。如果无法选择FastCGI服务器来处理请求，错误参数还允许使用过时的缓存响应。此外，如果当前正在更新缓存响应，则更新参数允许使用过时的响应，这允许在更新缓存数据时最小化对FastCGI服务器的访问次数。也可以在响应失效后在响应头中直接启用过期缓存响应，这比使用指令参数具有更低的优先级。"Cache-Control"报头字段的"stale-while-revalidate"扩展允许在当前正在更新的情况下使用陈旧的缓存响应，"Cache-Control"报头字段的"stale-if-error"扩展允许在出现错误时使用陈旧的缓存响应。当填充一个新的缓存元素时，为了最小化对FastCGI服务器的访问次数，可以使用fastcgi_cache_lock指令。

fastcgi_cache_methods

• 语法： fastcgi_cache_methods GET|HEAD|POST [GET|HEAD|POST …];
• 默认： fastcgi_cache_methods GET HEAD;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 如果此指令中列出了客户端请求方法，则响应将被缓存。GET和HEAD方法始终添加到列表中，但建议明确指定它们。

fastcgi_cache_lock

• 语法： fastcgi_cache_lock on|off;
• 默认： fastcgi_cache_lock off;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 当启用时，一次只允许一个请求填充一个新的缓存元素，根据fastcgi_cache_key指令，通过传递一个请求到FastCGI服务器。对同一个缓存元素的其它请求要么等待响应出现在缓存中，要么等待释放这个元素的缓存锁，直到fastcgi_cache_lock_timeout指令设置的时间到达。

fastcgi_cache_lock_timeout

• 语法： fastcgi_cache_lock_timeout time;
• 默认： fastcgi_cache_lock_timeout 5s;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 为fastcgi_cache_lock设置超时，当time过期时，请求将被传递到FastCGI服务器，但是响应将不会被缓存。

fastcgi_cache_lock_age

• 语法： fastcgi_cache_lock_age time;
• 默认： fastcgi_cache_lock_age 5s;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 如果上次传递给FastCGI服务器用于填充新缓存元素的请求在指定的时间内没有完成，那么可能会再传递一个请求给FastCGI服务器。

fastcgi_cache_revalidate

• 语法： fastcgi_cache_revalidate on|off;
• 默认： fastcgi_cache_revalidate off;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 允许使用带有"If-Modified-Since"和"If-None-Match"头字段的条件请求重新验证过期的缓存项。

fastcgi_cache_background_update

• 语法： fastcgi_cache_background_update on|off;
• 默认： fastcgi_cache_background_update off;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 允许启动后台子请求来更新过期的缓存项，同时将过期的缓存响应返回给客户端。注意，有必要允许在更新时使用陈旧的缓存响应。

fastcgi_temp_path

• 语法： fastcgi_temp_path path [level1 [level2 [level3]]];
• 默认： fastcgi_temp_path fastcgi_temp;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 定义一个目录用于存储从FastCGI服务器接收到的数据的临时文件，最多可在指定目录下使用三层子目录层次结构。

  # 对于以下配置，临时文件可能为：/usr/local/nginx/fastcgi_temp/7/45/00000123457
  http {
  	fastcgi_temp_path /usr/local/nginx/fastcgi_temp 1 2;
  }
  

fastcgi_max_temp_file_size

• 语法： fastcgi_max_temp_file_size size;
• 参数说明：
  • size – 为0时表示禁止使用临时文件来缓冲响应信息
• 默认： fastcgi_max_temp_file_size 1024m;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 当缓存来自FastCGI服务器的响应是启用的，并且整个响应不适合fastcgi_buffer_size和fastcgi_buffers指令设置的缓冲区，响应的一部分可以保存到一个临时文件。这个指令设置的就是这个临时文件的最大大小。每次写入临时文件的数据大小由fastcgi_temp_file_write_size指令设置。

fastcgi_temp_file_write_size

• 语法： fastcgi_temp_file_write_size size;
• 默认： fastcgi_temp_file_write_size 8k|16k;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 当FastCGI服务器的响应缓存到临时文件时，限制一次写入到临时文件的数据的大小。默认情况下，大小受fastcgi_buffer_size和fastcgi_buffers指令设置的两个缓冲区的限制。临时文件的最大大小是由fastcgi_max_temp_file_size指令设置的。

fastcgi_next_upstream

• 语法： fastcgi_next_upstream error|timeout|invalid_header|http_500|http_503|http_403|http_404|http_429|non_idempotent|off …;
• 参数说明：
  • error – 表示与服务器建立连接、向其传递请求或读取响应头时发生错误
  • timeout – 表示与服务器建立连接、向其传递请求或读取响应标头时发生超时
  • invalid_header – 表示服务器返回空或无效的响应
  • http_500 – 表示服务器返回响应码为500的响应
  • http_503 – 表示服务器返回响应码为503的响应
  • http_403 – 表示服务器返回响应码为403的响应
  • http_404 – 表示服务器返回响应码为404的响应
  • http_429 – 表示服务器返回响应码为429的响应
  • non_idempotent – 通常，如果请求已发送到上游服务器，则使用“非幂等”方法(POST, LOCK, PATCH)的请求不会传递到下一个服务器，显式启用该参数允许重试此类请求
  • off – 表示禁止将请求传递到下一个服务器
• 默认： fastcgi_next_upstream error timeout;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 指定在何种情况下应将请求传递给下一个服务器。

fastcgi_next_upstream_tries

• 语法： fastcgi_next_upstream_tries number;
• 默认： fastcgi_next_upstream_tries 0;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 限制请求传递到下一个服务器的可能尝试次数，number为0时表示关闭此限制。

fastcgi_next_upstream_timeout

• 语法： fastcgi_next_upstream_timeout time;
• 默认： fastcgi_next_upstream_timeout 0;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 限制请求传递到下一个服务器的时间，time为0时表示关闭此限制。

fastcgi_param

• 语法： fastcgi_param parameter value [if_not_empty];
• 默认： —
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 设置一个应该传递给FastCGI服务器的参数，该值可以包含文本、变量或者它们的组合。当且仅当当前级别没有定义fastcgi_param指令时，这些指令从上一个配置级别继承。

fastcgi_pass_header

• 语法： fastcgi_pass_header field;
• 默认： —
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 允许从FastCGI服务器向客户端传递禁用的报头字段。

fastcgi_hide_header

• 语法： fastcgi_hide_header field;
• 默认： —
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 默认情况下，Nginx不从FastCGI服务器传递拥有头字段"Status"和"X-Accel-…"的响应到客户端。fastcgi_hide_header指令设置了其他不会被传递的字段。相反，如果需要允许传递字段，可以使用fastcgi_pass_header指令。

fastcgi_ignore_headers

• 语法： fastcgi_ignore_headers field [field …];
• 默认： —
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 禁止处理FastCGI服务器的某些响应报头字段，以下字段可以忽略:“X-Accel-Expires”、“X-Accel-Redirect”、“X-Accel-Limit-Rate”、“X-Accel-Buffering”、“X-Accel-Charset”、“Expires”、“Cache-Control”、“Set-Cookie"和"Vary”。如果未禁用，则处理这些报头字段具有以下效果：
  1. “X-Accel-Expires”、“Expires”、“Cache-Control”、“Set-Cookie”、"Vary"设置响应缓存的参数；
  2. "X-Accel-Redirect"执行到指定URI的内部重定向；
  3. "X-Accel-Limit-Rate"设置传输响应给客户端的速率限制；
  4. "X-Accel-Buffering"启用或禁用响应缓冲；
  5. "X-Accel-Charset"设置响应所需字符集。

fastcgi_catch_stderr

• 语法： fastcgi_catch_stderr string;
• 默认： —
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 设置要在从FastCGI服务器收到的响应的错误流中搜索的字符串。如果string找到，则认为FastCGI服务器返回了无效响应，这允许在Nginx中处理应用程序错误。

  http {
  	server {
  		location /php/ {
  			fastcgi_pass backend:9000;
  			...
  			fastcgi_catch_stderr "PHP Fatal error";
  			fastcgi_next_upstream error timeout invalid_header;
  		}
  	}
  }
  

fastcgi_keep_conn

• 语法： fastcgi_keep_conn on|off;
• 默认： —
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 设置要在从FastCGI服务器收到的响应的错误流中搜索的字符串。如果string找到，则认为FastCGI服务器返回了无效响应，这允许在Nginx中处理应用程序错误。

  http {
  	server {
  		location /php/ {
  			fastcgi_pass backend:9000;
  			...
  			fastcgi_catch_stderr "PHP Fatal error";
  			fastcgi_next_upstream error timeout invalid_header;
  		}
  	}
  }
  

2.3.14、ngx_http_flv_module模块

要使用该模块需要在构建Nginx时加上配置选项： –with-http_flv_module

flv

• 语法： flv;
• 默认： —
• 上下文： http块中的location块
• 说明： 该模块为Flash视频（FLV格式文件）提供伪流服务器端支持。可以在请求URI的查询字段中特别地使用start参数去处理请求，Nginx会根据请求字节偏移量start去发送文件特定位置的内容（带有前置FLV头）。

2.3.15、ngx_http_geoip_module模块

要使用该模块需要在构建Nginx时加上配置选项： –with-http_geoip_module
该模块需要 MaxMind GeoIP 库的支持

geoip_country

• 语法： geoip_country file;
• 默认： —
• 上下文： http块
• 说明： 指定用于根据客户端IP地址确定国家的数据库。使用此数据库时可用以下变量：
  1. $geoip_country_code：两个字母的国家/地区代码，例如"RU"、“US”
  2. $geoip_country_code3：三个字母的国家/地区代码，例如"RUS"、“USA”
  3. $geoip_country_name：国家名称，例如"Russian Federation"、“United States”

geoip_org

• 语法： geoip_org file;
• 默认： —
• 上下文： http块
• 说明： 指定用于根据客户端 IP 地址确定组织的数据库。使用此数据库时可用以下变量：
  1. $geoip_org：组织名称，例如"The University of Melbourne"

geoip_city

• 语法： geoip_city file;
• 默认： —
• 上下文： http块
• 说明： 指定用于根据客户端IP地址确定国家、地区和城市的数据库。使用此数据库时可用以下变量：
  1. $geoip_city_continent_code：两个字母的大陆代码，例如"EU"、“NA”
  2. $geoip_city_country_code：两个字母的国家/地区代码，例如"RU"、“US”
  3. $geoip_city_country_code3：三个字母的国家/地区代码，例如"RUS"、“USA”
  4. $geoip_city_country_name：国家名称，例如"Russian Federation"、“United States”
  5. $geoip_dma_code：根据Google AdWords API中的地理定位
  6. $geoip_latitude：纬度
  7. $geoip_longitude：经度
  8. $geoip_region：双符号国家/地区代码（地区、领土、州、省、联邦土地等），例如"48"、“DC”
  9. $geoip_region_name：国家/地区名称（地区、领地、州、省、联邦土地等），例如"Moscow City"、“District of Columbia”
  10. $geoip_city：城市名称，例如"Moscow"、“Washington”
  11. $geoip_postal_code：邮政编码

geoip_proxy

• 语法： geoip_proxy address|CIDR;
• 默认： —
• 上下文： http块
• 说明： 定义可信地址，当请求来自可信地址时，将使用"X-Forwarded-For"请求头字段中的地址。

geoip_proxy_recursive

• 语法： geoip_proxy_recursive on|off;
• 默认： geoip_proxy_recursive off;
• 上下文： http块
• 说明： 如果递归搜索被禁用，则将使用"X-Forwarded-For"中发送的最后一个地址，而不是匹配受信任地址之一的原始客户端地址。如果启用了递归搜索，则将使用"X-Forwarded-For"中发送的最后一个非信任地址，而不是匹配受信任地址之一的原始客户端地址。

  http {
  	geoip_country GeoIP.dat;
  	geoip_city GeoLiteCity.dat;
  	geoip_proxy 192.168.100.0/24;
  	geoip_proxy 2001:0db8::/32;
  	geoip_proxy_recursive on;
  	...
  }
  

2.3.16、ngx_http_geo_module模块

geo

• 语法： geo [$address] $variable {…}
• 默认： —
• 上下文： http块
• 说明： 根据客户端IP地址创建具有值的变量。

2.3.17、ngx_http_grpc_module模块

该模块依赖于ngx_http_v2_module模块

grpc_pass

• 语法： grpc_pass address;
• 默认： —
• 上下文： http块中的location块、http块中的location块中的if块
• 说明： 设置gRPC服务器地址，地址可以指定为域名或IP地址，也可以是UNIX域套接字。

  http {
  	server {
  		location / {
  			grpc_pass localhost:9000;
  			grpc_pass unix:/tmp/grpc.socket;
  			grpc_pass grpc://127.0.0.1:9000;
  			grpc_pass grpcs://127.0.0.1:443;
  		}
  	}
  }
  

grpc_bind

• 语法： grpc_bind address [transparent]|off;
• 参数说明：
  • address – 表示IP地址，可以包含变量
  • transparent – 表示允许从非本地IP地址发起到gRPC服务器的连接
  • off – 表示取消了grpc_bind指令从上一个配置级别继承的影响，它允许系统自动分配本地IP地址和端口
• 默认： —
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 从指定的带有可选端口的本地IP地址向gRPC服务器发起连接。

  http {
  	grpc_bind $remote_addr transparent;
  }
  

grpc_socket_keepalive

• 语法： grpc_socket_keepalive on|off;
• 默认： grpc_socket_keepalive off;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 为发送到gRPC服务器的连接配置"TCP keepalive"选项。默认情况下，操作系统的设置对套接字有效，如果该指令的值被设置为"on"，则该套接字的SO_KEEPALIVE选项将被打开。

grpc_connect_timeout

• 语法： grpc_connect_timeout time;
• 默认： grpc_connect_timeout 60s;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 定义与gRPC服务器建立连接的超时时间。需要注意的是，这个超时时间通常不能超过75秒。

grpc_send_timeout

• 语法： grpc_send_timeout time;
• 默认： grpc_send_timeout 60s;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 设置将请求传输到gRPC服务器的超时时间。这里指的是在两次连续写入操作之间间隔，而不是针对整个请求的传输。如果gRPC服务器在此时间内没有收到任何消息，则连接关闭。

grpc_intercept_errors

• 语法： grpc_intercept_errors on|off;
• 默认： grpc_intercept_errors off;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 确定是否应该将响应码大于或等于300的gRPC服务器响应传递给客户端，或者拦截并重定向到Nginx以使用error_page指令进行处理。

grpc_buffer_size

• 语法： grpc_buffer_size size;
• 默认： grpc_buffer_size 4k|8k;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 设置用于读取从gRPC服务器接收到的响应的缓冲区大小。一旦接收到响应，就同步地将其传递给客户机。

grpc_read_timeout

• 语法： grpc_read_timeout time;
• 默认： grpc_read_timeout 60s;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 定义从gRPC服务器读取响应的超时时间。这里指的是在两次连续读取操作之间间隔，而不是针对整个响应的传输。如果gRPC服务器在此时间内没有传输任何内容，则连接关闭。

grpc_next_upstream

• 语法： grpc_next_upstream error|timeout|invalid_header|http_500|http_502|http_503|http_504|http_403|http_404|http_429|non_idempotent|off …;
• 参数说明：
  • error – 表示与服务器建立连接、向其传递请求或读取响应头时发生错误
  • timeout – 表示与服务器建立连接、向其传递请求或读取响应标头时发生超时
  • invalid_header – 表示服务器返回空或无效的响应
  • http_500 – 表示服务器返回响应码为500的响应
  • http_502 – 表示服务器返回响应码为502的响应
  • http_503 – 表示服务器返回响应码为503的响应
  • http_504 – 表示服务器返回响应码为504的响应
  • http_403 – 表示服务器返回响应码为403的响应
  • http_404 – 表示服务器返回响应码为404的响应
  • http_429 – 表示服务器返回响应码为429的响应
  • non_idempotent – 通常，如果请求已发送到上游服务器，则使用“非幂等”方法(POST, LOCK, PATCH)的请求不会传递到下一个服务器，显式启用该参数允许重试此类请求
  • off – 表示禁止将请求传递到下一个服务器
• 默认： grpc_next_upstream error timeout;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 指定在哪些情况下应将请求传递到下一个服务器。

grpc_next_upstream_tries

• 语法： grpc_next_upstream_tries number;
• 默认： grpc_next_upstream_tries 0;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 限制将请求传递到下一个服务器的可能尝试次数，number为0时表示关闭此限制。

grpc_next_upstream_timeout

• 语法： grpc_next_upstream_timeout time;
• 默认： grpc_next_upstream_timeout 0;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 限制请求传递到下一个服务器的时间，time为0时表示关闭此限制。

grpc_set_header

• 语法： grpc_set_header field value;
• 默认： grpc_set_header Content-Length $content_length;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 允许在传递给gRPC服务器的请求头中重新定义或附加字段，该值可以包含文本、变量或者它们的组合。当且仅当当前级别没有定义grpc_set_header指令时，这些指令从上一个配置级别继承。如果标头字段的值为空字符串，则该字段将不会传递给gRPC服务器。

  http {
  	# 以下示例表示"Accept-Encoding"字段不会传递给gRPC服务器
  	grpc_set_header Accept-Encoding "";
  }
  

grpc_pass_header

• 语法： grpc_pass_header field;
• 默认： —
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 允许从gRPC服务器向客户端传递禁用的报头字段。

grpc_hide_header

• 语法： grpc_hide_header field;
• 默认： —
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 默认情况下，Nginx不从gRPC服务器传递拥有头字段"Date"、" Server"和"X-Accel-…"的响应到客户端。grpc_hide_header指令设置了其他不会被传递的字段。相反，如果需要允许字段的传递，则可以使用grpc_pass_header指令。

grpc_ignore_headers

• 语法： grpc_ignore_headers field [field …];
• 默认： —
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 禁止处理gRPC服务器的某些响应报头字段。以下字段可以忽略:“X-Accel-Redirect"和"X-Accel-Charset”。如果未禁用，则处理这些报头字段的效果如下:
  1. "X-Accel-Redirect"执行到指定URI的内部重定向；
  2. "X-Accel-Charset"设置响应所需字符集。

grpc_ssl_session_reuse

• 语法： grpc_ssl_session_reuse on|off;
• 默认： grpc_ssl_session_reuse on;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 确定在使用gRPC服务器时SSL会话是否可以重用。如果日志中出现错误"SSL3_GET_FINISHED:digest check failed"，请尝试禁用会话重用。

grpc_ssl_protocols

• 语法： grpc_ssl_protocols [SSLv2] [SSLv3] [TLSv1] [TLSv1.1] [TLSv1.2] [TLSv1.3];
• 默认： grpc_ssl_protocols TLSv1 TLSv1.1 TLSv1.2;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 为gRPC SSL服务器的请求启用指定的协议。

grpc_ssl_ciphers

• 语法： grpc_ssl_ciphers ciphers;
• 默认： grpc_ssl_ciphers DEFAULT;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 指定向gRPC SSL服务器请求时启用的密码，密码以OpenSSL库能够理解的格式指定。可以使用"openssl ciphers"命令查看完整列表。

grpc_ssl_name

• 语法： grpc_ssl_name name;
• 默认： grpc_ssl_name host from grpc_pass;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 允许覆盖用于验证gRPC SSL服务器的证书并在与gRPC SSL服务器建立连接时通过SNI传递的服务器名称。默认情况下，使用来自grpc_pass的主机部分。

grpc_ssl_server_name

• 语法： grpc_ssl_server_name on|off;
• 默认： grpc_ssl_server_name off;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 在与gRPC SSL服务器建立连接时，启用或禁用通过TLS服务器名称指示扩展（SNI，RFC 6066）传递服务器名称。

grpc_ssl_verify

• 语法： grpc_ssl_verify on|off;
• 默认： grpc_ssl_verify off;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 启用或禁用gRPC SSL服务器证书的验证。

grpc_ssl_verify_depth

• 语法： grpc_ssl_verify_depth number;
• 默认： grpc_ssl_verify_depth 1;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 设置gRPC SSL服务器证书链中的验证深度。

grpc_ssl_trusted_certificate

• 语法： grpc_ssl_trusted_certificate file;
• 默认： —
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 指定一个PEM格式的受信任CA证书用于验证gRPC SSL服务器的证书。

grpc_ssl_crl

• 语法： grpc_ssl_crl file;
• 默认： —
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 指定一个PEM格式的撤销证书(CRL)用于验证gRPC SSL服务器的证书。

grpc_ssl_certificate

• 语法： grpc_ssl_certificate file;
• 默认： —
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 指定一个PEM格式的证书用于验证gRPC SSL服务器的证书。

grpc_ssl_certificate_key

• 语法： grpc_ssl_certificate_key file;
• 默认： —
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 指定一个PEM格式的带密钥的证书用于验证gRPC SSL服务器的证书。可以指定值engine:name:id代替文件，它从OpenSSL engine name中加载具有指定id的密钥。

grpc_ssl_password_file

• 语法： grpc_ssl_password_file file;
• 默认： —
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 指定一个带有密钥密码短语的文件，其中每个密码短语在单独的行上指定，在加载密钥时依次尝试密码短语。

2.3.18、ngx_http_gunzip_filter_module模块

要使用该模块需要在构建Nginx时加上配置选项： –with-http_gunzip_filter_module

gunzip

• 语法： gunzip on|off;
• 默认： gunzip off;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 为缺乏gzip支持的客户端启用或禁用gzip响应的解压缩。如果启用，在确定客户端是否支持gzip时也会考虑以下指令：gzip_http_version、gzip_proxy和gzip_disable。

gunzip_buffers

• 语法： gunzip_buffers number size;
• 默认： gunzip_buffers 32 4k|16 8k;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 设置用于解压缩响应的缓冲区的数量和大小。默认情况下，缓冲区大小等于一页内存，有可能是4K或8K，具体取决于平台。

2.3.19、ngx_http_gzip_filter_module模块

gzip

• 语法： gzip on|off;
• 默认： gzip off;
• 上下文： http块、http块中的server块、http块中的location块、http块中的location块中的if块
• 说明： 启用或禁用对响应信息的压缩。

gzip_buffers

• 语法： gzip_buffers number size;
• 默认： gzip_buffers 32 4k|16 8k;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 设置用于压缩响应信息的缓冲区的数量和大小。默认情况下，缓冲区大小等于一页内存，有可能是4K或8K，具体取决于平台。

gzip_types

• 语法： gzip_types mime-type [mime-type …];
• 默认： gzip_types text/html;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 允许自行指定对MIME类型的响应信息进行压缩，特殊值"*"表示匹配任何MIME类型，"text/html"类型的响应信息总是被压缩的。

gzip_comp_level

• 语法： gzip_comp_level 1|2|3|4|5|6|7|8|9;
• 默认： gzip_comp_level 1;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 设置响应信息的压缩级别，取值范围为1~9。

gzip_window

• 语法： gzip_window 512|1k|2k|4k|8k|16k|32k;
• 默认： gzip_window 32k;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 设置deflateInit2函数的windowBits参数，事实上该参数更多的作用是压缩模式选择，默认的32k参数代表的就是压缩为gzip格式。

gzip_hash

• 语法： gzip_hash 512|1k|2k|4k|8k|16k|32k|64k|128k;
• 默认： gzip_hash 32k|64k;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 设置压缩过程中的内存限制。默认值有可能是32k或64k，具体取决于平台。

postpone_gzipping

• 语法： postpone_gzipping size;
• 默认： postpone_gzipping 0;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 在开始压缩前定义一个最小压缩数据门槛。

gzip_no_buffer

• 语法： gzip_no_buffer on|off;
• 默认： gzip_no_buffer off;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 默认情况下，在将数据发送到客户端之前Nginx会等待，直到至少一个缓存被数据填满，如果开启该指令，就会禁用缓存。

gzip_min_length

• 语法： gzip_min_length length;
• 默认： gzip_min_length 20;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 设置将被压缩的响应信息的最小长度，长度仅从"Content-Length"字段确定。

2.3.20、ngx_http_gzip_static_module模块

要使用该模块需要在构建Nginx时加上配置选项： –with-http_gzip_static_module

gzip_static

• 语法： gzip_static on|off|always;
• 参数说明：
  • on – 表示会检查预压缩文件是否存在
  • off – 表示进制发送预压缩文件
  • always – 表示表示在始终认为预压缩文件存在，如果磁盘上没有未压缩的文件，或者使用了ngx_http_gunzip_module模块，这将非常有用
• 默认： gzip_static off;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 该模块允许发送带有".gz"文件扩展名的预压缩文件。

2.3.21、ngx_http_headers_filter_module模块

expires

• 语法： expires [modified] time;
  ????expires epoch|max|off;
• 参数说明：
  • modified – “Expires"字段中的时间为当前时间和指令中指定的时间的总和，如果使用了该参数，那么时间计算为文件的修改时间和指令中指定的时间的总和。另外，可以使用”@"前缀指定一天中的某个时间，比如：expires @15h30m；
  • time – 该参数可以是正或负的值，“Cache-Control"字段的内容取决于指定时间的符号：如果time为负则设置为"Cache-Control: no-cache”，如果time为正或零则设置为"Cache-Control: max-age= t"，其中t是指令中指定的时间，以秒为单位
  • epoch – 表示将"Expires"的值设置为"Thu, 01 Jan 1970 00:00:01 GMT"，将"Cache-Control"的值设置为"no-cache"
  • max – 表示将"Expires"的值设置为"Thu, 31 Dec 2037 23:55:55 GMT"，将"Cache-Control"的值设置为10年
  • off – 表示禁止添加或修改响应头的"Expires"和"Cache-Control"字段
• 默认： expires off;
• 上下文： http块、http块中的server块、http块中的location块、http块中的location块中的if块
• 说明： 如果响应代码等于200、201, 204, 206, 301, 302, 303, 304, 307或308时，则启用或禁用添加或修改响应头的"Expires"和"Cache-Control"字段。

add_header

• 语法： add_header name value [always];
• 默认： —
• 上下文： http块、http块中的server块、http块中的location块、http块中的location块中的if块
• 说明： 如果响应代码等于200、201、204、206、301、302、303、304、307或 308，则将指定字段添加到响应头，参数值可以包含变量。可以设置多个add_header指令，当且仅当add_header当前级别上没有定义任何指令时，这些指令才从先前的配置级别继承。如果指定了参数always，则无论响应代码如何，都将添加标头字段。

add_trailer

• 语法： add_trailer name value [always];
• 默认： —
• 上下文： http块、http块中的server块、http块中的location块、http块中的location块中的if块
• 说明： 如果响应代码等于200、201、206、301、302、303、307或308，则将指定字段添加到响应的末尾，参数值可以包含变量。可以设置多个add_trailer指令，当且仅当add_trailer当前级别上没有定义任何指令时，这些指令才从先前的配置级别继承。如果指定了参数always，则无论响应代码如何，都将添加指定的字段。

2.3.22、ngx_http_image_filter_module模块

要使用该模块需要在构建Nginx时加上配置选项： –with-http_image_filter_module
该模块需要 libgd 库的支持

image_filter

• 语法： image_filter off;
  ????image_filter test;
  ????image_filter size;
  ????image_filter rotate 90|180|270;
  ????image_filter resize width height;
  ????image_filter crop width height;
• 参数说明：
  • off – 表示关闭当前层级改模块的处理
  • test – 表示确保响应是JPEG、GIF、PNG或WebP格式的图像，否则将返回415（Unsupported Media Type）错误
  • size – 表示以JSON格式输出有关图像的信息
  • rotate 90|180|270 – 表示按指定的度数逆时针旋转图像，参数值可以包含变量
  • resize width height – 表示按比例将图像缩小到指定的大小，如果仅想要减少一个维度，可以将另一个维度指定为"-"，如果出现错误，服务器将返回代码415（Unsupported Media Type），参数值可以包含变量，当与rotate参数一起使用时，resize将会更早被调用
  • crop width height – 表示按比例将图像缩小到较大的一侧，并在另一侧裁剪无关的边缘，如果仅想要减少一个维度，可以将另一个维度指定为"-"，如果出现错误，服务器将返回代码415（Unsupported Media Type），参数值可以包含变量，当与rotate参数一起使用时，旋转发生在减少之前
• 默认： image_filter off;
• 上下文： http块中的location块
• 说明： 设置要对图像执行的转换类型。

image_filter_jpeg_quality

• 语法： image_filter_jpeg_quality quality;
• 默认： image_filter_jpeg_quality 75;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 设置转换后的JPEG图像的质量，取值范围为1~100。较小的值通常意味着较低的图像质量和更少的数据传输，建议最大值为95，参数值可以包含变量。

image_filter_webp_quality

• 语法： image_filter_webp_quality quality;
• 默认： image_filter_webp_quality 80;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 设置转换后的WebP图像的质量，取值范围为1~100。较小的值通常意味着较低的图像质量和更少的数据传输，参数值可以包含变量。

image_filter_sharpen

• 语法： image_filter_sharpen percent;
• 默认： image_filter_sharpen 0;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 增加最终图像的清晰度，锐度百分比可超过100，零值表示禁用锐化，参数值可以包含变量。

image_filter_transparency

• 语法： image_filter_transparency on|off;
• 默认： image_filter_transparency on;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 定义在使用调色板指定的颜色转换GIF图像或PNG图像时是否应保留透明度，透明度的损失导致图像质量更好，始终保留PNG图像中的Alpha通道透明度。

image_filter_interlace

• 语法： image_filter_interlace on|off;
• 默认： image_filter_interlace off;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 如果启用，最终图像将交错，对于JPEG图像，最终将采用"渐进式 JPEG"格式。

image_filter_buffer

• 语法： image_filter_buffer size;
• 默认： image_filter_buffer 1m;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 设置用于读取图像的缓冲区的最大大小，当超过大小时，服务器返回错误415（Unsupported Media Type）。

2.3.23、ngx_http_index_module模块

index

• 语法： index file [file …];
• 默认： index index.html;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 定义将用作索引的文件，参数file可以包含变量。按照指定的顺序检查文件，列表的最后一个元素可以是具有绝对路径的文件。需要注意的是，使用索引文件会导致内部重定向，并且可以在不同的位置处理请求。

  # 下面的例子中，"/"的请求首先会判断/data/www/index.html是否存在，如果不，
  # 则接着判断/data/www/index.php，如果/data/www/index.php存在，则使用/index.php
  # 发起内部重定向，就像客户端再一次发起请求一样，Nginx会再一次搜索路径，
  # 这样毫无疑问会匹配到第二个 ~ \.php$，从而最终访问的是 /data/www/test/index.php
  http {
  	server {
  		location / {
  			root /data/www;
  			index index.html index.php;
  		}
  
  		location ~ \.php$ {
  			root /data/www/test;
  		}
  	}
  }
  

2.3.24、ngx_http_limit_conn_module模块

limit_conn_zone

• 语法： limit_conn_zone $variable zone=name:size;
• 默认： —
• 上下文： http块
• 说明： 设定保存各个键的状态的共享内存空间的参数，键的状态中保存了当前连接数，键的值可以是特定变量的任何非空值（空值将不会被考虑）。

  http {
  	limit_conn_zone $binary_remote_addr zone=addr:10m;
  }
  

limit_conn

• 语法： limit_conn zone number;
• 默认： —
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 为给定的键值设置共享内存区域和最大允许连接数。当超过此限制时，服务器将返回错误信息以响应请求。

  # 以下示例表示每个IP地址一次只允许一个连接
  http {
  	limit_conn_zone $binary_remote_addr zone=addr:10m;
  	
  	server {
  		location /download/ {
  			limit_conn addr 1;
  		}
  	}
  }
  

limit_conn_log_level

• 语法： limit_conn_log_level info|notice|warn|error;
• 默认： limit_conn_log_level error;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 为服务器限制连接数的情况设置所需的日志记录级别。

limit_conn_status

• 语法： limit_conn_status code;
• 默认： limit_conn_status 503;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 设置状态代码以响应被拒绝的请求。

limit_conn_dry_run

• 语法： limit_conn_dry_run on|off;
• 默认： limit_conn_dry_run off;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 启用试运行模式。在这种模式下，连接数没有限制，但是在共享内存区，过多的连接数照常计算。

2.3.25、ngx_http_limit_req_module模块

limit_req_zone

• 语法： limit_req_zone key zone=name:size rate=rate [sync];
• 默认： —
• 上下文： http块
• 说明： 为共享内存区域设置参数，该区域将保持各种键的状态。特别是，状态存储了当前的过度请求数。该key可以包含文本，变量或者它们的的组合。不考虑具有空键值的请求。

  http {
  	limit_req_zone $binary_remote_addr zone=one:10m rate=1r/s;
  }
  

limit_req

• 语法： limit_req zone zone=name [burst=number] [nodelay|delay=number];
• 默认： —
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 设置共享内存区域和请求的最大突发大小。如果请求速率超过为区域配置的速率，则它们的处理将被延迟，以便以定义的速率处理请求。过多的请求会被延迟，直到它们的数量超过最大突发大小，在这种情况下，请求会因错误而终止。默认情况下，最大突发大小为零。

limit_req_log_level

• 语法： limit_req_log_level info|notice|warn|error;
• 默认： limit_req_log_level error;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 当服务器由于速率超过或延迟请求处理而拒绝处理请求时，设置所需的日志记录级别。延迟的记录级别比拒绝低一分；例如，如果limit_req_log_level notice指定了""，则延迟与info级别一起记录。

limit_req_status

• 语法： limit_req_status code;
• 默认： limit_req_status 503;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 设置状态代码以响应被拒绝的请求。

limit_req_dry_run

• 语法： limit_req_dry_run on|off;
• 默认： limit_req_dry_run off;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 启用试运行模式。在这种模式下，请求处理速率不受限制，但是在共享内存区域中，过度请求的数量照常计算。

2.3.26、ngx_http_log_module模块

log_format

• 语法： log_format name [escape=default|json|none] string [string …];
• 参数说明：
  • escape – 表示设置为json或默认字符转义，默认情况下，使用默认转义
  • default – 对于默认转义，字符"、字符\ 和其它值小于32或大于126的字符将被转义为\xXX，如果没有找到变量值，将记录为连接字符（-）
  • json – 对于json转义，json字符串中不允许出现的所有字符将被转义，比如说字符"和字符\将被转义为\"和\\，值小于32的字符转义为\n、\r、\t、\b、\f或\u00XX
  • none – 表示禁用转义
• 默认： log_format combined “…”;
• 上下文： http块
• 说明： 指定日志格式。日志格式可以包含公共变量，以及仅在日志写入时存在的变量：
  1. $bytes_sent：发送到客户端的字节数
  2. $connection：连接序列号
  3. $connection_requests：当前通过连接发出的请求数
  4. $msec：日志写入时以秒为单位，以毫秒为分辨率的时间
  5. $pipe：值为"p"表示请求被流水线化，否则值为"."
  6. $request_length：请求长度（包括请求行、头部和请求正文）
  7. $request_time：请求处理时间(以秒为单位，以毫秒为分辨率)，从客户端读取第一个字节到最后一个字节发送给客户端后写入日志之间的时间经过
  8. $status：响应状态
  9. $time_iso8601：ISO 8601标准格式的当地时间
  10. $time_local：通用日志格式的本地时间

  http {
  	# 配置始终包含预定义的"combined"格式，如下：
  	log_format combined '$remote_addr - $remote_user [$time_local] '
  						'"$request" $status $body_bytes_sent '
  						'"$http_referer" "$http_user_agent"';
  }
  

access_log

• 语法： access_log path [format [buffer=size] [gzip[=level]] [flush=time] [if=condition]];
  ????access_log off;
• 参数说明：
  • path – 表示文件路径，可以通过指定"syslog:"前缀来将日志写入到syslog
  • format – 表示指定日志格式，日志格式由log_format指令设置，如果没有指定格式，则使用预定义的"combined"格式
  • buffer – 表示设置缓冲区的大小，使用该参数后日志将被写到缓冲区，启用缓冲后，以下三种情况将导致数据被写入文件：如果下一个日志行不适合缓冲区；如果缓冲数据的时间超过了flush参数指定的时间；当工作进程重新打开日志文件或关闭时
  • gzip – 表示设置压缩的等级，取值范围为1~9，使用该参数后日志将被写到缓冲区
  • flush – 表示缓冲数据的最大时间
  • if – 表示是否启用条件日志记录，如果条件计算结果为"0"或空字符串，则不会记录请求
  • off – 表示取消当前级别上的所有access_log指令
• 默认： access_log logs/access.log combined;
• 上下文： http块、http块中的server块、http块中的location块、http块中的location块中的if块、http块中的limit_except块
• 说明： 设置缓冲日志写入的路径、格式和配置，可以在同一配置级别上指定多个日志。

  # 在下面的示例中，响应码为2xx和3xx的请求将不被记录
  http {
  	map $status $loggable {
  		~^[23]  0;
  		default 1;
  	}
  
  	access_log /path/to/access.log combined if=$loggable;
  }
  

open_log_file_cache

• 语法： open_log_file_cache max=N [inactive=time] [min_uses=N] [valid=time];
  ????open_log_file_cache off;
• 参数说明：
  • max – 表示缓存中描述符的最大数量，如果缓存已满，则关闭最近最少使用的描述符(LRU)
  • inactive – 表示如果在此期间没有访问，则设置关闭缓存描述符，缺省值是10秒
  • min_uses – 表示在inactive参数定义的时间内文件使用的最小数量，以让描述符在缓存中保持打开状态，默认情况下为1
  • valid – 表示检查文件名是否仍然存在的时间，缺省为60秒
  • off – 表示禁用缓存
• 默认： open_log_file_cache off;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 定义一个缓存，用于存储名称包含变量的常用日志的文件描述符。

  http {
  	open_log_file_cache max=1000 inactive=20s valid=1m min_uses=2;
  }
  

2.3.27、ngx_http_map_module模块

map

• 语法： map string $variable { … };
• 默认： —
• 上下文： http块
• 说明： 创建一个新变量，其值取决于第一个参数中指定的一个或多个源变量的值。

  # 在下面的示例中，当响应码为2xx和3xx时，$loggable的值为0，其它情况下$loggable的值为1
  http {
  	map $status $loggable {
  		~^[23]  0;
  		default 1;
  	}
  }
  

map_hash_max_size

• 语法： map_hash_max_size size;
• 默认： map_hash_max_size 2048;
• 上下文： http块
• 说明： 设置映射变量哈希表的最大容量。

map_hash_bucket_size

• 语法： map_hash_bucket_size size;
• 默认： map_hash_bucket_size 32|64|128;
• 上下文： http块
• 说明： 设置映射变量哈希桶的容量。

2.3.28、ngx_http_memcached_module模块

memcached_pass

• 语法： memcached_pass address;
• 默认： —
• 上下文： http块中的location块、http块中的location块中的if块
• 说明： 设置缓存服务器的地址，地址可以指定为域名或IP地址，也可以是UNIX域套接字。

  http {
  	server {
  		location / {
  			memcached_pass localhost:8888;
  			memcached_pass unix:/tmp/memcached.socket;
  		}
  	}
  }
  

memcached_bind

• 语法： memcached_bind address [transparent ]|off;
• 参数说明：
  • address – 表示IP地址，可以包含变量
  • transparent – 表示允许从非本地IP地址发起与缓存服务器的连接
  • off – 表示取消了memcached_bind指令从上一个配置级别继承的影响，它允许系统自动分配本地IP地址和端口
• 默认： —
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 从指定的带有可选端口的本地IP地址向缓存服务器发起连接。

  http {
  	memcached_bind $remote_addr transparent;
  }
  

memcached_socket_keepalive

• 语法： memcached_socket_keepalive on|off;
• 默认： memcached_socket_keepalive off;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 为发送到缓存服务器的连接配置"TCP keepalive"行为。默认情况下，操作系统的设置对套接字有效，如果该指令的值被设置为"on"，则该套接字的SO_KEEPALIVE选项将被打开。

memcached_connect_timeout

• 语法： memcached_connect_timeout time;
• 默认： memcached_connect_timeout 60s;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 定义与缓存服务器建立连接的超时时间。需要注意的是，这个超时时间通常不能超过75秒。

memcached_send_timeout

• 语法： memcached_send_timeout time;
• 默认： memcached_send_timeout 60s;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 设置将请求传输到缓存服务器的超时时间。这里指的是在两次连续写入操作之间间隔，而不是针对整个请求的传输。如果缓存服务器在此时间内没有收到任何消息，则连接关闭。

memcached_buffer_size

• 语法： memcached_buffer_size size;
• 默认： memcached_buffer_size 4k|8k;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 设置用于读取从缓存服务器接收到的响应的缓冲区大小。一旦接收到响应，就同步地将其传递给客户机。

memcached_read_timeout

• 语法： memcached_read_timeout time;
• 默认： memcached_read_timeout 60s;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 定义从缓存服务器读取响应的超时时间。这里指的是在两次连续读取操作之间间隔，而不是针对整个响应的传输。如果缓存服务器在此时间内没有传输任何内容，则连接关闭。

memcached_next_upstream

• 语法： grpc_next_upstream error|timeout|invalid_response|not_found|off …;
• 参数说明：
  • error – 表示与服务器建立连接、向服务器传递请求或读取响应头时发生错误
  • timeout – 表示与服务器建立连接、向服务器传递请求或读取响应头时发生超时
  • invalid_response – 表示服务器返回空或无效的响应
  • not_found – 表示在服务器上找不到响应
  • off – 表示禁止将请求传递到下一个服务器
• 默认： grpc_next_upstream error timeout;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 指定在哪些情况下应将请求传递到下一个服务器。

memcached_next_upstream_tries

• 语法： memcached_next_upstream_tries number;
• 默认： memcached_next_upstream_tries 0;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 限制将请求传递到下一个服务器的可能尝试次数，number为0时表示关闭此限制。

memcached_next_upstream_timeout

• 语法： memcached_next_upstream_timeout time;
• 默认： memcached_next_upstream_timeout 0;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 限制请求传递到下一个服务器的时间，time为0时表示关闭此限制。

memcached_gzip_flag

• 语法： memcached_gzip_flag flag;
• 默认： —
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 如果缓存服务器响应中存在flag标志，则将"Content-Encoding"响应头字段的值设置为"gzip"。

2.3.29、ngx_http_mirror_module模块

mirror

• 语法： mirror uri|off;
• 默认： mirror off;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 将原始请求拷贝到的指定的uri去，可以在相同的配置级别上指定多个镜像。

mirror_request_body

• 语法： mirror_request_body on|off;
• 默认： mirror_request_body on;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 指示是否拷贝客户端的请求正文，启用后，将在创建镜像子请求之前读取客户端请求正文。在这种情况下，由proxy_request_buffering、fastcgi_request_buffering、scgi_request_buffering和uwsgi_request_buffering指令设置的未缓冲的客户端请求正文代理将被禁用。

  http {
  	server {
  		location / {
  			mirror /mirror;
  			proxy_pass http://backend;
  		}
  
  		location = /mirror {
  			internal;
  			proxy_pass http://test_backend$request_uri;
  		}
  	}
  }
  

2.3.30、ngx_http_mp4_module模块

要使用该模块需要在构建Nginx时加上配置选项： –with-http_mp4_module

mp4

• 语法： mp4;
• 默认： —
• 上下文： http块中的location块
• 说明： 该模块为MP4格式文件提供伪流服务器端支持，这些文件通常具有.mp4、.m4v或.m4a的文件扩展名。

mp4_buffer_size

• 语法： mp4_buffer_size size;
• 默认： mp4_buffer_size 512K;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 设置用于处理MP4格式文件的缓冲区的初始大小。

mp4_max_buffer_size

• 语法： mp4_max_buffer_size size;
• 默认： mp4_max_buffer_size 10M;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 在元数据处理期间，可能需要一个更大的缓冲区，它的大小不能超过该配置指令指定的大小，否则Nginx将返回500(Internal Server Error)错误，并记录以下日志。

  "/home/src/111.mp4" mp4 moov atom is too large:
  12583268, you may want to increase mp4_max_buffer_size
  

2.3.31、ngx_http_perl_module模块

要使用该模块需要在构建Nginx时加上配置选项： –with-http_perl_module
改模块需要 Perl 5.6.1 或更高版本，C编译器应该与用于构建Perl的编译器兼容

perl_modules

• 语法： perl_modules path;
• 默认： —
• 上下文： http块
• 说明： 为Perl模块设置附加路径。

perl_require

• 语法： perl_require module;
• 默认： —
• 上下文： http块
• 说明： 定义将在每次重新配置期间加载的模块的名称，同一级别可以存在多个perl_require指令。

perl

• 语法： perl module::function|‘sub {…}’;
• 默认： —
• 上下文： http块中的location块、http块中的limit_except块
• 说明： 设置Perl处理程序。

perl_set

• 语法： perl_set $variable module::function|‘sub {…}’;
• 默认： —
• 上下文： http块
• 说明： 为指定的变量设置Perl处理程序。

2.3.32、ngx_http_proxy_module模块

proxy_pass

• 语法： proxy_pass uri;
• 默认： —
• 上下文： http块中的location块、http块中的location块中的if块、http块中的limit_except块
• 说明： 设置代理服务器的协议和地址以及应映射到的URI，可以指定"http"或"https"，地址可以指定为域名或IP地址，也可以是UNIX域套接字。如果域名解析为多个地址，则所有地址都将以循环方式使用，此外，可以将地址指定为服务器组。

  http {
  	server {
  		location / {
  			proxy_pass http://localhost:8000/uri/;
  			proxy_pass http://unix:/tmp/backend.socket:/uri/;
  		}
  	}
  }
  

proxy_redirect

• 语法： proxy_redirect default|off;
  ????proxy_redirect redirect replacement;
• 参数说明：
  • default – 表示默认使用location指令和proxy_pass指令的参数进行替换，如果proxy_pass使用了变量，则不允许使用该参数
  • off – 表示取消了proxy_redirect指令从上一个配置级别继承的影响
  • redirect – 表示需要被替换的字符串
  • replacement – 表示替换后的字符串
• 默认： proxy_redirect default;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 设置应在代理服务器响应的“Location”和“Refresh”标头字段中更改的值，同一级别可以存在多个proxy_redirect指令。

  假设代理服务器返回标头字段"Location: http://localhost:8000/two/some/uri/"，则以下指令
  proxy_redirect http://localhost:8000/two/ http://frontend/one/;
  会将此字符串重写为"Location: http://frontend/one/some/uri/"。
  
  服务器名可以在替换字符串中省略，如下：
  proxy_redirect http://localhost:8000/two/ /;
  
  default参数表示默认使用location指令和proxy_pass指令的参数进行替换。因此，以下两种配置是等价的:
  location /one/ { 
  	proxy_pass http://upstream:port/two/; 
  	proxy_redirect default；
  }
  
  location /one/ { 
  	proxy_pass http://upstream:port/two/; 
  	proxy_redirect http://upstream:port/two/ /one/;
  
  redirect 和 replacement 都允许包含变量，如下：
  proxy_redirect http://localhost:8000/ http://$host:$server_port/;
  proxy_redirect http://$proxy_host:8000/ /;
  
  可以使用正则表达式指定该指令，在这种情况下，redirect应该以“ ~”符号开头以进行区分大小写的匹配，
  或者以“ ~*”符号开头以进行不区分大小写的匹配。正则表达式可以包含命名和位置捕获，并且replacement可以引用它们：
  proxy_redirect ~^(http://[^:]+):\d+(/.+)$ $1$2;
  proxy_redirect ~*/user/([^/]+)/(.+)$ http://$1.example.com/$2;
  

proxy_cookie_domain

• 语法： proxy_cookie_domain off;
  ????proxy_cookie_domain domain replacement;
• 参数说明：
  • off – 表示取消了proxy_cookie_domain指令从上一个配置级别继承的影响
  • domain – 表示需要被替换的domain字段的属性
  • replacement – 表示替换后的字符串
• 默认： proxy_cookie_domain off;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 设置应在代理服务器响应的"Set-Cookie"报头字段的domain字段中更改的值，同一级别可以存在多个proxy_cookie_domain指令。如果可以对cookie应用多个指令，则将选择第一个匹配的指令。

  假设代理服务器返回的"Set-Cookie"头字段的值为"domain=localhost"，该指令
  proxy_cookie_domain localhost example.org;
  将此属性重写为"domain=example.org"
  
  domain和replacement可以包含变量，示例如下：
  proxy_cookie_domain www.$host $host;
  
  也可以使用正则表达式指定该指令，在这种情况下，domain应从“ ~”符号开始。正则表达式可以包含命名和位置捕获，并且replacement可以引用它们，示例如下：
  proxy_cookie_domain ~\.(?P<sl_domain>[-0-9a-z]+\.[az]+)$ $sl_domain;
  

proxy_cookie_path

• 语法： proxy_cookie_path off;
  ????proxy_cookie_path path replacement;
• 参数说明：
  • off – 表示取消了proxy_cookie_path指令从上一个配置级别继承的影响
  • path – 表示字段的属性
  • replacement – 表示替换后的字符串
• 默认： proxy_cookie_path off;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 设置应在代理服务器响应的"Set-Cookie"报头字段的path字段中更改的值，同一级别可以存在多个proxy_cookie_path指令。如果可以对cookie应用多个指令，则将选择第一个匹配的指令。

  假设代理服务器返回的的"Set-Cookie"头字段的值为"path=/two/some/uri/"，该指令
  proxy_cookie_path /two/ /;
  将此属性重写为"path=/some/uri/"
  
  path和replacement可以包含变量，示例如下：
  proxy_cookie_path $uri /some$uri;
  
  也可以使用正则表达式指定该指令，在这种情况下，path应该从“ ~”符号开始进行区分大小写的匹配，或者从“ ~*”符号开始进行不区分大小写的匹配。正则表达式可以包含命名和位置捕获，并且replacement可以引用它们：
  proxy_cookie_path ~*^/user/([^/]+) /u/$1;
  

proxy_store

• 语法： proxy_store on|off|string;
• 参数说明：
  • on – 表示将文件保存到alias或root对应的路径
  • off – 表示禁止保存文件
  • string – 表示显式地设置文件名，文件名可以使用变量来代替
• 默认： proxy_store off;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 启用将文件保存到磁盘。

proxy_store_access

• 语法： proxy_store_access users:permissions [users:permissions …];
• 默认： proxy_store_access user:rw;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 为新创建的文件和目录设置访问权限。

  http {
  	server {
  		location ~ ^(.+\.php)(.*)$ {
  			...
  			# 正常设置权限
  			proxy_store_access user:rw group:rw all:r;
  			# 如果指定了任意group或all访问权限，则user可以省略权限
  			proxy_store_access group:rw all:r;
  		}
  	}
  }
  

proxy_buffering

• 语法： proxy_buffering on|off;
• 默认： proxy_buffering on;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 启用或禁用来自代理服务器的响应缓冲。启用缓冲后，Nginx会尽快收到来自代理服务器的响应，将其保存到由proxy_buffer_size和proxy_buffers指令设置的缓冲区中。如果整个响应过大，可以将其中的一部分保存到磁盘上的临时文件中。写入临时文件由proxy_max_temp_file_size和 proxy_temp_file_write_size指令控制。当缓冲被禁用时，响应会在收到时立即同步传递给客户端。Mginx不会尝试从代理服务器读取整个响应。Nginx一次可以从服务器接收的最大数据大小由proxy_buffer_size指令设置。也可以通过在"X-Accel-Buffering"响应头字段中传递"yes"或"no"来启用或禁用缓冲。可以使用proxy_ignore_headers指令禁用此功能。

proxy_request_buffering

• 语法： proxy_request_buffering on|off;
• 默认： proxy_request_buffering on;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 启用或禁用客户端请求正文的缓冲。启用缓冲后，在将请求发送到代理服务器之前，将从客户端读取整个请求正文。当缓存被禁用时，请求正文在收到时立即被发送到代理服务器。在这种情况下，如果Nginx已经开始发送请求正文，请求就不能被传递到下一个服务器。当使用HTTP/1.1分块传输编码发送原始请求正文时，请求正文将被缓冲，而不管该指令的值，除非HTTP/1.1启用代理。

proxy_ignore_client_abort

• 语法： proxy_ignore_client_abort on|off;
• 默认： proxy_ignore_client_abort off;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 确定当客户端在不等待响应的情况下关闭连接时，是否应关闭与代理服务器的连接。

proxy_bind

• 语法： proxy_bind address [transparent];
  ????proxy_bind off;
• 参数说明：
  • address – 表示IP地址，可以包含变量
  • transparent – 表示允许从非本地IP地址发起与代理服务器的连接
  • off – 表示取消了proxy_bind指令从上一个配置级别继承的影响，它允许系统自动分配本地IP地址和端口
• 默认： —
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 从指定的带有可选端口的本地IP地址向代理服务器发起连接。

  http {
  	proxy_bind $remote_addr transparent;
  }
  

proxy_socket_keepalive

• 语法： proxy_socket_keepalive on|off;
• 默认： proxy_socket_keepalive off;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 为发送到代理服务器的连接配置"TCP keepalive"行为。默认情况下，操作系统的设置对套接字有效，如果该指令的值被设置为"on"，则该套接字的SO_KEEPALIVE选项将被打开。

proxy_connect_timeout

• 语法： proxy_connect_timeout time;
• 默认： proxy_connect_timeout 60s;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 定义与代理服务器建立连接的超时时间。需要注意的是，这个超时时间通常不能超过75秒。

proxy_send_timeout

• 语法： proxy_send_timeout time;
• 默认： proxy_send_timeout 60s;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 设置将请求传输到代理服务器的超时时间。这里指的是在两次连续写入操作之间间隔，而不是针对整个请求的传输。如果缓存服务器在此时间内没有收到任何消息，则连接关闭。

proxy_send_lowat

• 语法： proxy_send_lowat size;
• 默认： proxy_send_lowat 0;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 该指令在Linux上无效。

proxy_intercept_errors

• 语法： proxy_intercept_errors on|off;
• 默认： proxy_intercept_errors off;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 确定是否应该将响应码大于或等于300的代理服务器响应传递给客户端，或者拦截并重定向到Nginx以使用error_page指令进行处理。

proxy_set_header

• 语法： proxy_set_header field value;
• 默认： proxy_set_header Host $proxy_host;
  ????proxy_set_header Connection close;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 允许在传递给代理服务器的请求头中重新定义或附加字段，该值可以包含文本、变量或者它们的组合。当且仅当当前级别没有定义proxy_set_header指令时，这些指令从上一个配置级别继承。默认情况下，只有两个字段被重新定义。如果启用缓存，原始请求的报头字段"If-Modified-Since"、“If-Unmodified-Since”、“If-None-Match”、“If-Match”、"Range"和"If-Range"不会被传递到代理服务器。如果标头字段的值为空字符串，则该字段将不会传递给gRPC服务器。

  http {
  	# 一个未修改的"Host"请求报头字段可以像这样传递：
  	proxy_set_header Host       $http_host;
  	
  	# 在这种情况下，最好使用$host变量——它的值等于"Host"请求头字段中的服务器名，如果该字段不存在，则等于主服务器名:
  	proxy_set_header Host       $host;
  	
  	# 另外，服务器名可以和代理服务器的端口一起传递：
  	proxy_set_header Host       $host:$proxy_port;
  	
  	# 以下示例表示"Accept-Encoding"字段不会传递给代理服务器
  	grpc_set_header Accept-Encoding "";
  }
  

proxy_headers_hash_max_size

• 语法： proxy_headers_hash_max_size size;
• 默认： proxy_headers_hash_max_size 512;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 设置proxy_hide_header和proxy_set_header指令所使用的哈希表的最大容量。

proxy_headers_hash_bucket_size

• 语法： proxy_headers_hash_bucket_size size;
• 默认： proxy_headers_hash_bucket_size 64;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 设置proxy_hide_header和proxy_set_header指令所使用的哈希桶的容量。

proxy_set_body

• 语法： proxy_set_body value;
• 默认： —
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 允许重新定义传递给代理服务器的请求正文，该值可以包含文本、变量或者它们的组合。

proxy_method

• 语法： proxy_method method;
• 默认： —
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 指定在转发到代理服务器的请求中使用的HTTP方法，而不是使用来自客户端请求的方法，参数值可以包含变量。

proxy_pass_request_headers

• 语法： proxy_pass_request_headers on|off;
• 默认： proxy_pass_request_headers on;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 指示是否将原始请求的报头字段传递给代理服务器。

proxy_pass_request_body

• 语法： proxy_pass_request_body on|off;
• 默认： proxy_pass_request_body on;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 指示是否将原始请求正文信息传递给代理服务器。

proxy_buffer_size

• 语法： proxy_buffer_size size;
• 默认： proxy_buffer_size 4k|8k;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 设置用于读取从代理服务器接收的响应的第一部分的缓冲区的大小，这部分通常包含一个小的响应头。默认情况下，缓冲区大小等于一页内存，有可能是4K或8K，具体取决于平台。

proxy_read_timeout

• 语法： proxy_read_timeout time;
• 默认： proxy_read_timeout 60s;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 定义从代理服务器读取响应的超时时间。这里指的是在两次连续读取操作之间间隔，而不是针对整个响应的传输。如果缓存服务器在此时间内没有传输任何内容，则连接关闭。

proxy_buffers

• 语法： proxy_buffers number size;
• 默认： proxy_buffers 8 4k|8k;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 为单个连接设置用于从代理服务器读取响应的缓冲区的数量和大小。默认情况下，缓冲区大小等于一页内存，有可能是4K或8K，具体取决于平台。

proxy_busy_buffers_size

• 语法： proxy_busy_buffers_size size;
• 默认： proxy_busy_buffers_size 8k|16k;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 当启用了对来自代理服务器的响应的缓存时，该指令可以限制缓冲区的总大小，可以是正忙于发送到客户端的响应，而响应还没有完全读取。同时，其余的缓冲区可用于读取响应，如果需要，还可以缓冲对临时文件的部分响应。默认情况下，大小受proxy_buffer_size和proxy_buffers两个缓冲区大小的限制。

proxy_force_ranges

• 语法： proxy_force_ranges on|off;
• 默认： proxy_force_ranges off;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 无论这些响应中的"Accept-Ranges"字段如何，都为来自代理服务器的缓存和未缓存响应启用字节范围支持。

proxy_limit_rate

• 语法： proxy_limit_rate rate;
• 参数说明：
  • rate – 为0时表示不限速
• 默认： proxy_limit_rate 0;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 限制从代理服务器读取响应的速度。该限制是针对每个请求设置的，因此如果Nginx同时打开两个到代理服务器的连接，则总体速率将是指定限制的两倍。仅当启用了代理服务器的响应缓冲时，此限制才有效。

proxy_cache

• 语法： proxy_cache zone|off;
• 参数说明：
  • zone – 可以包含变量，表示缓存的区域
  • off – 表示禁用从先前配置级别继承缓存信息
• 默认： proxy_cache off
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 定义用于缓存的共享内存区域，同一个区域可以在多个地方使用。

proxy_cache_key

• 语法： proxy_cache_key string;
• 默认： proxy_cache_key $scheme$proxy_host$request_uri;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 定义一个用于缓存的键。

proxy_cache_path

• 语法： 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];
• 默认： —
• 上下文： http块
• 说明： 设置缓存的路径和其他参数，缓存数据存储在文件中，缓存中的文件名是对缓存键使用MD5函数生成的结果。

proxy_cache_bypass

• 语法： proxy_cache_bypass string [string …];
• 默认： —
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 定义不从缓存中获取响应的条件，如果字符串参数中至少有一个值不为空且不等于"0"，则不会从缓存中获取响应。

  http {
  	proxy_cache_bypass $cookie_nocache $arg_nocache$arg_comment;
  	proxy_cache_bypass $http_pragma    $http_authorization;
  }
  

proxy_no_cache

• 语法： proxy_no_cache string [string …];
• 默认： —
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 定义不将响应保存到缓存的条件，如果字符串参数中至少有一个值不为空且不等于"0"，则不会保存响应。

  http {
  	proxy_no_cache $cookie_nocache $arg_nocache$arg_comment;
  	proxy_no_cache $http_pragma    $http_authorization;
  }
  

proxy_cache_valid

• 语法： proxy_cache_valid [code …] time;
• 默认： —
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 为不同的响应码设置缓存时间。

  http {
  	# 为响应码200和302的响应信息设置10分钟的缓存
  	proxy_cache_valid 200 302 10m;
  	# 为响应码404的响应信息设置1分钟的缓存
  	proxy_cache_valid 404 1m;
  	
  	# 如果没有指定响应码，则只有200、301和302响应被缓存。
  	proxy_cache_valid 5m;
  	
  	# 可以指定any参数来表示缓存任何响应
  	proxy_cache_valid any 1m;
  }
  

proxy_cache_min_uses

• 语法： proxy_cache_min_uses number;
• 默认： proxy_cache_min_uses 1;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 设置一个请求数，当超过该请求数之后将缓存响应。

proxy_cache_max_range_offset

• 语法： proxy_cache_max_range_offset number;
• 默认： —
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 设置字节范围请求的字节偏移量，如果范围超出了偏移量，范围请求将被传递到代理服务器，而响应将不会被缓存。

proxy_cache_use_stale

• 语法： proxy_cache_use_stale error|timeout|invalid_header|updating|http_500|http_502|http_503|http_504|http_403|http_404|http_429|off …;
• 默认： proxy_cache_use_stale off;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 确定在何种情况下可以在与代理服务器通信时使用过时的缓存响应，该指令的形参与proxy_next_upstream指令的形参匹配。此外，如果当前正在更新缓存响应，则更新参数允许使用过时的响应，这允许在更新缓存数据时最小化对代理服务器的访问数量。也可以在响应失效后在响应头中直接启用过期缓存响应，这比使用指令参数具有更低的优先级。"Cache-Control"报头字段的"stale-while-revalidate"扩展允许在当前正在更新的情况下使用陈旧的缓存响应，"Cache-Control"报头字段的"stale-if-error"扩展允许在出现错误时使用陈旧的缓存响应。当填充一个新的缓存元素时，为了最小化对代理服务器的访问次数，可以使用proxy_cache_lock指令。

proxy_cache_methods

• 语法： proxy_cache_methods GET|HEAD|POST [GET|HEAD|POST …];
• 默认： proxy_cache_methods GET HEAD;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 如果此指令中列出了客户端请求方法，则响应将被缓存。GET和HEAD方法始终添加到列表中，但建议明确指定它们。

proxy_cache_lock

• 语法： proxy_cache_lock on|off;
• 默认： proxy_cache_lock off;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 当启用时，一次只允许一个请求填充一个新的缓存元素，根据proxy_cache_key指令，通过传递一个请求到代理服务器。对同一个缓存元素的其它请求要么等待响应出现在缓存中，要么等待释放这个元素的缓存锁，直到proxy_cache_lock_timeout指令设置的时间到达。

proxy_cache_lock_timeout

• 语法： proxy_cache_lock_timeout time;
• 默认： proxy_cache_lock_timeout 5s;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 为proxy_cache_lock设置超时，当time过期时，请求将被传递到代理服务器，但是响应将不会被缓存。

proxy_cache_lock_age

• 语法： proxy_cache_lock_age time;
• 默认： proxy_cache_lock_age 5s;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 如果上次传递给代理服务器用于填充新缓存元素的请求在指定的时间内没有完成，那么可能会再传递一个请求给代理服务器。

proxy_cache_revalidate

• 语法： proxy_cache_revalidate on|off;
• 默认： proxy_cache_revalidate off;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 允许使用带有"If-Modified-Since"和"If-None-Match"头字段的条件请求重新验证过期的缓存项。

proxy_cache_convert_head

• 语法： proxy_cache_convert_head on|off;
• 默认： proxy_cache_convert_head on;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 启用或禁用"HEAD"方法到"GET"方法的缓存转换。当转换被禁用时，缓存键应该被配置为包含 $request_method 。

proxy_cache_background_update

• 语法： proxy_cache_background_update on|off;
• 默认： proxy_cache_background_update off;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 允许启动后台子请求来更新过期的缓存项，同时将过期的缓存响应返回给客户端。注意，有必要允许在更新时使用陈旧的缓存响应。

proxy_temp_path

• 语法： proxy_temp_path path [level1 [level2 [level3]]];
• 默认： proxy_temp_path proxy_temp;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 定义一个目录用于存储从代理服务器接收到的数据的临时文件，最多可在指定目录下使用三层子目录层次结构。

  # 对于以下配置，临时文件可能为：/usr/local/nginx/proxy_temp/7/45/00000123457
  http {
  	proxy_temp_path /usr/local/nginx/proxy_temp 1 2;
  }
  

proxy_max_temp_file_size

• 语法： proxy_max_temp_file_size size;
• 参数说明：
  • size – 为0时表示禁止使用临时文件来缓冲响应信息
• 默认： proxy_max_temp_file_size 1024m;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 当缓存来自代理服务器的响应是启用的，并且整个响应不适合proxy_buffer_size和proxy_buffers指令设置的缓冲区，响应的一部分可以保存到一个临时文件。这个指令设置的就是这个临时文件的最大大小。每次写入临时文件的数据大小由proxy_temp_file_write_size指令设置。

proxy_temp_file_write_size

• 语法： proxy_temp_file_write_size size;
• 默认： proxy_temp_file_write_size 8k|16k;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 当代理服务器的响应缓存到临时文件时，限制一次写入到临时文件的数据的大小。默认情况下，大小受proxy_buffer_size和proxy_buffers指令设置的两个缓冲区的限制。临时文件的最大大小是由proxy_max_temp_file_size指令设置的。

proxy_next_upstream

• 语法： proxy_next_upstream error|timeout|invalid_header|http_500|http_502|http_503|http_504|http_403|http_404|http_429|non_idempotent|off …;
• 参数说明：
  • error – 表示与服务器建立连接、向其传递请求或读取响应头时发生错误
  • timeout – 表示与服务器建立连接、向其传递请求或读取响应标头时发生超时
  • invalid_header – 表示服务器返回空或无效的响应
  • http_500 – 表示服务器返回响应码为500的响应
  • http_502 – 表示服务器返回响应码为502的响应
  • http_503 – 表示服务器返回响应码为503的响应
  • http_504 – 表示服务器返回响应码为504的响应
  • http_403 – 表示服务器返回响应码为403的响应
  • http_404 – 表示服务器返回响应码为404的响应
  • http_429 – 表示服务器返回响应码为429的响应
  • non_idempotent – 通常，如果请求已发送到上游服务器，则使用“非幂等”方法( POST, LOCK, PATCH)的请求不会传递到下一个服务器，显式启用该参数允许重试此类请求
  • off – 表示禁止将请求传递到下一个服务器
• 默认： fastcgi_next_upstream error timeout;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 指定在何种情况下应将请求传递给下一个服务器。

proxy_next_upstream_tries

• 语法： proxy_next_upstream_tries number;
• 默认： proxy_next_upstream_tries 0;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 限制请求传递到下一个服务器的可能尝试次数，number为0时表示关闭此限制。

proxy_next_upstream_timeout

• 语法： proxy_next_upstream_timeout time;
• 默认： proxy_next_upstream_timeout 0;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 限制请求传递到下一个服务器的时间，time为0时表示关闭此限制。

proxy_pass_header

• 语法： proxy_pass_header field;
• 默认： —
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 允许从代理服务器向客户端传递禁用的报头字段。

proxy_hide_header

• 语法： proxy_hide_header field;
• 默认： —
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 默认情况下，Nginx不从代理服务器传递拥有头字段"Date"、“Server”、"X-Pad"和"X-Accel-…"的响应到客户端。proxy_hide_header指令设置了其他不会被传递的字段。相反，如果需要允许字段的传递，则可以使用proxy_pass_header指令。

proxy_ignore_headers

• 语法： proxy_ignore_headers field [field …];
• 默认： —
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 禁止处理代理服务器的某些响应报头字段，以下字段可以忽略:“X-Accel-Expires”、“X-Accel-Redirect”、“X-Accel-Limit-Rate”、“X-Accel-Buffering”、“X-Accel-Charset”、“Expires”、“Cache-Control”、“Set-Cookie"和"Vary”。如果未禁用，则处理这些报头字段具有以下效果：
  1. “X-Accel-Expires”、“Expires”、“Cache-Control”、“Set-Cookie”、"Vary"设置响应缓存的参数
  2. "X-Accel-Redirect"执行到指定URI的内部重定向
  3. "X-Accel-Limit-Rate"设置传输响应给客户端的速率限制
  4. "X-Accel-Buffering"启用或禁用响应缓冲
  5. "X-Accel-Charset"设置响应所需字符集

proxy_http_version

• 语法： proxy_http_version 1.0|1.1;
• 默认： proxy_http_version 1.0;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 默认情况下，使用1.0版本。

proxy_ssl_session_reuse

• 语法： proxy_ssl_session_reuse on|off;
• 默认： proxy_ssl_session_reuse on;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 确定在使用代理服务器时SSL会话是否可以重用。如果日志中出现错误"SSL3_GET_FINISHED:digest check failed"，请尝试禁用会话重用。

proxy_ssl_protocols

• 语法： proxy_ssl_protocols [SSLv2] [SSLv3] [TLSv1] [TLSv1.1] [TLSv1.2] [TLSv1.3];
• 默认： proxy_ssl_protocols TLSv1 TLSv1.1 TLSv1.2;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 为代理HTTPS服务器的请求启用指定的协议。

proxy_ssl_ciphers

• 语法： proxy_ssl_ciphers ciphers;
• 默认： proxy_ssl_ciphers DEFAULT;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 指定向代理HTTPS服务器请求时的启用密码，密码以OpenSSL库能够理解的格式指定。可以使用"openssl ciphers"命令查看完整列表。

proxy_ssl_name

• 语法： proxy_ssl_name name;
• 默认： proxy_ssl_name $proxy_host;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 允许覆盖用于验证代理HTTPS服务器的证书的服务器名，并在与代理HTTPS服务器建立连接时通过SNI传递。默认情况下，使用proxy_pass URL的主机部分。

proxy_ssl_server_name

• 语法： proxy_ssl_server_name on|off;
• 默认： proxy_ssl_server_name off;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 在与代理HTTPS服务器建立连接时，启用或禁用通过TLS服务器名指示扩展(SNI, RFC 6066)传递服务器名称。

proxy_ssl_verify

• 语法： proxy_ssl_verify on|off;
• 默认： proxy_ssl_verify off;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 启用或禁用对代理HTTPS服务器证书的验证。

proxy_ssl_verify_depth

• 语法： proxy_ssl_verify_depth number;
• 默认： proxy_ssl_verify_depth 1;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 设置代理HTTPS服务器证书链中的验证深度。

proxy_ssl_trusted_certificate

• 语法： proxy_ssl_trusted_certificate file;
• 默认： —
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 指定一个PEM格式的受信任CA证书用于验证代理HTTPS服务器的证书。

proxy_ssl_crl

• 语法： proxy_ssl_crl file;
• 默认： —
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 指定一个PEM格式的撤销证书(CRL)用于验证代理HTTPS服务器的证书。

proxy_ssl_certificate

• 语法： proxy_ssl_certificate file;
• 默认： —
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 指定一个PEM格式的证书用于验证代理HTTPS服务器的证书。

proxy_ssl_certificate_key

• 语法： proxy_ssl_certificate_key file;
• 默认： —
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 指定一个PEM格式的带密钥的证书用于验证代理HTTPS服务器的证书。可以指定值engine:name:id代替文件，它从OpenSSL engine name中加载具有指定id的密钥。

proxy_ssl_password_file

• 语法： proxy_ssl_password_file file;
• 默认： —
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 指定一个带有密钥密码短语的文件，其中每个密码短语在单独的行上指定，在加载密钥时依次尝试密码短语。

2.3.33、ngx_http_random_index_module模块

要使用该模块需要在构建Nginx时加上配置选项： –with-http_random_index_module

random_index

• 语法： random_index on|off;
• 默认： random_index off;
• 上下文： http块中的location块
• 说明： 该模块处理以字符(’/’)结尾的请求，并在目录中随机选取一个文件作为索引文件。该模块处理比ngx_http_index_module模块之前早。

2.3.34、ngx_http_realip_module模块

要使用该模块需要在构建Nginx时加上配置选项： –with-http_realip_module

set_real_ip_from

• 语法： set_real_ip_from address|CIDR|unix:;
• 默认： —
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 定义已知可发送正确替换地址的可信地址，如果指定了特殊值unix:，表示所有unix域套接字都是可信的，可信地址也可以使用主机名来指定。

real_ip_header

• 语法： set_real_ip_from field|X-Real-IP|X-Forwarded-For|proxy_protocol;
• 默认： real_ip_header X-Real-IP;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 定义请求报头字段，其值将用于替换客户端地址，包含可选端口的请求报头字段值也用于替换客户端端口，地址和端口应该根据RFC 3986来指定，proxy_protocol参数将客户端地址更改为来自PROXY协议头的地址，PROXY协议之前必须通过在listen指令中设置proxy_protocol参数来启用。

real_ip_recursive

• 语法： real_ip_recursive on|off;
• 默认： real_ip_recursive off;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 如果禁用递归搜索，与其中一个受信任地址匹配的原始客户端地址将被real_ip_header指令定义的请求报头字段中发送的最后一个地址替换；如果启用了递归搜索，与其中一个可信地址匹配的原始客户端地址将被请求报头字段中发送的最后一个非可信地址替换。

2.3.35、ngx_http_referer_module模块

valid_referers

• 语法： valid_referers none|blocked|server_names|string [none|blocked|server_names|string …];
• 参数说明：
  • none – 表示请求标头中缺少"Referer"字段
  • blocked – 表示请求头中存在"Referer"字段，但其值已被防火墙或代理服务器删除，此类值是不以"http://"或"https://"开头的字符串
  • server_names – 表示"Referer"请求头字段包含服务器名称之一
  • string – 表示定义一个服务器名称和一个可选的URI前缀，服务器名可以在开头或结尾有一个"*"，在检查过程中，"Referer"字段中的服务器端口被忽略
  • regex – 参数也可以使用正则表达式，第一个符号应该是"~"，应该注意的是，表达式将匹配"http://"或"https://"之后的文本
• 默认： —
• 上下文： http块中的server块、http块中的location块
• 说明： 指定"Referer"请求头字段值，这会导致内嵌的 $invalid_referer 变量被设置为空字符串，否则，变量将被设置为"1"。搜索匹配是不区分大小写的。

  http {
  	server {
  		valid_referers none blocked server_names *.example.com example.* www.example.org/galleries/ ~\.google\.;
  	}
  }
  

referer_hash_max_size

• 语法： referer_hash_max_size size;
• 默认： referer_hash_max_size 2048;
• 上下文： http块中的server块、http块中的location块
• 说明： 设置有效引用哈希表的最大容量。

referer_hash_bucket_size

• 语法： referer_hash_bucket_size size;
• 默认： referer_hash_bucket_size 64;
• 上下文： http块中的server块、http块中的location块
• 说明： 设置有效引用哈希桶的容量。

2.3.36、ngx_http_rewrite_module模块

rewrite

• 语法： rewrite regex replacement [flag];
• 参数说明：
  • regex – 表示需匹配的正则表达式
  • replacement – 表示替换后的字符串，可以包含变量
  • flag – 的可选项如下：
    1. last：停止处理当前的ngx_http_rewrite_module指令集，并开始搜索与更改的URI匹配的新位置
    2. break：停止处理当前的ngx_http_rewrite_module指令，就像其它语言的break指令一样
    3. redirect：返回302响应码的临时重定向，如果替换字符串不是以"http://"、"https://“或”$scheme"开头，则使用
    4. permanent：返回一个带有301响应码的永久重定向
• 默认： —
• 上下文： http块中的server块、http块中的server块中的if块、http块中的location块、http块中的location块中的if块
• 说明： 如果指定的正则表达式与请求的URI匹配，URI将按照替换字符串中的指定进行更改。重写指令按照它们在配置文件中出现的顺序依次执行，可以使用标志终止对指令的进一步处理。如果替换字符串以"http://"、"https://“或”$scheme"开头，则停止处理并将重定向返回给客户端。

  http {
  	server {
  		...
  		rewrite ^(/download/.*)/media/(.*)\..*$ $1/mp3/$2.mp3 last;
  		rewrite ^(/download/.*)/audio/(.*)\..*$ $1/mp3/$2.ra  last;
  		return  403;
  		...
  	}
  }
  # 如果上述指令放在URI为"/download/"的location中，last标志应该被替换break，否则Nginx将进行10个循环并返回500错误：
  http {
  	server {
  		location /download/ {
  		rewrite ^(/download/.*)/media/(.*)\..*$ $1/mp3/$2.mp3 break;
  		rewrite ^(/download/.*)/audio/(.*)\..*$ $1/mp3/$2.ra  break;
  		return  403;
  		}
  	}
  }
  
  # 如果replacement字符串包含新的请求参数，则先前的请求参数会附加在它们之后。如果这是不希望的，在替换字符串的末尾放置一个问号可以避免附加它们，例如：
  http {
  	server {
  		...
  		rewrite ^/users/(.*)$ /show?user=$1? last;
  		...
  	}
  }
  
  # 如果正则表达式包含"}"或";"字符，则整个表达式应该用单引号或双引号括起来
  

return

• 语法： return code [text];
  ????return code URL;
  ????return URL;
• 默认： —
• 上下文： http块中的server块、http块中的server块中的if块、http块中的location块、http块中的location块中的if块
• 说明： 停止处理并将指定的返回code给客户端，非标准响应码444关闭连接而不发送响应头。可以指定重定向URL(对于代码301、302、303、307和308)或响应正文文本(对于其他代码)，响应正文文本和重定向URL都可以包含变量。作为一种特殊情况，可以将重定向URL指定为该服务器的本地URI，在这种情况下，完整的重定向URL根据请求方案($scheme)和server_name_in_redirect和port_in_redirect指令形成。另外，一个代码为302的临时重定向URL可以指定为唯一的参数，该参数应以"http://"、"https://“或”$scheme"字符串开头。

break

• 语法： break;
• 默认： —
• 上下文： http块中的server块、http块中的server块中的if块、http块中的location块、http块中的location块中的if块
• 说明： 停止处理当前的ngx_http_rewrite_module指令集。

if

• 语法： if (condition) {…};
• 默认： —
• 上下文： http块中的server块、http块中的location块
• 说明： 计算指定的条件，如果为true，则执行括号内指定的模块指令，请求将在if指令内分配配置，if指令中的配置是从上一个配置级别继承来的。条件可以是以下任何一种：
  1. 变量名，如果变量的值为空字符串或"0"，则为false；
  2. 使用"=“和”!="运算符将变量与字符串进行比较；
  3. 使用"~"（区分大小写匹配）和"~*"（不区分大小写匹配）运算符将变量与正则表达式匹配，正则表达式可以包含可供以后在$1…$9变量中重用的捕获，负运算符"!~“和”!~*“也可用，如果正则表达式包含”}“或”;"字符，则整个表达式应该用单引号或双引号括起来；
  4. 使用"-f"和"!-f"运算符检查文件是否存在；
  5. 使用"-d"和"!-d"运算符检查目录是否存在；
  6. 使用"-e"和"!-e"运算符检查文件、目录或符号链接是否存在；
  7. 使用"-x"和"!-x"运算符检查可执行文件

set

• 语法： set $variable value;
• 默认： —
• 上下文： http块中的server块、http块中的server块中的if块、http块中的location块、http块中的location块中的if块
• 说明： 设置指定变量的值，该值可以包含文本、变量或者它们的组合。

rewrite_log

• 语法： rewrite_log on|off;
• 默认： rewrite_log off;
• 上下文： http块、http块中的server块、http块中的server块中的if块、http块中的location块、http块中的location块中的if块
• 说明： 启用或禁用将ngx_http_rewrite_module模块指令处理结果记录到级别为notice的error_log中。

uninitialized_variable_warn

• 语法： uninitialized_variable_warn on|off;
• 默认： uninitialized_variable_warn on;
• 上下文： http块、http块中的server块、http块中的server块中的if块、http块中的location块、http块中的location块中的if块
• 说明： 控制是否记录有关未初始化变量的警告。

2.3.36、ngx_http_scgi_module模块

scgi_pass

• 语法： scgi_pass address;
• 默认： —
• 上下文： http块中的location块、http块中的location块中的if块
• 说明： 设置SCGI服务器的地址，地址可以指定为域名或IP地址，也可以是UNIX域套接字。如果域名解析为多个地址，则所有地址都将以循环方式使用，此外，可以将地址指定为服务器组。

  http {
  	server {
  		location / {
  			scgi_pass localhost:9000;
  			scgi_pass unix:/tmp/scgi.socket;
  		}
  	}
  }
  

scgi_store

• 语法： scgi_store on|off|string;
• 参数说明：
  • on – 表示将文件保存到alias或root对应的路径
  • off – 表示禁止保存文件
  • string – 表示显式地设置文件名，文件名可以使用变量来代替
• 默认： scgi_store off;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 启用或禁止将文件保存到磁盘。

scgi_store_access

• 语法： scgi_store_access users:permissions [users:permissions …];
• 默认： scgi_store_access user:rw;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 为新创建的文件和目录设置访问权限。

  http {
  	server {
  		location ~ ^(.+\.php)(.*)$ {
  			...
  			# 正常设置权限
  			scgi_store_access user:rw group:rw all:r;
  			# 如果指定了任意group或all访问权限，则user可以省略权限
  			scgi_store_access group:rw all:r;
  		}
  	}
  }
  

scgi_request_buffering

• 语法： scgi_request_buffering on|off;
• 默认： scgi_request_buffering on;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 启用或禁用客户端请求正文的缓冲。启用缓冲后，在将请求发送到SCGI服务器之前，将从客户端读取整个请求正文。当缓冲被禁用时，请求正文在收到时立即发送到SCGI服务器。在这种情况下，如果Nginx已经开始发送请求正文，则请求无法传递到下一个服务器。

scgi_ignore_client_abort

• 语法： scgi_ignore_client_abort on|off;
• 默认： scgi_ignore_client_abort off;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 确定当客户端在不等待响应的情况下关闭连接时，是否应关闭与SCGI服务器的连接。

scgi_bind

• 语法： scgi_bind address [transparent];
  ????scgi_bind off;
• 参数说明：
  • address – 表示IP地址，可以包含变量
  • transparent – 表示允许从非本地IP地址发起与SCGI服务器的连接
  • off – 表示取消了scgi_bind指令从上一个配置级别继承的影响，它允许系统自动分配本地IP地址和端口
• 默认： —
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 从指定的带有可选端口的本地IP地址向SCGI服务器发起连接。

  http {
  	scgi_bind $remote_addr transparent;
  }
  

scgi_socket_keepalive

• 语法： scgi_socket_keepalive on|off;
• 默认： scgi_socket_keepalive off;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 为发送到SCGI服务器的连接配置"TCP keepalive"行为。默认情况下，操作系统的设置对套接字有效，如果该指令的值被设置为"on"，则该套接字的SO_KEEPALIVE选项将被打开。

scgi_connect_timeout

• 语法： scgi_connect_timeout time;
• 默认： scgi_connect_timeout 60s;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 定义与SCGI服务器建立连接的超时时间。需要注意的是，这个超时时间通常不能超过75秒。

scgi_send_timeout

• 语法： scgi_send_timeout time;
• 默认： scgi_send_timeout 60s;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 设置将请求传输到SCGI服务器的超时时间。这里指的是在两次连续写入操作之间间隔，而不是针对整个请求的传输。如果缓存服务器在此时间内没有收到任何消息，则连接关闭。

scgi_buffer_size

• 语法： scgi_buffer_size size;
• 默认： scgi_buffer_size 4k|8k;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 设置用于读取从SCGI服务器接收的响应的第一部分的缓冲区的大小，这部分通常包含一个小的响应头。默认情况下，缓冲区大小等于一页内存，有可能是4K或8K，具体取决于平台。

scgi_pass_request_headers

• 语法： scgi_pass_request_headers on|off;
• 默认： scgi_pass_request_headers on;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 指示是否将原始请求的报头字段传递给SCGI服务器。

scgi_pass_request_body

• 语法： scgi_pass_request_body on|off;
• 默认： scgi_pass_request_body on;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 指示是否将原始请求正文信息传递给SCGI服务器。

scgi_intercept_errors

• 语法： scgi_intercept_errors on|off;
• 默认： scgi_intercept_errors off;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 确定是否应该将响应码大于或等于300的SCGI服务器响应传递给客户端，或者拦截并重定向到Nginx以使用error_page指令进行处理。

scgi_read_timeout

• 语法： scgi_read_timeout time;
• 默认： scgi_read_timeout 60s;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 定义从SCGI服务器读取响应的超时时间。这里指的是在两次连续读取操作之间间隔，而不是针对整个响应的传输。如果SCGI服务器在此时间内没有传输任何内容，则连接关闭。

scgi_buffers

• 语法： scgi_buffers number size;
• 默认： scgi_buffers 8 4k|8k;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 为单个连接设置用于从SCGI服务器读取响应的缓冲区的数量和大小。默认情况下，缓冲区大小等于一页内存，有可能是4K或8K，具体取决于平台。

scgi_busy_buffers_size

• 语法： scgi_busy_buffers_size size;
• 默认： scgi_busy_buffers_size 8k|16k;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 当启用了对来自SCGI服务器的响应的缓存时，该指令可以限制缓冲区的总大小，可以是正忙于发送到客户端的响应，而响应还没有完全读取。同时，其余的缓冲区可用于读取响应，如果需要，还可以缓冲对临时文件的部分响应。默认情况下，大小受scgi_buffer_size和scgi_buffers两个缓冲区大小的限制。

scgi_force_ranges

• 语法： scgi_force_ranges on|off;
• 默认： scgi_force_ranges off;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 无论这些响应中的"Accept-Ranges"字段如何，都为来自SCGI服务器的缓存和未缓存响应启用字节范围支持。

scgi_limit_rate

• 语法： scgi_limit_rate rate;
• 参数说明：
  • rate – 为0时表示不限速
• 默认： scgi_limit_rate 0;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 限制从SCGI服务器读取响应的速度。该限制是针对每个请求设置的，因此如果Nginx同时打开两个到SCGI服务器的连接，则总体速率将是指定限制的两倍。仅当启用了SCGI服务器的响应缓冲时，此限制才有效。

scgi_cache

• 语法： scgi_cache zone|off;
• 参数说明：
  • zone – 表示缓存的区域，可以包含变量
  • off – 表示禁用从先前配置级别继承缓存信息
• 默认： scgi_cache off
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 定义用于缓存的共享内存区域，同一个区域可以在多个地方使用。

scgi_cache_key

• 语法： scgi_cache_key string;
• 默认： —
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 定义一个用于缓存的键。

scgi_cache_path

• 语法： scgi_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];
• 默认： —
• 上下文： http块
• 说明： 设置缓存的路径和其他参数，缓存数据存储在文件中，缓存中的文件名是对缓存键使用MD5函数生成的结果。

scgi_cache_bypass

• 语法： scgi_cache_bypass string [string …];
• 默认： —
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 定义不从缓存中获取响应的条件，如果字符串参数中至少有一个值不为空且不等于"0"，则不会从缓存中获取响应。

  http {
  	scgi_cache_bypass $cookie_nocache $arg_nocache$arg_comment;
  	scgi_cache_bypass $http_pragma    $http_authorization;
  }
  

scgi_no_cache

• 语法： scgi_no_cache string [string …];
• 默认： —
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 定义不将响应保存到缓存的条件，如果字符串参数中至少有一个值不为空且不等于"0"，则不会保存响应。

  http {
  	scgi_no_cache $cookie_nocache $arg_nocache$arg_comment;
  	scgi_no_cache $http_pragma    $http_authorization;
  }
  

scgi_cache_valid

• 语法： scgi_cache_valid [code …] time;
• 默认： —
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 为不同的响应码设置缓存时间。

  http {
  	# 为响应码200和302的响应信息设置10分钟的缓存
  	scgi_cache_valid 200 302 10m;
  	# 为响应码404的响应信息设置1分钟的缓存
  	scgi_cache_valid 404 1m;
  	
  	# 如果没有指定响应码，则只有200、301和302响应被缓存。
  	scgi_cache_valid 5m;
  	
  	# 可以指定any参数来表示缓存任何响应
  	scgi_cache_valid any 1m;
  }
  

scgi_cache_min_uses

• 语法： scgi_cache_min_uses number;
• 默认： scgi_cache_min_uses 1;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 设置一个请求数，当超过该请求数之后将缓存响应。

scgi_cache_max_range_offset

• 语法： scgi_cache_max_range_offset number;
• 默认： —
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 设置字节范围请求的字节偏移量，如果范围超出了偏移量，范围请求将被传递到SCGI服务器，而响应将不会被缓存。

scgi_cache_use_stale

• 语法： scgi_cache_use_stale error|timeout|invalid_header|updating|http_500|http_503|http_403|http_404|http_429|off …;
• 默认： scgi_cache_use_stale off;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 确定在何种情况下可以在与SCGI服务器通信时使用过时的缓存响应，该指令的形参与scgi_next_upstream指令的形参匹配。此外，如果当前正在更新缓存响应，则更新参数允许使用过时的响应，这允许在更新缓存数据时最小化对SCGI服务器的访问数量。也可以在响应失效后在响应头中直接启用过期缓存响应，这比使用指令参数具有更低的优先级。"Cache-Control"报头字段的"stale-while-revalidate"扩展允许在当前正在更新的情况下使用陈旧的缓存响应，"Cache-Control"报头字段的"stale-if-error"扩展允许在出现错误时使用陈旧的缓存响应。当填充一个新的缓存元素时，为了最小化对SCGI服务器的访问次数，可以使用scgi_cache_lock指令。

scgi_cache_methods

• 语法： scgi_cache_methods GET|HEAD|POST [GET|HEAD|POST …];
• 默认： scgi_cache_methods GET HEAD;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 如果此指令中列出了客户端请求方法，则响应将被缓存。GET和HEAD方法始终添加到列表中，但建议明确指定它们。

scgi_cache_lock

• 语法： scgi_cache_lock on|off;
• 默认： scgi_cache_lock off;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 当启用时，一次只允许一个请求填充一个新的缓存元素，根据scgi_cache_key指令，通过传递一个请求到SCGI服务器。对同一个缓存元素的其它请求要么等待响应出现在缓存中，要么等待释放这个元素的缓存锁，直到scgi_cache_lock_timeout指令设置的时间到达。

scgi_cache_lock_timeout

• 语法： scgi_cache_lock_timeout time;
• 默认： scgi_cache_lock_timeout 5s;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 为scgi_cache_lock设置超时，当time过期时，请求将被传递到SCGI服务器，但是响应将不会被缓存。

scgi_cache_lock_age

• 语法： scgi_cache_lock_age time;
• 默认： scgi_cache_lock_age 5s;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 如果上次传递给SCGI服务器用于填充新缓存元素的请求在指定的时间内没有完成，那么可能会再传递一个请求给SCGI服务器。

scgi_cache_revalidate

• 语法： scgi_cache_revalidate on|off;
• 默认： scgi_cache_revalidate off;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 允许使用带有"If-Modified-Since"和"If-None-Match"头字段的条件请求重新验证过期的缓存项。

scgi_cache_background_update

• 语法： scgi_cache_background_update on|off;
• 默认： scgi_cache_background_update off;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 允许启动后台子请求来更新过期的缓存项，同时将过期的缓存响应返回给客户端。注意，有必要允许在更新时使用陈旧的缓存响应。

scgi_temp_path

• 语法： scgi_temp_path path [level1 [level2 [level3]]];
• 默认： scgi_temp_path scgi_temp;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 定义一个目录用于存储从SCGI服务器接收到的数据的临时文件，最多可在指定目录下使用三层子目录层次结构。

  # 对于以下配置，临时文件可能为：/usr/local/nginx/scgi_temp/7/45/00000123457
  http {
  	scgi_temp_path /usr/local/nginx/scgi_temp 1 2;
  }
  

scgi_max_temp_file_size

• 语法： scgi_max_temp_file_size size;
• 参数说明：
  • size – 为0时表示禁止使用临时文件来缓冲响应信息
• 默认： scgi_max_temp_file_size 1024m;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 当缓存来自SCGI服务器的响应是启用的，并且整个响应不适合scgi_buffer_size和scgi_buffers指令设置的缓冲区，响应的一部分可以保存到一个临时文件。这个指令设置的就是这个临时文件的最大大小。每次写入临时文件的数据大小由scgi_temp_file_write_size指令设置。

scgi_temp_file_write_size

• 语法： scgi_temp_file_write_size size;
• 默认： scgi_temp_file_write_size 8k|16k;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 当SCGI服务器的响应缓存到临时文件时，限制一次写入到临时文件的数据的大小。默认情况下，大小受scgi_buffer_size和scgi_buffers指令设置的两个缓冲区的限制。临时文件的最大大小是由scgi_max_temp_file_size指令设置的。

scgi_next_upstream

• 语法： scgi_next_upstream error|timeout|invalid_header|http_500|http_503|http_403|http_404|http_429|non_idempotent|off …;
• 参数说明：
  • error – 表示与服务器建立连接、向其传递请求或读取响应头时发生错误
  • timeout – 表示与服务器建立连接、向其传递请求或读取响应标头时发生超时
  • invalid_header – 表示服务器返回空或无效的响应
  • http_500 – 表示服务器返回响应码为500的响应
  • http_503 – 表示服务器返回响应码为503的响应
  • http_403 – 表示服务器返回响应码为403的响应
  • http_404 – 表示服务器返回响应码为404的响应
  • http_429 – 表示服务器返回响应码为429的响应
  • non_idempotent – 通常，如果请求已发送到上游服务器，则使用“非幂等”方法( POST, LOCK, PATCH)的请求不会传递到下一个服务器，显式启用该参数允许重试此类请求
  • off – 表示禁止将请求传递到下一个服务器
• 默认： scgi_next_upstream error timeout;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 指定在何种情况下应将请求传递给下一个服务器。

scgi_next_upstream_tries

• 语法： scgi_next_upstream_tries number;
• 默认： scgi_next_upstream_tries 0;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 限制请求传递到下一个服务器的可能尝试次数，number为0时表示关闭此限制。

scgi_next_upstream_timeout

• 语法： scgi_next_upstream_timeout time;
• 默认： scgi_next_upstream_timeout 0;
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 限制请求传递到下一个服务器的时间，time为0时表示关闭此限制。

scgi_param

• 语法： scgi_param parameter value [if_not_empty];
• 默认： —
• 上下文： http块、http块中的server块、http块中的location块
• 说明： 设置应该传递给SCGI服务器的参数，该值可以包含文本、变量或者它们的组合，当且仅当当前级别没有定义scgi_param指令时，这些指令从上一个配置级别继承。