upload_add_header
upload_add_header 指令在文件上传过程中向 HTTP 响应添加自定义头部。
NGINX module for handling file uploads
·
httpserverlocationif in locationlimit_except
语法upload_add_header name value;
默认值none
上下文http, server, location, if in location, limit_except
参数2
说明
upload_add_header 指令在 NGINX 的 upload 模块中使用，用于定义在文件上传后应包含在发送回客户端的响应中的额外 HTTP 头部。该指令接受两个参数：头名称及其对应的值。在处理 multipart/form-data 文件上传时，NGINX 可以添加这些头部以提供元数据或辅助处理与上传操作相关的信息。此类自定义头部对于客户端应用程序了解如何进一步处理或处理已上传的数据非常有用，例如指示上传的状态或提供额外的参考信息。
该指令可以在多个上下文中使用，包括 http、server、location，或在 location 块内的 if 语句中。其灵活性允许开发者根据上传过程的特定位置或条件定制头部输出。重要的是，通过 upload_add_header 添加的头部总是在成功响应中添加，即在上传请求的所有处理完成之后。因此，该指令的放置和相关逻辑会大大影响客户端在尝试文件上传后收到的 HTTP 响应的结果和行为。
配置示例
location /upload {
upload_pass /upload_handler;
upload_add_header X-Upload-Status "Completed";
}⚠
确保您添加的头部不会与现有头部冲突。
⚠
应适当设置头部，以避免带来安全隐患，例如暴露敏感信息。
⚠
对头部值使用正确的语法，以防止误配置。