Nginx重定向

在 Nginx 中，URL 重定向的配置通常使用 `rewrite` 指令来实现。通过正则表达式匹配请求的 URI，并根据规则将请求重定向到新的 URL。以下是一些常见的配置示例和说明： ### 基本语法 ```nginx rewrite 正则表达式 替换字符串 标志; ``` - **正则表达式**：用于匹配请求的 URI。 - **替换字符串**：当正则表达式匹配成功时，URI 将被替换为该字符串。 - **标志**：控制重写行为，常用的有： - `last`：停止处理当前的重写规则，并重新开始新的 location 匹配。 - `break`：停止处理当前的重写规则，不再继续执行后续的规则。 - `redirect`：返回一个 HTTP 302 临时重定向。 - `permanent`：返回一个 HTTP 301 永久重定向。 ### 示例配置 #### 1. 简单的 URL 重定向 将 `/old-path` 重定向到 `/new-path`： ```nginx rewrite ^/old-path$ /new-path permanent; ``` 这会返回一个 HTTP 301 永久重定向，告诉客户端新的 URL 是 `/new-path` [^3]。 #### 2. 使用正则表达式捕获参数 将 `/user/123` 重定向到 `/profile?id=123`： ```nginx rewrite ^/user/(\d+)$ /profile?id=$1? redirect; ``` 这里的 `(\d+)` 会捕获数字，并通过 `$1` 引用它。`?` 表示丢弃原始请求中的查询参数 [^2]。 #### 3. 多个条件判断 可以结合 `if` 指令进行更复杂的条件判断。例如，只有当用户访问特定域名时才进行重定向： ```nginx if ($host = 'example.com') { rewrite ^(.*)$ http://www.example.com$1 permanent; } ``` 此配置检查 `$host` 变量是否等于 `example.com`，如果是，则将所有请求重定向到 `http://www.example.com` [^1]。 #### 4. 结合 `location` 使用 可以在 `location` 块中使用 `rewrite` 来处理特定路径下的请求。例如，将 `/images/old-image.jpg` 重定向到 `/static/images/new-image.jpg`： ```nginx location /images/ { rewrite ^/images/(.*)\.jpg$ /static/images/$1.png break; } ``` 此配置将 `.jpg` 文件重命名为 `.png` 并移动到 `/static/images/` 目录下 [^4]。 #### 5. 返回特定状态码 如果需要直接返回某个 HTTP 状态码而不进行重定向，可以使用 `return` 指令： ```nginx location /forbidden/ { return 403; } ``` 这会直接返回 403 Forbidden 状态码给客户端 [^5]。 ### 注意事项 - 在配置重定向时，确保正确使用 `break` 或 `last` 标志以避免无限循环或不必要的重复处理。 - 如果希望 Nginx 始终使用客户端提供的 `Host` 头来进行重定向，可以在 `server_name` 中使用通配符 `*`。 - 对于相对重定向（不包含主机名），Nginx 默认会使用 `server_name` 中的第一个名称或本地主机名。 ### 完整示例 以下是一个完整的 Nginx 配置文件片段，展示了如何结合多种重定向规则： ```nginx server { listen 80; server_name example.com www.example.com; # 简单重定向 rewrite ^/old-path$ /new-path permanent; # 参数捕获 rewrite ^/user/(\d+)$ /profile?id=$1? redirect; # 条件判断 if ($host = 'example.com') { rewrite ^(.*)$ http://www.example.com$1 permanent; } # 结合 location location /images/ { rewrite ^/images/(.*)\.jpg$ /static/images/$1.png break; } # 返回特定状态码 location /forbidden/ { return 403; } } ``` ---