模块 ngx_http_uwsgi_module
ngx_http_uwsgi_module
模块允许将请求传递到 uwsgi 服务器。
示例配置
location / { include uwsgi_params; uwsgi_pass localhost:9000; }
指令
语法 |
uwsgi_bind |
---|---|
默认值 | — |
上下文 |
http 、server 、location |
使传出到 uwsgi 服务器的连接源自指定的本地 IP 地址(可选端口,1.11.2)。参数值可以包含变量 (1.3.12)。特殊值 off
(1.3.12) 取消从先前配置级别继承的 uwsgi_bind
指令的效果,这允许系统自动分配本地 IP 地址和端口。
transparent
参数 (1.11.0) 允许传出到 uwsgi 服务器的连接源自非本地 IP 地址,例如,来自客户端的真实 IP 地址。
uwsgi_bind $remote_addr transparent;
为了使此参数生效,通常需要使用 超级用户 权限运行 nginx 工作进程。在 Linux 上则不需要 (1.13.8),因为如果指定了 transparent
参数,工作进程将从主进程继承 CAP_NET_RAW
功能。还需要配置内核路由表以拦截来自 uwsgi 服务器的网络流量。
语法 |
uwsgi_buffer_size |
---|---|
默认值 |
uwsgi_buffer_size 4k|8k; |
上下文 |
http 、server 、location |
设置用于读取从 uwsgi 服务器接收的响应第一部分的缓冲区 大小
。这部分通常包含一个小的响应头。默认情况下,缓冲区大小等于一个内存页。这可能是 4K 或 8K,具体取决于平台。但是,它可以被缩小。
语法 |
uwsgi_buffering |
---|---|
默认值 |
uwsgi_buffering on; |
上下文 |
http 、server 、location |
启用或禁用来自 uwsgi 服务器的响应缓冲。
当启用缓冲时,nginx 会尽快从 uwsgi 服务器接收响应,并将其保存到由 uwsgi_buffer_size 和 uwsgi_buffers 指令设置的缓冲区中。如果整个响应无法放入内存,则其一部分可以保存到磁盘上的 临时文件 中。写入临时文件的操作受 uwsgi_max_temp_file_size 和 uwsgi_temp_file_write_size 指令控制。
当禁用缓冲时,响应将同步传递给客户端,即在接收到时立即传递。nginx 不会尝试从 uwsgi 服务器读取整个响应。nginx 每次最多可以从服务器接收的数据量由 uwsgi_buffer_size 指令设置。
也可以通过在“X-Accel-Buffering”响应头字段中传递“yes
”或“no
”来启用或禁用缓冲。可以使用 uwsgi_ignore_headers 指令禁用此功能。
语法 |
uwsgi_buffers |
---|---|
默认值 |
uwsgi_buffers 8 4k|8k; |
上下文 |
http 、server 、location |
设置用于读取来自 uwsgi 服务器的响应的缓冲区的 数量
和 大小
,适用于单个连接。默认情况下,缓冲区大小等于一个内存页。这可能是 4K 或 8K,具体取决于平台。
语法 |
uwsgi_busy_buffers_size |
---|---|
默认值 |
uwsgi_busy_buffers_size 8k|16k; |
上下文 |
http 、server 、location |
当启用来自 uwsgi 服务器的响应 缓冲 时,限制在响应尚未完全读取时,可以忙于将响应发送到客户端的缓冲区的总 大小
。同时,其余缓冲区可用于读取响应,并在需要时将响应的一部分缓冲到临时文件。默认情况下,大小
受限于由 uwsgi_buffer_size 和 uwsgi_buffers 指令设置的两个缓冲区的大小。
语法 |
uwsgi_cache |
---|---|
默认值 |
uwsgi_cache off; |
上下文 |
http 、server 、location |
定义用于缓存的共享内存区域。同一区域可以在多个位置使用。参数值可以包含变量 (1.7.9)。off
参数禁用从先前配置级别继承的缓存。
语法 |
uwsgi_cache_background_update |
---|---|
默认值 |
uwsgi_cache_background_update off; |
上下文 |
http 、server 、location |
此指令出现在 1.11.10 版本中。
允许启动一个后台子请求来更新过期的缓存项,同时将陈旧的缓存响应返回给客户端。请注意,在更新缓存响应时,需要 允许 使用陈旧的缓存响应。
语法 |
uwsgi_cache_bypass |
---|---|
默认值 | — |
上下文 |
http 、server 、location |
定义不会从缓存中获取响应的条件。如果字符串参数的至少一个值不为空且不等于“0”,则不会从缓存中获取响应。
uwsgi_cache_bypass $cookie_nocache $arg_nocache$arg_comment; uwsgi_cache_bypass $http_pragma $http_authorization;
可以与 uwsgi_no_cache 指令一起使用。
语法 |
uwsgi_cache_key |
---|---|
默认值 | — |
上下文 |
http 、server 、location |
定义缓存的键,例如
uwsgi_cache_key localhost:9000$request_uri;
语法 |
uwsgi_cache_lock |
---|---|
默认值 |
uwsgi_cache_lock off; |
上下文 |
http 、server 、location |
此指令出现在 1.1.12 版本中。
启用后,一次仅允许一个请求通过传递请求到 uwsgi 服务器来填充根据 uwsgi_cache_key 指令标识的新缓存元素。相同缓存元素的其他请求将等待响应出现在缓存中或等待此元素的缓存锁释放,直到 uwsgi_cache_lock_timeout 指令设置的时间到期。
语法 |
uwsgi_cache_lock_age |
---|---|
默认值 |
uwsgi_cache_lock_age 5s; |
上下文 |
http 、server 、location |
此指令出现在 1.7.8 版本中。
如果传递到 uwsgi 服务器以填充新缓存元素的最后一个请求在指定 时间
内未完成,则可能会传递另一个请求到 uwsgi 服务器。
语法 |
uwsgi_cache_lock_timeout |
---|---|
默认值 |
uwsgi_cache_lock_timeout 5s; |
上下文 |
http 、server 、location |
此指令出现在 1.1.12 版本中。
为 uwsgi_cache_lock 设置超时。当 时间
到期时,请求将传递到 uwsgi 服务器,但是响应将不会被缓存。
在 1.7.8 之前,响应可能会被缓存。
语法 |
uwsgi_cache_max_range_offset |
---|---|
默认值 | — |
上下文 |
http 、server 、location |
此指令出现在 1.11.6 版本中。
为字节范围请求设置偏移量(以字节为单位)。如果范围超出偏移量,则范围请求将传递到 uwsgi 服务器,并且响应将不会被缓存。
语法 |
uwsgi_cache_methods |
---|---|
默认值 |
uwsgi_cache_methods GET HEAD; |
上下文 |
http 、server 、location |
如果客户端请求方法在此指令中列出,则响应将被缓存。“GET
”和“HEAD
”方法始终添加到列表中,尽管建议显式指定它们。另请参阅 uwsgi_no_cache 指令。
语法 |
uwsgi_cache_min_uses |
---|---|
默认值 |
uwsgi_cache_min_uses 1; |
上下文 |
http 、server 、location |
设置响应将在多少个请求之后被缓存。
语法 |
uwsgi_cache_path |
---|---|
默认值 | — |
上下文 |
http |
设置缓存的路径和其他参数。缓存数据存储在文件中。缓存中的文件名是将 MD5 函数应用于 缓存键 的结果。levels
参数定义缓存的层次结构级别:从 1 到 3,每个级别接受值 1 或 2。例如,在以下配置中
uwsgi_cache_path /data/nginx/cache levels=1:2 keys_zone=one:10m;
缓存中的文件名将如下所示
/data/nginx/cache/c/29/b7f54b2df7773722d382f4809d65029c
缓存的响应首先写入临时文件,然后重命名该文件。从 0.8.9 版本开始,临时文件和缓存可以放在不同的文件系统上。但是,请注意,在这种情况下,文件将在两个文件系统之间复制,而不是廉价的重命名操作。因此,建议对于任何给定的位置,缓存和保存临时文件的目录都放在同一个文件系统上。临时文件的目录根据 use_temp_path
参数 (1.7.10) 设置。如果省略此参数或将其设置为 on
值,则将使用为给定位置由 uwsgi_temp_path 指令设置的目录。如果该值设置为 off
,则临时文件将直接放在缓存目录中。
此外,所有活动键和有关数据的信息都存储在共享内存区域中,其 名称
和 大小
由 keys_zone
参数配置。一个兆字节的区域可以存储大约 8000 个键。
作为 商业订阅 的一部分,共享内存区域还存储扩展的缓存 信息,因此,对于相同数量的键,需要指定更大的区域大小。例如,一个兆字节的区域可以存储大约 4000 个键。
在 inactive
参数指定的时间内未访问的缓存数据将从缓存中删除,无论其新鲜度如何。默认情况下,inactive
设置为 10 分钟。
特殊的“缓存管理器”进程监控由max_size
参数设置的最大缓存大小,以及由min_free
(1.19.1) 参数设置的文件系统(包含缓存)上的最小可用空间量。当大小超过限制或没有足够的可用空间时,它会移除最近最少使用的数据。数据会以由manager_files
、manager_threshold
和manager_sleep
参数 (1.11.5) 配置的迭代方式移除。在一次迭代中,最多删除manager_files
个项目(默认值为 100)。一次迭代的持续时间受manager_threshold
参数限制(默认值为 200 毫秒)。在迭代之间,会暂停由manager_sleep
参数配置的时间(默认值为 50 毫秒)。
启动一分钟后,特殊的“缓存加载器”进程会被激活。它会将存储在文件系统上的先前缓存数据的相关信息加载到缓存区。加载也以迭代方式完成。在一次迭代中,最多加载loader_files
个项目(默认值为 100)。此外,一次迭代的持续时间受loader_threshold
参数限制(默认值为 200 毫秒)。在迭代之间,会暂停由loader_sleep
参数配置的时间(默认值为 50 毫秒)。
此外,以下参数作为我们 商业订阅 的一部分提供。
-
purger
=on
|off
- 指示是否通过缓存清除器 (1.7.12) 从磁盘中移除与通配符键匹配的缓存条目。将参数设置为
on
(默认值为off
)将激活“缓存清除器”进程,该进程会永久遍历所有缓存条目并删除与通配符键匹配的条目。 -
purger_files
=number
- 设置在一次迭代中将扫描的项目数量 (1.7.12)。默认情况下,
purger_files
设置为 10。 -
purger_threshold
=number
- 设置一次迭代的持续时间 (1.7.12)。默认情况下,
purger_threshold
设置为 50 毫秒。 -
purger_sleep
=number
- 设置迭代之间的暂停时间 (1.7.12)。默认情况下,
purger_sleep
设置为 50 毫秒。
在 1.7.3、1.7.7 和 1.11.10 版本中,缓存头格式已更改。升级到较新的 nginx 版本后,先前缓存的响应将被视为无效。
语法 |
uwsgi_cache_purge string ...; |
---|---|
默认值 | — |
上下文 |
http 、server 、location |
此指令出现在 1.5.7 版本中。
定义请求在何种情况下会被视为缓存清除请求。如果字符串参数的至少一个值不为空且不等于“0”,则会移除具有相应缓存键的缓存条目。成功操作的结果通过返回 204 (无内容) 响应来指示。
如果清除请求的缓存键以星号 (“*
”) 结尾,则所有与通配符键匹配的缓存条目将从缓存中移除。但是,这些条目将保留在磁盘上,直到它们由于空闲而被删除,或者由缓存清除器 (1.7.12) 处理,或者客户端尝试访问它们。
示例配置
uwsgi_cache_path /data/nginx/cache keys_zone=cache_zone:10m; map $request_method $purge_method { PURGE 1; default 0; } server { ... location / { uwsgi_pass backend; uwsgi_cache cache_zone; uwsgi_cache_key $uri; uwsgi_cache_purge $purge_method; } }
此功能作为我们 商业订阅 的一部分提供。
语法 |
uwsgi_cache_revalidate |
---|---|
默认值 |
uwsgi_cache_revalidate off; |
上下文 |
http 、server 、location |
此指令出现在 1.5.7 版本中。
启用使用带有“If-Modified-Since”和“If-None-Match”报头字段的条件请求来重新验证已过期的缓存项。
语法 |
uwsgi_cache_use_stale |
---|---|
默认值 |
uwsgi_cache_use_stale off; |
上下文 |
http 、server 、location |
确定在与 uwsgi 服务器通信时发生错误时,在哪些情况下可以使用陈旧的缓存响应。指令的参数与uwsgi_next_upstream指令的参数匹配。
error
参数还允许在无法选择处理请求的 uwsgi 服务器时使用陈旧的缓存响应。
此外,updating
参数允许在当前正在更新缓存响应时使用陈旧的缓存响应。这允许在更新缓存数据时最大程度地减少对 uwsgi 服务器的访问次数。
也可以在响应报头中直接为响应变为陈旧后的指定秒数启用使用陈旧的缓存响应 (1.11.10)。这比使用指令参数的优先级低。
- “Cache-Control”报头字段的“stale-while-revalidate”扩展允许在当前正在更新缓存响应时使用陈旧的缓存响应。
- “Cache-Control”报头字段的“stale-if-error”扩展允许在发生错误时使用陈旧的缓存响应。
为了在填充新的缓存元素时最大程度地减少对 uwsgi 服务器的访问次数,可以使用uwsgi_cache_lock指令。
语法 |
uwsgi_cache_valid [ |
---|---|
默认值 | — |
上下文 |
http 、server 、location |
为不同的响应代码设置缓存时间。例如,以下指令
uwsgi_cache_valid 200 302 10m; uwsgi_cache_valid 404 1m;
为代码为 200 和 302 的响应设置 10 分钟的缓存时间,为代码为 404 的响应设置 1 分钟的缓存时间。
如果仅指定缓存time
uwsgi_cache_valid 5m;
则仅缓存 200、301 和 302 响应。
此外,可以指定any
参数来缓存任何响应。
uwsgi_cache_valid 200 302 10m; uwsgi_cache_valid 301 1h; uwsgi_cache_valid any 1m;
缓存参数也可以直接在响应报头中设置。这比使用指令设置缓存时间的优先级高。
- “X-Accel-Expires”报头字段以秒为单位设置响应的缓存时间。零值禁用响应的缓存。如果值以
@
前缀开头,则设置自纪元以来的绝对时间(以秒为单位),在此时间之前可以缓存响应。 - 如果报头不包含“X-Accel-Expires”字段,则可以在“Expires”或“Cache-Control”报头字段中设置缓存参数。
- 如果报头包含“Set-Cookie”字段,则不会缓存此类响应。
- 如果报头包含带有特殊值“
*
”的“Vary”字段,则不会缓存此类响应 (1.7.7)。如果报头包含带有其他值的“Vary”字段,则会缓存此类响应,同时考虑相应的请求报头字段 (1.7.7)。
可以使用uwsgi_ignore_headers指令禁用一个或多个这些响应报头字段的处理。
语法 |
uwsgi_connect_timeout |
---|---|
默认值 |
uwsgi_connect_timeout 60s; |
上下文 |
http 、server 、location |
定义与 uwsgi 服务器建立连接的超时时间。需要注意的是,此超时时间通常不能超过 75 秒。
语法 |
uwsgi_force_ranges |
---|---|
默认值 |
uwsgi_force_ranges off; |
上下文 |
http 、server 、location |
此指令出现在 1.7.7 版本中。
启用对来自 uwsgi 服务器的缓存和未缓存响应的字节范围支持,而不管这些响应中的“Accept-Ranges”字段如何。
语法 |
uwsgi_hide_header |
---|---|
默认值 | — |
上下文 |
http 、server 、location |
默认情况下,nginx 不会将“Status”和“X-Accel-...”报头字段从 uwsgi 服务器的响应传递到客户端。uwsgi_hide_header
指令设置不会传递的其他字段。相反,如果需要允许字段的传递,则可以使用uwsgi_pass_header指令。
语法 |
uwsgi_ignore_client_abort |
---|---|
默认值 |
uwsgi_ignore_client_abort off; |
上下文 |
http 、server 、location |
确定当客户端关闭连接而不等待响应时,是否应关闭与 uwsgi 服务器的连接。
语法 |
uwsgi_ignore_headers |
---|---|
默认值 | — |
上下文 |
http 、server 、location |
禁用对来自 uwsgi 服务器的某些响应报头字段的处理。可以忽略以下字段:“X-Accel-Redirect”、“X-Accel-Expires”、“X-Accel-Limit-Rate” (1.1.6)、“X-Accel-Buffering” (1.1.6)、“X-Accel-Charset” (1.1.6)、“Expires”、“Cache-Control”、“Set-Cookie” (0.8.44) 和“Vary” (1.7.7)。
如果未禁用,则这些报头字段的处理具有以下效果
- “X-Accel-Expires”、“Expires”、“Cache-Control”、“Set-Cookie”和“Vary”设置响应缓存的参数;
- “X-Accel-Redirect”对指定的 URI 执行内部重定向;
- “X-Accel-Limit-Rate”设置向客户端传输响应的速率限制;
- “X-Accel-Buffering”启用或禁用响应的缓冲;
- “X-Accel-Charset”设置响应所需的字符集。
语法 |
uwsgi_intercept_errors |
---|---|
默认值 |
uwsgi_intercept_errors off; |
上下文 |
http 、server 、location |
确定是否应将代码大于或等于 300 的 uwsgi 服务器响应传递给客户端,或者拦截并重定向到 nginx 以使用error_page指令进行处理。
语法 |
uwsgi_limit_rate |
---|---|
默认值 |
uwsgi_limit_rate 0; |
上下文 |
http 、server 、location |
此指令出现在 1.7.7 版本中。
限制从 uwsgi 服务器读取响应的速度。rate
以每秒字节数指定。零值禁用速率限制。限制针对每个请求设置,因此如果 nginx 同时打开两个到 uwsgi 服务器的连接,则总速率将是指定限制的两倍。仅当启用来自 uwsgi 服务器的响应的缓冲时,限制才有效。参数值可以包含变量 (1.27.0)。
语法 |
uwsgi_max_temp_file_size |
---|---|
默认值 |
uwsgi_max_temp_file_size 1024m; |
上下文 |
http 、server 、location |
当启用来自 uwsgi 服务器的响应的缓冲,并且整个响应不适合由uwsgi_buffer_size和uwsgi_buffers指令设置的缓冲区时,响应的一部分可以保存到临时文件。此指令设置临时文件的最大size
。每次写入临时文件的数据大小由uwsgi_temp_file_write_size指令设置。
零值禁用将响应缓冲到临时文件。
此限制不适用于将被缓存或存储到磁盘上的响应。
语法 |
uwsgi_modifier1 |
---|---|
默认值 |
uwsgi_modifier1 0; |
上下文 |
http 、server 、location |
设置uwsgi 数据包报头中modifier1
字段的值。
语法 |
uwsgi_modifier2 |
---|---|
默认值 |
uwsgi_modifier2 0; |
上下文 |
http 、server 、location |
设置uwsgi 数据包报头中modifier2
字段的值。
语法 |
uwsgi_next_upstream |
---|---|
默认值 |
uwsgi_next_upstream error timeout; |
上下文 |
http 、server 、location |
指定在哪些情况下应将请求传递到下一个服务器
error
- 在与服务器建立连接、传递请求或读取响应报头时发生错误;
timeout
- 在与服务器建立连接、传递请求或读取响应报头时发生超时;
invalid_header
- 服务器返回空响应或无效响应;
http_500
- 服务器返回代码为 500 的响应;
http_503
- 服务器返回代码为 503 的响应;
http_403
- 服务器返回代码为 403 的响应;
http_404
- 服务器返回代码为 404 的响应;
http_429
- 服务器返回代码为 429 的响应 (1.11.13);
non_idempotent
- 通常,如果已将请求发送到上游服务器,则不会将使用非幂等方法 (
POST
、LOCK
、PATCH
) 的请求传递到下一个服务器 (1.9.13);明确启用此选项允许重试此类请求; off
- 禁用将请求传递到下一个服务器。
需要注意的是,只有在尚未向客户端发送任何内容的情况下,才能将请求传递到下一个服务器。也就是说,如果在响应传输过程中发生错误或超时,则无法修复此问题。
该指令还定义了什么是与服务器通信的不成功尝试。error
、timeout
和 invalid_header
的情况始终被视为不成功尝试,即使它们未在指令中指定。http_500
、http_503
和 http_429
的情况仅在指令中指定时才被视为不成功尝试。http_403
和 http_404
的情况永远不会被视为不成功尝试。
语法 |
uwsgi_next_upstream_timeout |
---|---|
默认值 |
uwsgi_next_upstream_timeout 0; |
上下文 |
http 、server 、location |
此指令出现在 1.7.5 版本中。
限制可以将请求传递到下一个服务器的时间。0
值将关闭此限制。
语法 |
uwsgi_next_upstream_tries |
---|---|
默认值 |
uwsgi_next_upstream_tries 0; |
上下文 |
http 、server 、location |
此指令出现在 1.7.5 版本中。
限制将请求传递到下一个服务器的可能尝试次数。0
值将关闭此限制。
语法 |
uwsgi_no_cache |
---|---|
默认值 | — |
上下文 |
http 、server 、location |
定义在什么条件下响应不会被保存到缓存中。如果字符串参数的至少一个值不为空且不等于“0”,则不会保存响应。
uwsgi_no_cache $cookie_nocache $arg_nocache$arg_comment; uwsgi_no_cache $http_pragma $http_authorization;
可以与uwsgi_cache_bypass 指令一起使用。
语法 |
uwsgi_param |
---|---|
默认值 | — |
上下文 |
http 、server 、location |
设置应传递给 uwsgi 服务器的parameter
。value
可以包含文本、变量及其组合。如果当前级别没有定义 uwsgi_param
指令,则这些指令将从上一级配置继承。
标准的CGI 环境变量 应作为 uwsgi 头提供,请参阅发行版中提供的 uwsgi_params
文件。
location / { include uwsgi_params; ... }
如果指令与 if_not_empty
(1.1.11) 一起指定,则只有在该参数的值不为空时,才会将其传递给服务器。
uwsgi_param HTTPS $https if_not_empty;
语法 |
uwsgi_pass [ |
---|---|
默认值 | — |
上下文 |
location 、if in location |
设置 uwsgi 服务器的协议和地址。作为protocol
,可以指定“uwsgi
”或“suwsgi
”(安全的 uwsgi,通过 SSL 的 uwsgi)。地址可以指定为域名或 IP 地址,以及端口。
uwsgi_pass localhost:9000; uwsgi_pass uwsgi://127.0.0.1:9000; uwsgi_pass suwsgi://[2001:db8::1]:9090;
或作为 UNIX 域套接字路径。
uwsgi_pass unix:/tmp/uwsgi.socket;
如果域名解析到多个地址,则将以轮询方式使用所有地址。此外,地址可以指定为服务器组。
参数值可以包含变量。在这种情况下,如果地址指定为域名,则将在描述的服务器组中搜索该名称,如果未找到,则使用解析器确定。
从 1.5.8 版本开始支持安全的 uwsgi 协议。
语法 |
uwsgi_pass_header |
---|---|
默认值 | — |
上下文 |
http 、server 、location |
允许将来自 uwsgi 服务器到客户端的其他情况下禁用的头字段传递。
语法 |
uwsgi_pass_request_body |
---|---|
默认值 |
uwsgi_pass_request_body on; |
上下文 |
http 、server 、location |
指示是否将原始请求正文传递给 uwsgi 服务器。另请参阅uwsgi_pass_request_headers 指令。
语法 |
uwsgi_pass_request_headers |
---|---|
默认值 |
uwsgi_pass_request_headers on; |
上下文 |
http 、server 、location |
指示是否将原始请求的头字段传递给 uwsgi 服务器。另请参阅uwsgi_pass_request_body 指令。
语法 |
uwsgi_read_timeout |
---|---|
默认值 |
uwsgi_read_timeout 60s; |
上下文 |
http 、server 、location |
定义从 uwsgi 服务器读取响应的超时时间。超时仅在两次连续读取操作之间设置,而不是为整个响应的传输设置。如果 uwsgi 服务器在此时间内未传输任何内容,则连接将关闭。
语法 |
uwsgi_request_buffering |
---|---|
默认值 |
uwsgi_request_buffering on; |
上下文 |
http 、server 、location |
此指令出现在 1.7.11 版本中。
启用或禁用客户端请求正文的缓冲。
启用缓冲时,在将请求发送到 uwsgi 服务器之前,会读取客户端的整个请求正文。
禁用缓冲时,请求正文会立即发送到 uwsgi 服务器,就像收到一样。在这种情况下,如果 nginx 已经开始发送请求正文,则无法将请求传递到下一个服务器。
当使用 HTTP/1.1 分块传输编码发送原始请求正文时,无论指令值如何,请求正文都将被缓冲。
语法 |
uwsgi_send_timeout |
---|---|
默认值 |
uwsgi_send_timeout 60s; |
上下文 |
http 、server 、location |
设置将请求传输到 uwsgi 服务器的超时时间。超时仅在两次连续写入操作之间设置,而不是为整个请求的传输设置。如果 uwsgi 服务器在此时间内未收到任何内容,则连接将关闭。
语法 |
uwsgi_socket_keepalive |
---|---|
默认值 |
uwsgi_socket_keepalive off; |
上下文 |
http 、server 、location |
此指令出现在 1.15.6 版本中。
配置到 uwsgi 服务器的出站连接的“TCP keepalive”行为。默认情况下,操作系统的设置对套接字有效。如果指令设置为“on
”值,则套接字的 SO_KEEPALIVE
套接字选项将打开。
语法 |
uwsgi_ssl_certificate |
---|---|
默认值 | — |
上下文 |
http 、server 、location |
此指令出现在 1.7.8 版本中。
指定一个包含 PEM 格式证书的文件,用于对安全的 uwsgi 服务器进行身份验证。
从 1.21.0 版本开始,可以在file
名称中使用变量。
语法 |
uwsgi_ssl_certificate_key |
---|---|
默认值 | — |
上下文 |
http 、server 、location |
此指令出现在 1.7.8 版本中。
指定一个包含 PEM 格式密钥文件的文件,用于对安全的 uwsgi 服务器进行身份验证。
可以指定 engine
:name
:id
值而不是file
(1.7.9),它会从 OpenSSL 引擎 name
加载具有指定 id
的密钥。
从 1.21.0 版本开始,可以在file
名称中使用变量。
语法 |
uwsgi_ssl_ciphers |
---|---|
默认值 |
uwsgi_ssl_ciphers DEFAULT; |
上下文 |
http 、server 、location |
此指令出现在 1.5.8 版本中。
指定对安全的 uwsgi 服务器请求启用的密码。密码采用 OpenSSL 库识别的格式指定。
可以使用“openssl ciphers
”命令查看完整列表。
语法 |
uwsgi_ssl_conf_command |
---|---|
默认值 | — |
上下文 |
http 、server 、location |
此指令出现在 1.19.4 版本中。
在与安全的 uwsgi 服务器建立连接时设置任意 OpenSSL 配置命令。
使用 OpenSSL 1.0.2 或更高版本时支持此指令。
可以在同一级别上指定多个 uwsgi_ssl_conf_command
指令。如果当前级别没有定义 uwsgi_ssl_conf_command
指令,则这些指令将从上一级配置继承。
请注意,直接配置 OpenSSL 可能会导致意外行为。
语法 |
uwsgi_ssl_crl |
---|---|
默认值 | — |
上下文 |
http 、server 、location |
此指令出现在 1.7.0 版本中。
指定一个包含 PEM 格式吊销证书 (CRL) 的文件,用于验证安全 uwsgi 服务器的证书。
语法 |
uwsgi_ssl_key_log path; |
---|---|
默认值 | — |
上下文 |
http 、server 、location |
此指令出现在 1.27.2 版本中。
启用安全 uwsgi 服务器连接 SSL 密钥的日志记录,并指定密钥日志文件路径。密钥以与 Wireshark 兼容的SSLKEYLOGFILE格式记录。
此指令作为我们商业订阅的一部分提供。
语法 |
uwsgi_ssl_name |
---|---|
默认值 |
uwsgi_ssl_name host from uwsgi_pass; |
上下文 |
http 、server 、location |
此指令出现在 1.7.0 版本中。
允许覆盖用于验证安全 uwsgi 服务器证书的服务器名称,并在与安全 uwsgi 服务器建立连接时通过 SNI 传递。
默认情况下,使用uwsgi_pass中的主机部分。
语法 |
uwsgi_ssl_password_file |
---|---|
默认值 | — |
上下文 |
http 、server 、location |
此指令出现在 1.7.8 版本中。
指定一个包含密钥密码的文件,其中每个密码都单独一行指定。加载密钥时将依次尝试密码。
语法 |
uwsgi_ssl_protocols [ |
---|---|
默认值 |
uwsgi_ssl_protocols TLSv1 TLSv1.1 TLSv1.2 TLSv1.3; |
上下文 |
http 、server 、location |
此指令出现在 1.5.8 版本中。
启用对安全的 uwsgi 服务器请求指定的协议。
从 1.23.4 版本开始,默认情况下使用 TLSv1.3
参数。
语法 |
uwsgi_ssl_server_name |
---|---|
默认值 |
uwsgi_ssl_server_name off; |
上下文 |
http 、server 、location |
此指令出现在 1.7.0 版本中。
启用或禁用在与安全的 uwsgi 服务器建立连接时通过TLS 服务器名称指示扩展(SNI,RFC 6066)传递服务器名称。
语法 |
uwsgi_ssl_session_reuse |
---|---|
默认值 |
uwsgi_ssl_session_reuse on; |
上下文 |
http 、server 、location |
此指令出现在 1.5.8 版本中。
确定在使用安全的 uwsgi 服务器时是否可以重用 SSL 会话。如果日志中出现“SSL3_GET_FINISHED:digest check failed
”错误,请尝试禁用会话重用。
语法 |
uwsgi_ssl_trusted_certificate |
---|---|
默认值 | — |
上下文 |
http 、server 、location |
此指令出现在 1.7.0 版本中。
指定一个包含 PEM 格式受信任 CA 证书的文件,用于验证安全 uwsgi 服务器的证书。
语法 |
uwsgi_ssl_verify |
---|---|
默认值 |
uwsgi_ssl_verify off; |
上下文 |
http 、server 、location |
此指令出现在 1.7.0 版本中。
启用或禁用安全 uwsgi 服务器证书的验证。
语法 |
uwsgi_ssl_verify_depth |
---|---|
默认值 |
uwsgi_ssl_verify_depth 1; |
上下文 |
http 、server 、location |
此指令出现在 1.7.0 版本中。
设置安全 uwsgi 服务器证书链中的验证深度。
语法 |
uwsgi_store |
---|---|
默认值 |
uwsgi_store off; |
上下文 |
http 、server 、location |
启用将文件保存到磁盘。on
参数将保存与指令alias或root相对应的路径的文件。off
参数禁用文件的保存。此外,可以使用包含变量的string
显式设置文件名。
uwsgi_store /data/www$original_uri;
文件的修改时间根据接收到的“Last-Modified”响应头字段设置。响应首先写入一个临时文件,然后重命名该文件。从 0.8.9 版本开始,临时文件和持久存储可以放在不同的文件系统上。但是,请注意,在这种情况下,文件将在两个文件系统之间复制,而不是廉价的重命名操作。因此,建议对于任何给定的位置,保存的文件和由 uwsgi_temp_path 指令设置的保存临时文件的目录都放在同一个文件系统上。
此指令可用于创建静态不变文件的本地副本,例如:
location /images/ { root /data/www; error_page 404 = /fetch$uri; } location /fetch/ { internal; uwsgi_pass backend:9000; ... uwsgi_store on; uwsgi_store_access user:rw group:rw all:r; uwsgi_temp_path /data/temp; alias /data/www/; }
语法 |
uwsgi_store_access |
---|---|
默认值 |
uwsgi_store_access user:rw; |
上下文 |
http 、server 、location |
设置新创建的文件和目录的访问权限,例如:
uwsgi_store_access user:rw group:rw all:r;
如果指定了任何 group
或 all
访问权限,则可以省略 user
权限
uwsgi_store_access group:rw all:r;
语法 |
uwsgi_temp_file_write_size |
---|---|
默认值 |
uwsgi_temp_file_write_size 8k|16k; |
上下文 |
http 、server 、location |
限制一次写入临时文件的数据的 size
,当启用从 uwsgi 服务器到临时文件的响应缓冲时。默认情况下,size
受由 uwsgi_buffer_size 和 uwsgi_buffers 指令设置的两个缓冲区限制。临时文件的最大大小由 uwsgi_max_temp_file_size 指令设置。
语法 |
uwsgi_temp_path |
---|---|
默认值 |
uwsgi_temp_path uwsgi_temp; |
上下文 |
http 、server 、location |
定义一个目录,用于存储从 uwsgi 服务器接收到的数据的临时文件。可以在指定目录下使用最多三级子目录层次结构。例如,在以下配置中
uwsgi_temp_path /spool/nginx/uwsgi_temp 1 2;
临时文件可能如下所示
/spool/nginx/uwsgi_temp/7/45/00000123457
另请参见 uwsgi_cache_path 指令的 use_temp_path
参数。