nginx无全局临时文件路径指令,需按模块分别配置:client_body_temp_path、proxy_temp_path、fastcgi_temp_path等,均须用绝对路径、提前创建目录、设正确权限,并推荐两级子目录及独立存储。

Nginx 没有真正的“全局临时文件路径”指令,不能像 root 或 log_format 那样在 http 块顶层用一个统一配置项覆盖所有临时文件行为。必须按功能模块,分别配置对应指令。
client_body_temp_path:上传请求体暂存路径
用于处理大文件上传、POST 表单等超出内存缓冲(client_body_buffer_size)的客户端数据。
- 放在
http块中即可统一生效(也支持server或location内覆盖) - 必须是绝对路径,目录需提前创建,并由 Nginx worker 用户(如
www-data或nginx)拥有读写权限 - 推荐加两级子目录提升性能:
http {
client_body_temp_path /data/nginx/client_body 1 2;
}
- 示例路径结构:
/data/nginx/client_body/a/1f/0000000001
proxy_temp_path:代理响应暂存路径
当后端返回内容过大(超过 proxy_buffer_size + proxy_buffers),或 proxy_buffering off 时启用。
使用ydata-profiling(前身为pandas-profiling)生成全面的数据质量报告,包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
- 只能在
http或server块中配置(location不支持) -
不可与
client_body_temp_path共用同一磁盘,避免 I/O 争抢 - 同样推荐两级子目录和独立高性能存储(如 SSD 分区):
http {
proxy_temp_path /data/nginx/proxy_temp 1 2;
}
- 注意:它不是缓存路径,临时文件在响应结束后自动清理(异常中断可能残留)
fastcgi_temp_path、scgi_temp_path、uwsgi_temp_path
分别对应 PHP-FPM、SCGI、uWSGI 等后端协议的响应暂存路径。
- 语法与
proxy_temp_path完全一致 - 若使用 PHP,且启用了
fastcgi_pass,必须显式配置:
http {
fastcgi_temp_path /data/nginx/fastcgi_temp 1 2;
}
- 每个路径都应独立规划,不混用、不共盘
关键操作要点
- 所有
_temp_path目录必须手动创建:mkdir -p /data/nginx/client_body /data/nginx/proxy_temp /data/nginx/fastcgi_temp chown -R www-data:www-data /data/nginx
- 挂载磁盘时建议加
noatime参数减少元数据写入 - 避免使用
/tmp或/var/tmp等可能被系统自动清理的路径 - 配合定时清理脚本或监控磁盘使用率,防止临时文件堆积
不复杂但容易忽略










