client_body_temp_path

`client_body_temp_path` 指令设置用于存放与客户端请求主体相关的临时文件的文件系统路径。 — NGINX HTTP Core

client_body_temp_path
httpserverlocation
语法client_body_temp_path path [max_size [max_files [timeout]]];
默认值none
上下文http, server, location
模块NGINX HTTP Core
参数1-4

说明

`client_body_temp_path` 指令指定在处理传入请求时,包含客户端主体数据的临时文件将被存放的位置。该指令在处理较大的请求主体(如文件上传)时尤为重要。它可以接受单个路径作为参数,或者可选地最多四个参数:用于存放文件的路径、每个临时文件的最大大小、可创建的临时文件的最大数量,以及在指定时间后删除临时文件的可选超时值。对该指令进行正确配置对应优化文件上传过程和有效管理磁盘使用至关重要。 所指定的路径应可被运行 NGINX 工作进程的用户写入。此外,当提供多个参数时,必须按文档中定义的顺序指定它们。如果只指定单个路径,则默认使用某个固定位置,例如类 Unix 系统上的 `/tmp`。还应确保指定目录存在并已妥善保护,以避免潜在的安全漏洞。

配置示例

client_body_temp_path /var/tmp/nginx/client_body_temp;

确保指定的目录存在并且对 NGINX 用户可写。

在接收大型客户端请求体上传时要注意磁盘空间,以免填满文件系统。

避免对临时目录设置过于严格的权限,以防写入失败。