Linux怎么配置Nginx返回自定义Header Nginx响应头修改详解
在配置Nginx时，给响应加上自定义Header是再常见不过的操作了。无论是用于环境标识、链路追踪，还是传递一些业务信息，都离不开它。但就是这么个看似简单的指令，里面藏着不少容易踩坑的细节。今天，我们就来聊聊几个关键的配置要点，帮你把自定义Header这事儿安排得明明白白。 add_header 只
在配置Nginx时，给响应加上自定义Header是再常见不过的操作了。无论是用于环境标识、链路追踪，还是传递一些业务信息，都离不开它。但就是这么个看似简单的指令，里面藏着不少容易踩坑的细节。今天，我们就来聊聊几个关键的配置要点，帮你把自定义Header这事儿安排得明明白白。
add_header 只在特定状态码下生效，不是所有响应都带
这里有个最容易被忽略的“默认行为”：add_header指令，默认只对200、201、204、206这些成功状态码，以及301、302、304、307、308这些重定向状态码生效。换句话说，如果你的接口返回了400、401、404甚至500错误，那么你精心配置的自定义Header，客户端是收不到的。
怎么解决？很简单，加上always参数就行：
add_header X-Env "staging" always;
这样一来，无论后端返回什么状态码，这个Header都会稳稳地出现在响应里。不过，需要提醒一点：对于一些安全敏感的Header，比如Set-Cookie，加上always参数可能会被浏览器拒绝，具体使用时还得结合业务场景来判断。
- 不加
always：适合那些只在业务正常响应时才需要透出的标识，比如X-Request-ID。 - 加
always：适合调试类Header（如X-Backend、X-Route）或需要全链路监控的埋点信息。 - 另外要注意继承规则：如果在
location块里使用了add_header，它会覆盖server块中同名的Header；如果location块里没声明，则会继承上级的配置。
多个域名要差异化 Header，别硬写一堆 server 块
当你的服务有多个域名，比如api.example.com、admin.example.com、docs.example.com，并且需要为它们设置不同的服务标识Header时，最笨的办法就是在每个server块里重复写一遍add_header X-Service "xxx"。这不仅维护起来麻烦，还容易漏配或写错。
更优雅的解决方案是使用map指令，在http块里预定义变量：
map $host $x_service {
api.example.com "api";
admin.example.com "admin";
docs.example.com "docs";
default "unknown";
}
定义好之后，就可以在任意server或location中复用了：
add_header X-Service $x_service;
使用map时，有几个细节需要留意：
map指令必须写在http块内，不能放在server或location里。- 它的匹配是精确的字符串比对，不支持通配符。如果你想匹配
*.example.com这样的模式，需要使用正则表达式，比如~^.*\.example\.com$。 - 如果变量值为空，那么对应的Header就不会被发送。所以，设置一个
default兜底项是个好习惯。
想往请求头（Request Header）里加字段？proxy_set_header 才是正解
这是一个常见的误解：add_header是用来修改Nginx发给客户端的响应头的。如果你想在Nginx将请求转发给后端（如Node.js、Ja va应用）时，往请求头里添加一些字段，让后端的req.headers['x-domain']能拿到当前域名，那就必须用proxy_set_header。
典型的配置长这样：
location / {
proxy_pass https://backend;
proxy_set_header X-Domain $host;
proxy_set_header X-Real-IP $remote_addr;
}
关于proxy_set_header，有几点需要明确：
- 它会覆盖原始的请求头。例如，你配置了
proxy_set_header Host $host，那么后端服务看到的Host头就是Nginx接收请求时的$host，而不是客户端最初发来的那个。 - 如果你想保留客户端的原始
User-Agent等信息，需要显式地传递：proxy_set_header User-Agent $http_user_agent。 - 对于包含下划线的非标准Header名（比如
X-Tenant-ID），默认会被Nginx过滤掉。如果确实需要，得在http块里加上underscores_in_headers on;来允许下划线。
add_trailer 和 add_header 的区别不只是位置
从名字上看，add_trailer似乎只是把Header放在了响应体的末尾。但实际上，它的适用场景要狭窄得多。它主要用在分块传输编码（chunked encoding）且响应体较大的情况下，比如视频流、Server-Sent Events (SSE) 或者大文件下载时传递进度信息。对于普通的JSON API接口，几乎用不到它。
add_trailer有几个关键限制：
- 它不支持
always参数（在Nginx 1.19+版本中才支持）。 - 它仅对200、201、206、301–303、307–308这些状态码生效，并且要求响应体没有被压缩（即gzip关闭或未触发压缩）。
- 在浏览器的开发者工具网络面板里，你是看不到Trailer Header的，需要使用
curl -i或者专门的抓包工具才能查看到。
所以，除非你确实在处理流式传输或自定义协议透传这类特殊场景，否则，老老实实用add_header就对了。别仅仅因为“末尾”这个字眼，就强行去用add_trailer，那只会给自己增加不必要的复杂度。
WPS Office是一款面向macOS用户的综合办公套件，将文字处理、电子表格、演示文稿、PDF工具、模板与云协作整合在同一应用中。它兼容常见Microsoft Office格式，支持Intel及Apple芯片Mac，基础功能可免费使用，
Shapr3D是一款面向工业设计、机械工程、建筑概念和三维打印工作流的CAD软件。Mac版采用Parasolid建模内核，支持草图约束、实体建模、工程图、可视化渲染及常见CAD格式交换，并可通过账户在多台设备之间同步项目。
REAPER是Cockos开发的数字音频工作站，提供多轨音频与MIDI录制、剪辑、处理、混音和母带制作工具。Mac版兼容Intel与Apple芯片，支持AU、VST、VST3、CLAP等插件格式，并提供高度可定制的工作流程。
Ableton Live 是面向音乐制作人与现场表演者的数字音频工作站，提供编曲视图、独具特色的现场视图、音频录制、MIDI创作、实时变速、乐器及效果器。Mac版原生支持Apple芯片，并可连接音频接口、MIDI控制器和第三方插件。
Adobe After Effects 是面向动态图形、影视特效与视频合成的专业创作软件。它提供关键帧动画、遮罩抠像、运动跟踪、三维空间、文字动画和表达式等工具，并可与 Premiere Pro、Photoshop、Illustrator
Adobe Audition 是面向播客、影视后期、音乐制作及内容创作者的专业音频工作站，提供波形精修、多轨录制与混音、频谱编辑、降噪修复、响度匹配和效果处理工具，并可与 Adobe Premiere 协同完成视频声音制作。
Adobe Bridge 是面向摄影师、设计师及内容团队的免费数字资产管理工具，可集中预览照片、视频和 Adobe 项目文件，并利用评级、标签、关键词、元数据、筛选与收藏集完成分类检索。它还支持批量重命名、格式导出、相机导入及 Camera
Adobe Illustrator 是 Adobe 推出的专业矢量图形设计软件，适合在 Mac 上制作标志、图标、插画、包装、信息图及印刷版面。它以路径和锚点构建可无损缩放的图形，并提供钢笔、形状、文字、图像描摹、渐变、画板及生成式功能。
Adobe InDesign 是面向印刷品与数字出版物的专业版面设计软件，可在 Mac 上制作书籍、杂志、宣传册、海报、报告及交互式文档。它提供精细的文字样式、网格、母版、长文档管理和印前输出能力。
Adobe Lightroom Classic 是面向桌面摄影工作流的照片管理与后期处理软件，可将原始照片保存在本地硬盘，通过目录、关键词、评分和收藏夹高效整理图库，并提供 RAW 冲印、蒙版、镜头校正、批量同步及多格式导出等功能。
Adobe Media Encoder 是 Adobe 推出的专业音视频编码与转码工具，可通过队列、预设和监视文件夹批量完成格式转换、代理文件创建及多平台成片输出，并与 Premiere Pro、After Effects 等软件紧密协作。
Adobe Photoshop 是面向摄影师、设计师和内容创作者的专业图像处理软件，提供图层、蒙版、选区、修复、调色、文字排版、智能对象及生成式编辑等能力。Mac 版支持 Intel 与 Apple Silicon 处理器。
Adobe Photoshop 是面向摄影师、设计师和内容创作者的专业图像处理工具，可在 Windows 上完成照片修饰、选区抠图、图层合成、文字排版、绘画及生成式编辑。软件采用订阅授权，由 Creative Cloud 管理安装、更新与许
Adobe InDesign 是面向印刷与数字出版的专业页面排版工具，可制作书籍、杂志、宣传册、海报、交互式 PDF 和电子书。它提供精细的文字样式、多页面管理、印前检查及多格式输出能力，并能与 Photoshop、Illustrator
Adobe Illustrator 是用于绘制矢量图形、插画、图标、徽标和版式的专业设计工具。它以路径和锚点为核心，作品放大后仍能保持清晰，并提供画板、文字、渐变、图像描摹及精确变换等功能，适合品牌视觉、印刷物料、数字界面和商业插画创作。
Adobe Bridge 是 Adobe 推出的创意资产管理工具，可集中预览、分类和查找照片、视频、PDF及多种设计文件，并支持元数据、关键词、评级、批量重命名和格式导出。它可与 Photoshop、Illustrator 等应用衔接，
Affinity Photo 是一款面向摄影师、修图师和视觉设计人员的桌面图像编辑工具，提供 RAW 显影、多图层合成、蒙版、实时滤镜、批处理和色彩管理等功能。原独立产品已停止销售，其照片编辑能力已延续至免费的新 Affinity 应用；
Adobe Lightroom Classic 是面向 Windows 桌面摄影工作流的照片管理与无损编辑工具，可通过目录集中整理大型图库，并完成 RAW 显影、局部蒙版、批量调整、打印和多格式导出。它强调本地文件管理与精细控制，
Figma 是面向产品设计与开发团队的云端协作平台，可在 Windows 桌面客户端中完成界面绘制、组件管理、交互原型、评论评审和开发交付。文件保存在云端，多名成员能够同步编辑并共享设计系统；官方同时提供免费 Starter 方案及按席位计
Affinity Designer 是面向矢量图形、数字插画和界面设计的专业创作工具，可在矢量、像素与导出工作区之间快速切换。它提供曲线编辑、形状构建、画板、排版、图层和专业色彩管理，并支持常见设计文件的导入及多种印刷、网页格式输出。
Capture One Pro 是面向摄影师和影像团队的专业桌面照片处理工具，提供相机定制色彩配置、RAW转换、图层与蒙版、联机拍摄、目录及会话管理等功能。它适合棚拍、人像、商业产品、婚礼和风光摄影，
Adobe Acrobat Pro 是面向专业 PDF 工作的综合解决方案，可在 Windows 中创建、编辑、转换、比较、整理和保护文档，并支持表单、电子签名、扫描件文字识别及敏感信息永久遮盖。订阅还包含网页、移动服务和云端协作能力，
Adobe After Effects 是面向动态图形、动画与影视视觉特效制作的专业工具，可完成关键帧动画、图层合成、遮罩跟踪、抠像、文字动画和二维三维元素整合。Windows 版通过 Adobe Creative Cloud 安装及更新，
DaVinci Resolve是Blackmagic Design推出的一体化影视后期工具，将素材管理、非线性剪辑、专业调色、Fusion视觉特效、Fairlight音频处理和成片交付整合在统一工程中。免费版已覆盖多数个人创作需求，