怎样用nginx实现URL重写

ubuntu

小樊

2026-01-09 11:22:27

栏目: 编程语言

使用Nginx实现URL重写（URL Rewriting）可以通过配置rewrite指令来完成。以下是一些基本的步骤和示例，帮助你理解如何使用Nginx进行URL重写。

基本语法

Nginx的rewrite指令基本语法如下：

rewrite <pattern> <replacement> [flag];

<pattern>: 要匹配的正则表达式。
<replacement>: 替换后的URL。
[flag]: 可选的重写标志，例如last, break, redirect, permanent等。

示例

1. 简单的URL重写

假设你想将所有以/oldpage开头的URL重写为/newpage：

server {
    listen 80;
    server_name example.com;

    location /oldpage {
        rewrite ^/oldpage$ /newpage permanent;
    }
}

2. 使用正则表达式进行复杂重写

假设你想将所有以/category/开头的URL重写为/products/category/：

server {
    listen 80;
    server_name example.com;

    location /category/ {
        rewrite ^/category/(.*)$ /products/category/$1 last;
    }
}

3. 重定向到HTTPS

如果你想将所有HTTP请求重定向到HTTPS：

server {
    listen 80;
    server_name example.com;
    return 301 https://$host$request_uri;
}

server {
    listen 443 ssl;
    server_name example.com;

    ssl_certificate /path/to/certificate.pem;
    ssl_certificate_key /path/to/privatekey.pem;

    # 其他配置...
}

4. 重写并保留查询参数

假设你想将/search?q=example重写为/search-results?query=example并保留查询参数：

server {
    listen 80;
    server_name example.com;

    location /search {
        rewrite ^/search$ /search-results last;
    }

    location /search-results {
        # 处理重写后的URL
        # 可以使用$arg_query来访问原始的查询参数
        get $query $args;
        proxy_pass http://backend_server/search?query=$query;
    }
}

注意事项

顺序：Nginx的rewrite指令按照配置文件中的顺序执行，因此要确保更具体的规则放在前面。
标志：使用适当的重写标志来控制重写行为，例如last会停止处理当前的重写规则并开始新的请求，break会停止处理当前的重写规则但不开始新的请求。
测试：在生产环境中应用重写规则之前，务必在测试环境中进行充分测试，以确保重写规则按预期工作。

通过以上步骤和示例，你应该能够使用Nginx实现基本的URL重写。根据具体需求，你可以进一步调整和扩展这些规则。