在现代 web 开发和运维中，Nginx 作为一款高性能的 HTTP 服务器和反向代理服务器，被广泛应用于各种场景，其强大的 URL 重写功能更是成为众多开发者手中的利器，本文将从基本概念、指令详解、常见场景及实战案例四个方面，深入解析 Nginx 的 URL 重写功能，帮助读者更好地理解和应用这一强大工具。

一、URL 重写的基本概念

URL 重写是 Nginx 提供的一种机制，允许服务器根据预定义的规则动态地修改请求的 URL，这种修改对用户来说是透明的，即用户看到的仍然是原始的 URL，但服务器端可以根据新的 URL 进行相应的处理，URL 重写在很多场景下都非常有用，比如美化 URL、实现 SEO 友好的链接、处理旧链接的迁移等。

二、Nginx 中的 URL 重写指令

1. rewrite 指令

rewrite 指令是 Nginx 中用于 URL 重写的核心指令，它的基本语法如下：

rewrite <匹配规则> <重写目标> [标志];

匹配规则：通常是一个正则表达式，用于匹配请求的 URL。

重写目标：是新的 URL，当匹配规则成立时，Nginx 会将请求的 URL 重写为这个目标。

标志（可选）：控制重写的行为，常见的标志有：

last：停止当前的 rewrite 匹配，并重新搜索新的 location 块（即继续匹配新的规则）。

break：停止当前 location 块中的规则匹配，执行后续指令。

redirect：返回临时重定向（302），并将替换后的字符串作为重定向的目标。

permanent：返回永久重定向（301），并将替换后的字符串作为重定向的目标。

2. try_files 指令

try_files 指令用于检查一系列文件是否存在，如果文件存在则继续处理，否则进行 URL 重写，它常用于静态资源的处理，例如检查文件是否存在，如果不存在，则重写请求到某个页面（通常是首页或错误页面），其基本语法如下：

try_files <文件1> <文件2> ... <重写目标>;

三、常见的 URL 重写场景及示例

1. 实现友好 URL

友好 URL 是将复杂的、包含查询参数的 URL 转换为简洁、易读的形式，将 http://example.com/product.php?id=123 重写为 http://example.com/product/123。

server {
    listen 80;
    server_name example.com;
    location /product {
        rewrite ^/product/(\d+)$ /product.php?id=$1 last;
    }
    location ~ \.php$ {
        fastcgi_pass unix:/var/run/php/php7.4-fpm.sock;
        fastcgi_index index.php;
        include fastcgi_params;
    }
}

2. 实现 301/302 重定向

301 重定向是永久重定向，告诉搜索引擎这个页面已经被永久移动；302 重定向是临时重定向，表示页面将暂时被移动到新的 URL。

server {
    listen 80;
    server_name example.com;
    # 301 永久重定向
    location = /old-page {
        return 301 /new-page;
    }
    # 302 临时重定向
    location = /temp-page {
        return 302 /another-page;
    }
}

3. 将非 www 域名重定向到 www 域名

为了统一网站的访问入口，通常需要将所有非 www 的请求重定向到 www 域名。

server {
    listen 80;
    server_name example.com;
    return 301 http://www.example.com$request_uri;
}
server {
    listen 80;
    server_name www.example.com;
    location / {
        root /var/www/html;
        index index.html;
    }
}

4. 根据条件进行重写

Nginx 还可以基于不同的条件（如请求头、IP 地址、用户代理等）进行 URL 重写，只允许特定 IP 访问某个页面：

server {
    listen 80;
    server_name example.com;
    location /admin {
        allow 192.168.1.0/24; # 只允许特定 IP 段访问
        deny all; # 拒绝其他所有请求
        proxy_pass http://backend/admin;
    }
}

四、实战案例分析

假设我们有一个博客网站，希望将旧的 URL 格式（如 http://blog.example.com/post?id=123）重写为新的 URL 格式（如 http://blog.example.com/post/123），并且希望将所有非 www 的请求重定向到 www 域名，以下是完整的 Nginx 配置示例：

http {
    server {
        listen 80;
        server_name example.com;
        return 301 http://www.example.com$request_uri; # 将非 www 重定向到 www
    }
    server {
        listen 80;
        server_name www.example.com;
        location /post {
            rewrite ^/post(\?id=\d+)?$ /post/$arg_id permanent; # 重写旧的 URL 格式到新的 URL 格式
        }
        location /post/ {
            proxy_pass http://backend/post; # 将请求代理到后端服务器
        }
    }
}

在这个配置中，我们首先通过一个 server 块捕获所有非 www 的请求，并将其永久重定向到 www 域名，在另一个 server 块中，我们定义了一个 location 块来匹配新的 URL 格式（/post/<id>），并将其代理到后端服务器，我们还使用 rewrite 指令将旧的 URL 格式（/post?id=<id>）重写为新的 URL 格式。

Nginx 的 URL 重写功能非常强大且灵活，通过合理利用这一功能，我们可以实现各种复杂的 URL 处理需求，本文从基本概念、指令详解、常见场景及实战案例四个方面对 Nginx 的 URL 重写功能进行了深入解析，希望能够帮助读者更好地理解和应用这一工具，在实际开发中，建议根据具体需求进行测试和调整，以确保配置的正确性和高效性。