一、初识add_header：响应头的魔法棒
在Web服务器的世界里，响应头就像是快递包裹上的面单，告诉浏览器这个包裹该怎么处理。而Nginx的add_header指令，就是让我们能够自由定制这张面单的神奇工具。想象一下，你可以给每个包裹贴上"易碎品"、"加急"或者"需要冷藏"的标签，是不是很酷？
让我们先看个最简单的例子：
server {
listen 80;
server_name example.com;
location / {
add_header X-Custom-Header "Hello, World!";
return 200 "OK";
}
}
这个配置会给所有响应添加一个自定义头X-Custom-Header。就像在包裹上贴了个"内有惊喜"的标签，让收到的人会心一笑。
二、add_header的基本用法
add_header的语法其实非常简单：
add_header name value [always];
其中name是头字段名，value是头字段值，always是个可选参数，表示即使响应码不是200、204、206等成功状态码也要添加这个头。
让我们看个更实用的例子，配置安全相关的响应头：
server {
listen 443 ssl;
server_name secure.example.com;
add_header X-Frame-Options "SAMEORIGIN";
add_header X-Content-Type-Options "nosniff";
add_header X-XSS-Protection "1; mode=block";
add_header Referrer-Policy "strict-origin-when-cross-origin";
location / {
# 这里可以放你的常规配置
}
}
这些安全头就像是给网站穿上了防弹衣：
X-Frame-Options防止点击劫持X-Content-Type-Options阻止MIME类型嗅探X-XSS-Protection启用XSS过滤Referrer-Policy控制Referer信息的发送
三、add_header的高级技巧
3.1 条件添加响应头
有时候我们需要根据特定条件来添加响应头。比如只给特定路径添加CORS头：
server {
listen 80;
server_name api.example.com;
location /public/ {
add_header Access-Control-Allow-Origin "*";
add_header Access-Control-Allow-Methods "GET, POST, OPTIONS";
add_header Access-Control-Allow-Headers "Content-Type";
# 其他配置...
}
location /private/ {
# 这里不需要CORS头
# 其他配置...
}
}
3.2 使用变量动态设置头值
Nginx的变量系统非常强大，我们可以用它来动态设置头值：
server {
listen 80;
server_name dynamic.example.com;
set $custom_value "default";
location / {
if ($arg_theme = 'dark') {
set $custom_value "dark-mode";
}
add_header X-Theme $custom_value;
# 其他配置...
}
}
这样，当访问/?theme=dark时，响应头中就会包含X-Theme: dark-mode。
3.3 处理特殊情况：always参数
默认情况下，add_header只在响应状态码为200、204、206等成功状态码时才会添加头。但有时候我们需要在错误页面也添加特定头，这时就需要always参数：
server {
listen 80;
server_name error.example.com;
error_page 404 /404.html;
location / {
add_header X-Custom-Header "This is a normal response";
# 其他配置...
}
location = /404.html {
add_header X-Custom-Header "This is a 404 error page" always;
internal;
}
}
四、实战应用场景
4.1 安全加固
现代Web应用面临各种安全威胁，add_header可以帮助我们加固防线：
server {
listen 443 ssl;
server_name bank.example.com;
# 安全头
add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
add_header Content-Security-Policy "default-src 'self'; script-src 'self' 'unsafe-inline' cdn.example.com";
add_header Feature-Policy "geolocation 'none'; microphone 'none'";
# 其他配置...
}
这些配置就像是给网站装上了防盗门、监控摄像头和警报系统：
Strict-Transport-Security强制使用HTTPSContent-Security-Policy控制资源加载来源Feature-Policy限制浏览器功能使用
4.2 性能优化
响应头也可以用来优化性能：
server {
listen 80;
server_name fast.example.com;
location ~* \.(jpg|jpeg|png|gif|ico|css|js)$ {
add_header Cache-Control "public, max-age=31536000";
# 其他静态文件配置...
}
location / {
add_header Cache-Control "no-cache, no-store, must-revalidate";
# 动态内容配置...
}
}
这样配置后，静态资源会被浏览器长期缓存，而动态内容则不会被缓存。
4.3 调试和监控
在开发环境中，我们经常需要添加调试头：
server {
listen 80;
server_name dev.example.com;
location / {
add_header X-Request-ID $request_id;
add_header X-Upstream $upstream_addr;
add_header X-Response-Time $request_time;
# 其他配置...
}
}
这些头信息就像是汽车的仪表盘，让我们可以实时监控：
X-Request-ID用于追踪单个请求X-Upstream显示请求被转发到了哪个后端X-Response-Time记录请求处理时间
五、注意事项和常见陷阱
5.1 继承规则
add_header的继承规则有点反直觉：如果在某个上下文中定义了add_header，那么外层定义的add_header会被完全覆盖。看这个例子：
server {
listen 80;
server_name inherit.example.com;
add_header X-Outer "Outer Header";
location / {
add_header X-Inner "Inner Header";
# 这里响应中只有X-Inner，没有X-Outer
}
}
要解决这个问题，可以这样写：
server {
listen 80;
server_name inherit.example.com;
add_header X-Outer "Outer Header";
location / {
add_header X-Outer "Outer Header";
add_header X-Inner "Inner Header";
}
}
5.2 重复头字段
有时候我们可能会不小心添加重复的头字段：
server {
listen 80;
server_name duplicate.example.com;
location / {
add_header X-Duplicate "First";
add_header X-Duplicate "Second";
# 响应中会包含两个X-Duplicate头
}
}
大多数情况下这不是问题，但有些头字段（如Cache-Control）重复可能会导致意外行为。
5.3 特殊字符处理
如果头值中包含特殊字符，最好用引号括起来：
server {
listen 80;
server_name special.example.com;
location / {
add_header X-Special "This value contains spaces, commas, and other special; chars";
}
}
六、总结
Nginx的add_header指令就像是一把瑞士军刀，小巧但功能强大。通过它，我们可以：
- 增强安全性
- 优化性能
- 方便调试
- 实现各种定制需求
不过也要注意它的继承规则和特殊情况处理。掌握了这些技巧，你就能像指挥家一样，精确控制每一个响应的"音符"，让你的Web应用演奏出更美妙的乐章。
评论