Nginx 第6页

问题背景：为什么查询参数总是丢？ 配置 Nginx 重定向时，很多人遇到过这样的怪事：访问 /search?q=nginx，跳转后变成了 /new-search，参数 q=nginx 不见了。 或者更糟：参数被重复拼接了两次，变成 ?q=nginx?q=nginx。 根本原因是：Nginx 的 return 和 rewrite 在处理查询参数时的行为完全不同，而大多数人并不知道 $is_args 和 $args 这两个变量的存在。 核心变量：先搞懂这三个东西 在讲最佳实践之前...

三个变量各自是什么？ 在Nginx重定向和rewrite配置中，$is_args、$args、$request_uri 这三个变量几乎每次都要用到，但很多人分不清它们的区别，导致重定向后查询参数丢失、URL拼接出错等问题。本文用实际例子把这三个变量讲清楚，让你再也不踩坑。 $request_uri：完整的原始请求URI（含参数） $request_uri 是Nginx内置变量，表示客户端发来的原始请求URI，包含问号及后面的全部查询参数，并且不会被rewrite指令修改。...

什么是HSTS max-age？ HSTS（HTTP Strict Transport Security）通过Strict-Transport-Security响应头告诉浏览器：在未来一段时间内，这个域名只允许通过HTTPS访问。 其中max-age参数就是那个"一段时间"，单位是秒。比如： [代码示例已省略，请参考正文] 意思是：接下来31536000秒（1年）内，浏览器都必须用HTTPS访问这个域名。 max-age设置为0到底会发生什么？ 把max-age设置为0，本...

UTM参数丢失的常见场景 做网站运营的朋友应该都遇到过这样的问题：精心准备的营销活动上线后，打开Google Analytics一看，流量来源全变成了直接访问或未知来源，UTM参数仿佛人间蒸发了。这背后的罪魁祸首，往往是HTTP跳转HTTPS时参数丢失。 场景一：营销邮件点击链接 用户收到邮件，点击带UTM参数的链接，结果跳转过程中参数全部消失。典型的链接格式如：?utm_source=newsletter&utm_medium=email&utm_camp...

问题现象：安全头在错误页面消失了 很多人在 Nginx 里配置了 HSTS、X-Frame-Options 等安全响应头，用 curl 访问正常页面时一切正常，但一旦访问一个不存在的 URL，返回 404 时，这些安全头全部消失了。 这不是 Nginx 的 bug，而是 add_header 指令的默认行为。 add_header 的默认生效条件 Nginx 官方文档对 add_header 的说明里有一句话： Adds the specified field to a r...

一、先搞清楚：rewrite 和 return 各自是什么 在说参数行为差异之前，先把这两个指令的本质搞清楚。 rewrite 是 Nginx 的 URL 重写指令，它在服务器内部对请求的 URI 进行修改之后，继续用修改后的 URI 走后续的过滤链。说白了，它更像是一次"内部改写"，浏览器地址栏的 URL 可能不变。 return 是 Nginx 的响应返回指令，它直接向客户端发送一个指定的响应（可以是 301/302 重定向、444 关闭连接，或者直接返回内容）。它是一次...

引言：为什么不能直接上31536000？ HSTS（HTTP Strict Transport Security）的 max-age 参数决定了浏览器记住"只走HTTPS"指令的时间长度。很多教程一上来就让你设 max-age=31536000（一年），但这其实是个坑。 如果你配错了、或者证书部署有问题，用户一年内都无法访问你的HTTP版本——哪怕你后来修好了。所以正确的做法是两个阶段：先用小值测试，确认无误后再切换到正式值。 HSTS max-age 基础回顾 HSTS响...

为什么UTM参数在Nginx重定向中总是丢失？很多网站管理员在配置HTTP到HTTPS重定向时，发现Google Analytics的流量来源追踪突然失效了。用户明明是从社交媒体或邮件营销链接过来的，UTM参数却在重定向过程中丢失，导致所有流量都被归为"直接访问"。这个问题的根源在于Nginx的return指令默认不会自动附加原始请求的查询参数。当你使用return 301 https://$host$request_uri;这样的配置时，如果原始请求的URL包含?utm_s...

前言：一个问号引发的血案 写Nginx重定向规则的时候，你有没有遇到过这种情况：明明配置了rewrite，跳转后URL里的查询参数却凭空消失了？utm_source、page、id这些参数，一个都不剩。折腾半天，最后发现问题出在rewrite规则里一个小小的问号（?）上。 今天这篇文章，我就把Nginx rewrite中问号的含义彻底讲清楚，让你以后写重定向规则不再踩坑。 一、rewrite指令的基本语法 先复习一下rewrite的基本格式： rewrite regex r...

配好了 HSTS，响应头却迟迟不出现？很多人在 Nginx 上配置完 Strict-Transport-Security 之后，第一反应就是打开浏览器访问网站，结果一看响应头——什么都没有。本质上这不是什么疑难杂症，大多数时候问题出在几个容易忽略的地方。这篇文章把 HSTS 不生效的常见原因逐一梳理，并给出对应的解决方法。 HSTS 是什么，配置逻辑要先搞清楚 在说排查方法之前，先把 HSTS 的基本逻辑理清楚。Strict-Transport-Security 响应头告诉...