ngx_link_func_add_req_header
ngx_link_func_add_req_header 指令将指定的 HTTP 请求头添加到 NGINX 服务器配置的上下文中。
The Application dynamic linking with Nginx
·
httpserverlocationif in location
语法ngx_link_func_add_req_header header_name header_value;
默认值none
上下文http, server, location, if in location
参数2
说明
ngx_link_func_add_req_header 指令在 NGINX 中用于添加自定义 HTTP 请求头。它接受两个参数：第一个是要添加的头名，第二个是分配给该头的值。该指令使任何与 NGINX 关联的动态链接函数或应用在处理传入请求时能够访问这些头。它特别用于旨在通过附加元数据增强 HTTP 请求处理的模块，这些元数据可被链接功能使用。\n\n在配置此指令时，可将其放在多个上下文中，包括 http、server、location 以及 location 块内的 if。正确使用此指令以确保在 NGINX 提供请求时添加预期的头非常重要。配置错误可能导致头被省略或发送了不正确的值，可能影响上游服务的行为或最终用户收到的响应。理解指令的顺序及其上下文有助于掌握此指令的正确用法。
配置示例
server {
listen 80;
location /example {
ngx_link_func_add_req_header "X-Custom-Header" "This is a custom header";
}
}⚠
确保头部名称有效且格式正确，以符合 HTTP 标准。
⚠
应在适当的上下文中添加头部，以确保它们随正确的请求一起发送。
⚠
在头部中使用动态值时要谨慎，否则如果未正确处理，可能会引入意外行为。