ngx_http_scgi_module 模块

ngx_http_scgi_module 模块允许将请求传递给 SCGI 服务器。

示例配置

location / {
    include   scgi_params;
    scgi_pass localhost:9000;
}

指令

scgi_bind 指令

语 法:scgi_bind address [transparent] | off;
默认值:—
上下文:http, server, location

使用可选端口 (1.11.2) 从指定的本地IP地址建立到 SCGI 服务器的传出连接。参数值可以包含变量 (1.3.12)。特殊值off (1.3.12) 取消了从上一个配置级别继承的 scgi_bind 指令的效果,该指令允许系统自动分配本地IP地址和端口。

transparent 参数 (1.11.0) 允许从非本地IP地址 (例如:从客户端的真实IP地址) 到SCGI服务器的传出连接:

scgi_bind $remote_addr transparent;

要使此参数起作用,通常需要使用超级用户权限运行 nginx 工作进程。在Linux上不需要 (1.13.8),因为如果指定了 transparent 参数,工作进程将从主进程继承 CAP_NET_RAW 功能。还需要配置内核路由表来拦截来自 SCGI 服务器的网络流量。

scgi_buffer_size 指令

语 法:scgi_buffer_size size;
默认值:scgi_buffer_size 4k|8k;
上下文:http, server, location

设置用于读取从SCGI服务器接收的响应的第一部分的缓冲区大小。此部分通常包含一个小的响应头。默认情况下,缓冲区大小等于一个内存页。这可以是4K或8K,具体取决于平台。然而,它可以变得更小。

scgi_buffering 指令

语 法:scgi_buffering on | off;
默认值:scgi_buffering on;
上下文:http, server, location

启用或禁用来自 SCGI 服务器的响应缓冲。

启用缓冲后,nginx 会尽快从 SCGI 服务器接收响应,并将其保存到由 scgi_buffer_size 和 scgi_buffers 指令设置的缓冲区中。如果整个响应无法装入内存,则可以将部分响应保存到磁盘上的临时文件中。

写入临时文件由 scgi_max_temp_file_size 和 scgi_temp_file_write_size 指令控制。

禁用缓冲时,响应将在收到响应时立即同步传递到客户端。nginx 不会尝试从 SCGI 服务器读取整个响应。nginx 一次可以从服务器接收的最大数据大小由 scgi_buffer_size 指令设置。

也可以通过在 “X-Accel-Buffering” 响应报头字段中传递 “yes” 或 “no” 来启用或禁用缓冲。可以使用 scgi_ignore_headers 指令禁用此功能。

scgi_buffers 指令

语 法:scgi_buffers number size;
默认值:scgi_buffers 8 4k|8k;
上下文:http, server, location

为单个连接设置用于从 SCGI 服务器读取响应的缓冲区的数量和大小。默认情况下,缓冲区大小等于一个内存页。这可以是4K或8K,具体取决于平台。

scgi_busy_buffers_size 指令

语 法:scgi_busy_buffers_size size;
默认值:scgi_busy_buffers_size 8k|16k;
上下文:http, server, location

启用来自 SCGI 服务器的响应缓冲时,会限制在响应尚未完全读取时忙于向客户端发送响应的缓冲区的总大小。同时,其余的缓冲区可以用于读取响应,如果需要,还可以将部分响应缓冲到临时文件。默认情况下,大小受 scgi_buffer_size 和 scgi_buffers 指令设置的两个缓冲区的大小限制。

scgi_cache 指令

语 法:scgi_cache zone | off;
默认值:scgi_cache off;
上下文:http, server, location

定义用于缓存的共享内存区。同一区域可以在多个地方使用。参数值可以包含变量(1.7.9)。off 参数禁用从上一个配置级别继承的缓存。

scgi_cache_background_update 指令

语 法:scgi_cache_background_update on | off;
默认值:scgi_cache_background_update off;
上下文:http, server, location

此指令出现在版本1.11.10中。

允许启动后台子请求以更新过期的缓存项,同时将过时的缓存响应返回给客户端。请注意,有必要在更新时允许使用过时的缓存响应。

scgi_cache_bypass 指令

语 法:scgi_cache_bypass string ...;
默认值:—
上下文:http, server, location

定义不从缓存获取响应的条件。如果字符串参数中至少有一个值不为空且不等于“0”,则不会从缓存中获取响应:

scgi_cache_bypass $cookie_nocache $arg_nocache$arg_comment;
scgi_cache_bypass $http_pragma    $http_authorization;

可以与 scgi_no_cache 指令一起使用。

scgi_cache_key 指令

语 法:scgi_cache_key string;
默认值:—
上下文:http, server, location

定义用于缓存的键,例如:

scgi_cache_key localhost:9000$request_uri;

scgi_cache_lock 指令

语 法:scgi_cache_lock on | off;
默认值:scgi_cache_lock off;
上下文:http, server, location

该指令出现在1.1.12版中。

启用后,通过将请求传递给 SCGI 服务器,一次只允许一个请求填充根据scgi_cache_key指令标识的新缓存元素。同一缓存元素的其他请求要么等待响应出现在缓存中,要么等待缓存锁定以释放该元素,直到scgi_cache_lock_timeout指令设置的时间为止。

scgi_cache_lock_age 指令

语 法:scgi_cache_lock_age time;
默认值:scgi_cache_lock_age 5s;
上下文:http, server, location

此指令出现在版本 1.7.8 中。

如果传递给 SCGI 服务器的用于填充新高速缓存元素的最后一个请求在指定时间内没有完成,则可以向 SCGI 服务器传递另一个请求。

scgi_cache_lock_timeout 指令

语 法:scgi_cache_lock_timeout time;
默认值:scgi_cache_lock_timeout 5s;
上下文:http, server, location

该指令出现在 1.1.12 版中。

设置 scgi_cache_lock 的超时时间。当时间到期时,请求将被传递到SCGI服务器,但是,响应不会被缓存。在1.7.8之前,响应可以缓存。

scgi_cache_max_range_offset 指令

语 法:scgi_cache_max_range_offset number;
默认值:—
上下文:http, server, location

该指令出现在 1.11.6 版中。

为字节范围请求设置以字节为单位的偏移量。如果范围超出偏移量,则范围请求将传递给 SCGI 服务器,并且不会缓存响应。

scgi_cache_methods 指令

语 法:scgi_cache_methods GET | HEAD | POST ...;
默认值:scgi_cache_methods GET HEAD;
上下文:http, server, location

如果此指令中列出了客户端请求方法,则响应将被缓存。“GET”和“HEAD”方法总是添加到列表中,但建议明确指定它们。另请参阅 scgi_no_cache 指令。

scgi_cache_min_uses 指令

语 法:scgi_cache_min_uses number;
默认值:scgi_cache_min_uses 1;
上下文:http, server, 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 函数应用于缓存键的结果。levels 参数定义了缓存的层次级别:从 1 到 3,每个级别接受值 1 或 2。例如,在以下配置中

scgi_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 值,则将使用由 scgi_temp_path 指令为给定位置设置的目录。如果该值设置为 off,临时文件将直接放在缓存目录中。

此外,所有活动密钥和有关数据的信息都存储在共享内存区域中,其名称和大小由 keys_zone 参数配置。一兆字节的区域可以存储大约 8000 个密钥。

作为商业订阅的一部分,共享内存区域还存储扩展缓存信息,因此需要为相同数量的密钥指定更大的区域大小。例如,一兆字节的区域可以存储大约 4000 个密钥。

在 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 版本后,先前缓存的响应将被视为无效。

scgi_cache_purge 指令

语 法:scgi_cache_purge string ...;
默认值:—
上下文:http, server, location

该指令出现在 1.5.7 版中。

定义请求将被视为缓存清除请求的条件。如果字符串参数中的至少一个值不为空且不等于 “0”,则具有相应缓存键的缓存条目将被删除。 操作成功的结果通过返回 204(无内容)响应来指示。

如果清除请求的缓存键以星号(“*”)结尾,则所有匹配通配符键的缓存条目都将从缓存中删除。但是,这些条目将保留在磁盘上,直到它们因不活动或被缓存清除程序 (1.7.12) 处理或客户端尝试访问它们而被删除。

示例配置:

scgi_cache_path /data/nginx/cache keys_zone=cache_zone:10m;

map $request_method $purge_method {
    PURGE   1;
    default 0;
}

server {
    ...
    location / {
        scgi_pass        backend;
        scgi_cache       cache_zone;
        scgi_cache_key   $uri;
        scgi_cache_purge $purge_method;
    }
}

此功能作为我们商业订阅的一部分提供。

scgi_cache_revalidate 指令

语 法:scgi_cache_revalidate on | off;
默认值:scgi_cache_revalidate off;
上下文:http, server, location

该指令出现在 1.5.7 版中。

使用带有 “If-Modified-Since” 和 “If-None-Match” 标头字段的条件请求启用对过期缓存项的重新验证。

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, server, location

确定在与 SCGI 服务器通信期间发生错误时在哪些情况下可以使用陈旧的缓存响应。该指令的参数与 scgi_next_upstream 指令的参数匹配。

如果无法选择处理请求的 SCGI 服务器,则错误参数还允许使用陈旧的缓存响应。

此外,如果当前正在更新,则更新参数允许使用陈旧的缓存响应。 这允许在更新缓存数据时最大限度地减少对 SCGI 服务器的访问次数。

在响应变得陈旧 (1.11.10) 后的指定秒数内,也可以直接在响应标头中启用使用陈旧的缓存响应。这比使用指令参数具有更低的优先级。

如果当前正在更新,则 “Cache-Control” 标头字段的 “stale-while-revalidate” 扩展允许使用过时的缓存响应。

“Cache-Control” 标头字段的 “stale-if-error” 扩展允许在出现错误时使用陈旧的缓存响应。

为了在填充新缓存元素时最大限度地减少对 SCGI 服务器的访问次数,可以使用 scgi_cache_lock 指令。

scgi_cache_valid 指令

语 法:scgi_cache_valid [code ...] time;
默认值:—
上下文:http, server, location

为不同的响应代码设置缓存时间。 例如,以下指令

scgi_cache_valid 200 302 10m;
scgi_cache_valid 404      1m;

为代码 200 和 302 的响应设置 10 分钟的缓存,为代码 404 的响应设置 1 分钟。

如果只指定了缓存时间

scgi_cache_valid 5m;

那么只有 200、301 和 302 响应被缓存。

此外,可以指定 any 参数来缓存任何响应:

scgi_cache_valid 200 302 10m;
scgi_cache_valid 301      1h;
scgi_cache_valid any      1m;

缓存的参数也可以直接在响应头中设置。这比使用指令设置缓存时间具有更高的优先级。

“X-Accel-Expires” 标头字段以秒为单位设置响应的缓存时间。零值禁用响应缓存。如果该值以 @ 前缀开头,则它会设置自 Epoch 以来的绝对时间(以秒为单位),直到可以缓存响应为止。

如果头部不包含 “X-Accel-Expires” 字段,可以在头部字段 “Expires” 或 “Cache-Control” 中设置缓存参数。

如果标头包含 “Set-Cookie” 字段,则不会缓存此类响应。

如果标头包含具有特殊值 “*” 的 “Vary” 字段,则不会缓存此类响应(1.7.7)。如果标头包含具有另一个值的 “Vary” 字段,则将考虑到相应的请求标头字段(1.7.7)来缓存此类响应。

可以使用 scgi_ignore_headers 指令禁用对这些响应头字段中的一个或多个的处理。

scgi_connect_timeout 指令

语 法:scgi_connect_timeout time;
默认值:scgi_connect_timeout 60s;
上下文:http, server, location

定义与 SCGI 服务器建立连接的超时时间。需要注意的是,这个超时时间通常不能超过 75 秒。

scgi_force_ranges 指令

语 法:scgi_force_ranges on | off;
默认值:scgi_force_ranges off;
上下文:http, server, location

该指令出现在 1.7.7 版中。

无论这些响应中的 “Accept-Ranges” 字段如何,都为来自 SCGI 服务器的缓存和未缓存响应启用字节范围支持。

scgi_hide_header 指令

语 法:scgi_hide_header field;
默认值:—
上下文:http, server, location

默认情况下,nginx 不会将 SCGI 服务器的响应中的标头字段 “Status” 和 “X-Accel-...” 传递给客户端。scgi_hide_header 指令设置不会传递的附加字段。相反,如果需要允许传递字段,则可以使用 scgi_pass_header 指令。

scgi_ignore_client_abort 指令

语 法:scgi_ignore_client_abort on | off;
默认值:scgi_ignore_client_abort off;
上下文:http, server, location

确定当客户端在不等待响应的情况下关闭连接时,是否应关闭与 SCGI 服务器的连接。

scgi_ignore_headers 指令

语 法:scgi_ignore_headers field ...;
默认值:—
上下文:http, server, location

禁止处理来自 SCGI 服务器的某些响应头字段。以下字段可以忽略:“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” 设置响应的所需字符集。

scgi_intercept_errors 指令

语 法:scgi_intercept_errors on | off;
默认值:scgi_intercept_errors off;
上下文:http, server, location

确定代码大于或等于 300 的 SCGI 服务器响应是否应该传递给客户端或被拦截并重定向到 nginx 以使用 error_page 指令进行处理。

scgi_limit_rate 指令

语 法:scgi_limit_rate rate;
默认值:scgi_limit_rate 0;
上下文:http, server, location

该指令出现在 1.7.7 版中。

限制从 SCGI 服务器读取响应的速度。速率以每秒字节数指定。零值禁用速率限制。该限制是针对每个请求设置的,因此如果 nginx 同时打开两个到 SCGI 服务器的连接,则总体速率将是指定限制的两倍。仅当启用了 SCGI 服务器的响应缓冲时,此限制才有效。

scgi_max_temp_file_size 指令

语 法:scgi_max_temp_file_size size;
默认值:scgi_max_temp_file_size 1024m;
上下文:http, server, location

当来自 SCGI 服务器的响应缓冲被启用,并且整个响应不适合由 scgi_buffer_size 和 scgi_buffers 指令设置的缓冲区时,可以将一部分响应保存到临时文件中。该指令设置临时文件的最大大小。一次写入临时文件的数据大小由 scgi_temp_file_write_size 指令设置。

零值禁用对临时文件的响应的缓冲。

此限制不适用于将缓存或存储在磁盘上的响应。

scgi_next_upstream 指令

语 法:scgi_next_upstream error | timeout | invalid_header | http_500 | http_503 | http_403 | http_404 | http_429 | non_idempotent | off ...;
默认值:scgi_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 通常,如果请求已发送到上游服务器(1.9.13),则使用非幂等方法(POST、LOCK、PATCH)的请求不会传递到下一个服务器; 显式启用此选项允许重试此类请求;

  • off 禁止将请求传递到下一个服务器。

应该记住,只有在尚未向客户端发送任何内容的情况下,才能将请求传递到下一个服务器。 也就是说,如果在传输响应的过程中发生错误或超时,则无法修复此问题。

该指令还定义了与服务器通信的失败尝试。 错误、超时和 invalid_header 的情况总是被认为是不成功的尝试,即使它们没有在指令中指定。 http_500、http_503 和 http_429 的情况只有在指令中指定时才被认为是不成功的尝试。 http_403 和 http_404 的情况永远不会被认为是不成功的尝试。

将请求传递到下一个服务器可能会受到尝试次数和时间的限制。

scgi_next_upstream_timeout 指令

语 法:scgi_next_upstream_timeout time;
默认值:scgi_next_upstream_timeout 0;
上下文:http, server, location

该指令出现在 1.7.5 版中。

限制请求可以传递到下一个服务器的时间。0 值关闭此限制。

scgi_next_upstream_tries 指令

语 法:scgi_next_upstream_tries number;
默认值:scgi_next_upstream_tries 0;
上下文:http, server, location

该指令出现在 1.7.5 版中。

限制将请求传递到下一个服务器的可能尝试次数。0 值关闭此限制。

scgi_no_cache 指令

语 法:scgi_no_cache string ...;
默认值:—
上下文:http, server, location

定义不将响应保存到缓存的条件。 如果字符串参数中至少有一个值不为空且不等于“0”,则不会保存响应:

scgi_no_cache $cookie_nocache $arg_nocache$arg_comment;
scgi_no_cache $http_pragma    $http_authorization;

可以与 scgi_cache_bypass 指令一起使用。

scgi_param 指令

语 法:scgi_param parameter value [if_not_empty];
默认值:—
上下文:http, server, location

设置应传递给 SCGI 服务器的参数。 该值可以包含文本、变量及其组合。 当且仅当在当前级别上没有定义 scgi_param 指令时,这些指令才从先前的配置级别继承。

标准 CGI 环境变量应作为 SCGI 头文件提供,请参阅发行版中提供的 scgi_params 文件:

location / {
    include scgi_params;
    ...
}

如果指令是用 if_not_empty (1.1.11) 指定的,那么只有当它的值不为空时,才会将这样的参数传递给服务器:

scgi_param HTTPS $https if_not_empty;

scgi_pass 指令

语 法:scgi_pass address;
默认值:—
上下文:location, if in location

设置 SCGI 服务器的地址。地址可以指定为域名或 IP 地址,以及端口:

scgi_pass localhost:9000;

或作为 UNIX 域套接字路径:

scgi_pass unix:/tmp/scgi.socket;

如果域名解析为多个地址,则所有地址都将以循环方式使用。 此外,可以将地址指定为服务器组。

参数值可以包含变量。 在这种情况下,如果地址被指定为域名,则在描述的服务器组中搜索该名称,如果没有找到,则使用解析器来确定。

scgi_pass_header 指令

语 法:scgi_pass_header field;
默认值:—
上下文:http, server, location

允许将禁用的标头字段从 SCGI 服务器传递到客户端。

scgi_pass_request_body 指令

语 法:scgi_pass_request_body on | off;
默认值:scgi_pass_request_body on;
上下文:http, server, location

指示是否将原始请求正文传递给 SCGI 服务器。另请参阅 scgi_pass_request_headers 指令。

scgi_pass_request_headers 指令

语 法:scgi_pass_request_headers on | off;
默认值:scgi_pass_request_headers on;
上下文:http, server, location

指示是否将原始请求的头字段传递给 SCGI 服务器。 另请参阅 scgi_pass_request_body 指令。

scgi_read_timeout 指令

语 法:scgi_read_timeout time;
默认值:scgi_read_timeout 60s;
上下文:http, server, location

定义从 SCGI 服务器读取响应的超时时间。超时仅在两次连续读取操作之间设置,而不是针对整个响应的传输。如果 SCGI 服务器在此时间内没有传输任何内容,则连接关闭。

scgi_request_buffering 指令

语 法:scgi_request_buffering on | off;
默认值:scgi_request_buffering on;
上下文:http, server, location

该指令出现在 1.7.11 版中。

启用或禁用客户端请求正文的缓冲。

启用缓冲后,在将请求发送到 SCGI 服务器之前,将从客户端读取整个请求正文。

禁用缓冲时,请求正文在收到时立即发送到 SCGI 服务器。 在这种情况下,如果 nginx 已经开始发送请求正文,则请求无法传递到下一个服务器。

当使用 HTTP/1.1 分块传输编码发送原始请求正文时,无论指令值如何,请求正文都将被缓冲。

scgi_send_timeout 指令

语 法:scgi_send_timeout time;
默认值:scgi_send_timeout 60s;
上下文:http, server, location

设置将请求传输到 SCGI 服务器的超时时间。 超时仅设置在两次连续的写操作之间,而不是针对整个请求的传输。 如果 SCGI 服务器在此时间内没有收到任何信息,则连接关闭。

scgi_socket_keepalive 指令

语 法:scgi_socket_keepalive on | off;
默认值:scgi_socket_keepalive off;
上下文:http, server, location

该指令出现在 1.15.6 版中。

为到 SCGI 服务器的传出连接配置 “TCP keepalive” 行为。默认情况下,操作系统的设置对套接字有效。如果指令设置为值“on”,则为套接字打开 SO_KEEPALIVE 套接字选项。

scgi_store 指令

语 法:scgi_store on | off | string;
默认值:scgi_store off;
上下文:http, server, location

启用将文件保存到磁盘。on 参数使用与指令别名或根对应的路径保存文件。off 参数禁止保存文件。此外,可以使用带有变量的字符串显式设置文件名:

scgi_store /data/www$original_uri;

根据收到的 “Last-Modified” 响应头域设置文件的修改时间。响应首先写入临时文件,然后重命名该文件。从 0.8.9 版本开始,临时文件和持久存储可以放在不同的文件系统上。但是,请注意,在这种情况下,文件是跨两个文件系统复制的,而不是廉价的重命名操作。因此,建议对于任何给定位置,将保存的文件和保存临时文件的目录(由 scgi_temp_path 指令设置)放在同一文件系统上。

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

location /images/ {
    root              /data/www;
    error_page        404 = /fetch$uri;
}

location /fetch/ {
    internal;

    scgi_pass         backend:9000;
    ...

    scgi_store        on;
    scgi_store_access user:rw group:rw all:r;
    scgi_temp_path    /data/temp;

    alias             /data/www/;
}

scgi_store_access 指令

语 法:scgi_store_access users:permissions ...;
默认值:scgi_store_access user:rw;
上下文:http, server, location

为新创建的文件和目录设置访问权限,例如:

scgi_store_access user:rw group:rw all:r;

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

scgi_store_access group:rw all:r;

scgi_temp_file_write_size 指令

语 法:scgi_temp_file_write_size size;
默认值:scgi_temp_file_write_size 8k|16k;
上下文:http, server, location

当启用缓冲从 SCGI 服务器到临时文件的响应时,限制一次写入临时文件的数据大小。 默认情况下,大小受 scgi_buffer_size 和 scgi_buffers 指令设置的两个缓冲区的限制。 临时文件的最大大小由 scgi_max_temp_file_size 指令设置。

scgi_temp_path 指令

语 法:scgi_temp_path path [level1 [level2 [level3]]];
默认值:scgi_temp_path scgi_temp;
上下文:http, server, location

定义一个目录,用于存储从 SCGI 服务器接收到的数据的临时文件。 指定目录下最多可使用三级子目录层次结构。 例如,在以下配置中

scgi_temp_path /spool/nginx/scgi_temp 1 2;

临时文件可能如下所示:

/spool/nginx/scgi_temp/7/45/00000123457

另请参阅 scgi_cache_path 指令的 use_temp_path 参数。

说说我的看法
全部评论(
没有评论
关于
本网站属于个人的非赢利性网站,转载的文章遵循原作者的版权声明,如果原文没有版权声明,请来信告知:hxstrive@outlook.com
公众号