nginx rewrite

最新推荐文章于 2025-04-26 23:37:25 发布

jxluoix

最新推荐文章于 2025-04-26 23:37:25 发布

阅读量97

点赞数

分类专栏： nginx 文章标签：运维

本文链接：https://blog.youkuaiyun.com/jxluoix/article/details/84830999

版权

nginx 专栏收录该内容

1 篇文章

订阅专栏

本文详细介绍了 Nginx 中 rewrite 指令的使用方法，包括语法、标志及实例。rewrite 指令能够根据正则表达式匹配请求 URI，并按指定方式改变 URI。文章还提供了配置示例，帮助读者更好地理解和应用该指令。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

Syntax:	`rewrite regex replacement [flag];`
Default:	—
Context:	`server`, `location`, `if`

If the specified regular expression matches a request URI, URI is changed as specified in the replacement string. The rewrite directives are executed sequentially in order of their appearance in the configuration file. It is possible to terminate further processing of the directives using flags. If a replacement string starts with “http://” or “https://”, the processing stops and the redirect is returned to a client.

An optional flag parameter can be one of:

last

stops processing the current set of ngx_http_rewrite_module directives and starts a search for a new location matching the changed URI;

break

stops processing the current set of ngx_http_rewrite_module directives as with the breakdirective;

redirect

returns a temporary redirect with the 302 code; used if a replacement string does not start with “ http://” or “ https://”;

permanent

returns a permanent redirect with the 301 code.

The full redirect URL is formed according to the request scheme ($scheme) and theserver_name_in_redirect and port_in_redirect directives.

Example:

server {
    ...
    rewrite ^(/download/.*)/media/(.*)\..*$ $1/mp3/$2.mp3 last;
    rewrite ^(/download/.*)/audio/(.*)\..*$ $1/mp3/$2.ra  last;
    return  403;
    ...
}

But if these directives are put inside the “/download/” location, the last flag should be replaced by break, or otherwise nginx will make 10 cycles and return the 500 error:

location /download/ {
    rewrite ^(/download/.*)/media/(.*)\..*$ $1/mp3/$2.mp3 break;
    rewrite ^(/download/.*)/audio/(.*)\..*$ $1/mp3/$2.ra  break;
    return  403;
}

If a replacement string includes the new request arguments, the previous request arguments are appended after them. If this is undesired, putting a question mark at the end of a replacement string avoids having them appended, for example:

rewrite ^/users/(.*)$ /show?user=$1? last;

If a regular expression includes the “}” or “;” characters, the whole expressions should be enclosed in single or double quotes.

1、http://nginx.org/en/docs/http/ngx_http_rewrite_module.html#rewrite