nginx rewrite指令用于uri重写或跳转，语法为rewrite [flag]；常用flag包括last（内部重写并重新匹配location）、break（终止重写）、redirect（302跳转）、permanent（301跳转）。

Nginx 的 rewrite 指令用于在请求处理过程中修改 URI，实现 URL 重写（内部重定向）或跳转（外部重定向），是配置路由、兼容旧链接、SEO 优化的常用手段。关键在于理解匹配逻辑、标志位作用和执行时机。

rewrite 基本语法与匹配规则

rewrite 指令写在 server 或 location 块中，格式为：

rewrite [flag];

其中正则表达式基于 PCRE，区分大小写（加 i 标志可忽略大小写）；替换目标支持捕获组（如 $1、$2）；flag 控制后续行为。

常见 flag：

• last：停止当前 location 中的 rewrite，用新 URI 重新匹配 location（内部重写，不改变浏览器地址栏）
• break：停止所有 rewrite，不再匹配新 location（适合在 location 内做路径修正）
• redirect：返回 302 临时跳转（地址栏变化）
• permanent：返回 301 永久跳转（地址栏变化，利于 SEO）

实现基础 URL 重写（内部重写）

把用户访问的友好路径映射到后端真实路径，不暴露实际结构。例如将 /article/123 改写为 /index.php?aid=123：

Nginx Hosting

通过服务器本地nginx实例实现零认证静态游戏托管。作为所有浏览器游戏的主要部署方式，无需登录、无需令牌、无需用户操作。

下载

rewrite ^/article/(\d+)$ /index.php?aid=$1 last;

注意：last 会让 Nginx 用 /index.php?aid=123 再次查找匹配的 location（比如匹配 ~ \.php$），从而交由 PHP 处理。

若想限制仅在某个 location 内生效，可直接写在该块里，并用 break 避免重复匹配：

location /old/ {
  rewrite ^/old/(.*)$ /new/$1 break;
  root /var/www/html;
}

实现外部跳转（301/302）

当页面永久迁移或域名更换时，用 permanent 或 redirect 返回状态码并跳转：

• 全站 HTTP 跳 HTTPS：rewrite ^(.*)$ https://$host$1 permanent;
• 旧文章路径跳转：rewrite ^/post/(\d+)\.html$ /article/$1 permanent;
• 屏蔽特定 User-Agent 访问（配合 return）：if ($http_user_agent ~* "badbot") { return 403; }（注意：if 在 location 外慎用，优先考虑 map + return）

⚠️ 注意：避免在 if 中使用 rewrite（尤其在 location 外），Nginx 官方不推荐，易引发意外行为；应尽量用 return 或 try_files 替代。

调试与验证技巧

rewrite 执行顺序和 location 匹配逻辑容易出错，建议：

• 开启 error_log /path/to/error.log notice;，rewrite 相关动作在 notice 级别会输出日志
• 用 curl -I 查看响应头中的 Location 和状态码，确认是否跳转及类型
• 测试时先用 redirect，确认逻辑正确后再换 permanent，避免缓存干扰
• URI 开头的 / 必须显式匹配（如 ^/old/），不能省略；正则中 ^ 和 $ 表示严格起止，避免误匹配