在 nginx 中配置目录重写,核心是使用 rewrite 指令配合正则表达式匹配请求路径,并通过标志位控制跳转行为。通常需要在 location 块中定义规则,将旧路径映射到新路径或触发内部重定向。若需实现永久重定向,应使用 last 或 redirect 标志;若仅为内部路径转换而不改变浏览器地址栏,则使用 break 或 last。

如何配置从根目录到子目录的永久重定向
要实现从根目录访问自动跳转到指定子目录,可以使用 rewrite 指令结合 ^/$ 正则匹配根路径,并设置 permanent 标志返回 301 状态码。这种方式适用于网站结构调整,引导用户访问新位置。

server {
listen 80;
server_name example.com;
# 匹配根路径并重定向到 /app
rewrite ^/$ /app permanent;
location /app {
root /var/www/html;
index index.html;
}
}
当用户访问 http://example.com/ 时,Nginx 会立即返回 301 响应,浏览器地址栏变为 /app。这种配置适合 SEO 友好的站点迁移,确保搜索引擎更新索引。
如何将带参数的动态 URL 重写为静态路径
处理带有查询参数或动态段落的 URL 时,可以通过捕获组提取变量,并将其拼接到新的静态路径中。例如,将 /user?id=123 转换为 /users/123/profile,需要使用正则表达式中的括号进行分组,并在重写目标中引用这些组。

server {
listen 80;
server_name example.com;
# 捕获 id 并重写到静态路径
rewrite ^/user/(.*)$ /users/$1/profile last;
location /users {
root /var/www/html;
try_files $uri $uri/ =404;
}
}
该配置会将包含任意 ID 的用户请求重定向至对应的静态页面。使用 last 标志表示重写完成后重新发起内部搜索,确保 try_files 能正确找到文件。此方法常用于 RESTful API 或前端路由兼容。
当重写规则匹配失败时会发生什么
如果请求路径不匹配任何 rewrite 规则,Nginx 将继续执行后续的 location 匹配逻辑。若所有规则均未命中且未配置默认 location,服务器可能返回 404 错误。因此,建议始终保留一个兜底的 location / 块来处理未匹配的请求。











