upload_buffer_size
设置用于在 NGINX 中处理文件上传的缓冲区大小。
NGINX module for handling file uploads
·
httpserverlocationif in locationlimit_except
语法upload_buffer_size size;
默认值8k
上下文http, server, location, if in location, limit_except
参数1
说明
NGINX 中的 upload_buffer_size 指令指定了在通过 'multipart/form-data' 处理文件上传时用于读取上传文件数据的缓冲区大小。该指令是 NGINX 上传模块的一部分，该模块支持上传文件并对请求中的每个文件分别处理。通过调整缓冲区大小，可以优化上传过程，尤其是对于较大的文件，因为它决定了在写入磁盘或进一步处理之前临时存储在内存中的数据量。
在上传文件时，该指令接受一个参数，用于定义缓冲区的字节大小。该设置可在 HTTP、server 或 location 块等上下文中使用。较小的缓冲区可能由于更频繁的写入而导致增加的磁盘 I/O，而较大的缓冲区可以通过减少写入次数来提高性能。此外，设置过大的缓冲区可能导致更高的内存消耗，尤其是在发生多个并发上传时。因此，选择一个在内存使用和上传性能之间取得平衡的最佳大小非常重要。
有效使用 upload_buffer_size 指令的方式是将其与其他设置（例如确定存储上传文件位置的 upload_store 和指定文件上传后如何处理请求的 upload_pass）结合使用。结合这些指令可以实现高效的上传处理和管理。
配置示例
location /upload {
upload_buffer_size 16k;
upload_pass /upload_handler;
upload_store /var/uploads;
}⚠
将缓冲区大小设置得过低可能会降低文件上传的性能，导致响应延迟。
⚠
使用比所需更大的缓冲区大小可能会导致内存使用过多，尤其是在高并发上传时。