nginx rewrite规则怎么配置? 【百科全说】-凯发k8官方旗舰厅

腾讯视频/爱奇艺/优酷/外卖 充值4折起

在url优化过程中，不可避免的涉及到nginx rewrite规则。那么nginx rewrite是如何配置的呢？

rewrite可以出现的地方有4个：ngx_http_srv_conf，ngx_http_sif_conf，ngx_http_loc_conf，ngx_http_lif_conf。分别对应着：

ngx_http_srv_conf：配置文件中的server域中的任何地方；
ngx_http_sif_conf：配置文件中server域中的if配置中；
ngx_http_loc_conf：配置文件中的location域中的任何地方；
ngx_http_lif_conf：配置文件中的location域中的if配置中；

举例如下：

//...
server {
//...
rewrite "^/ $" /index.php break;

if ($uri ~* "^/ abc") {
rewrite "^/ abc" /abc/index.php break;
}

location /xy {
rewrite "^/ xy$" /xy/index.php break;
}
}
?
1
其中location的详细描述和location的强大功能可以在本网站搜索框中输入“ngingx location”来搜索。

补充

1.break指令

默认值：none ;使用环境：server,location,if ;

该指令的作用是完成当前的规则集，不再处理rewrite指令。

2.if指令

默认值：none ;使用环境：server,location

该指令用于检查一个条件是否符合，如果条件符合，则执行大括号内的语句。if指令不支持嵌套，不支持多个条件&&和||处理。

a.变量名，错误的值包括：空字符串""或者任何以0开始的字符串
b.变量比较可以使用"="(表示等于)和"!="(表示不等于)
c.正则表达式模式匹配可以使用"~*"和"~"符号
d."~"符号表示区分大小写字母的匹配
e."~*"符号表示不区分大小写字母的匹配
f."!~"和"!~*"符号的作用刚好和"~"、"~*"相反，表示不匹配
g."-f"和"!-f"用来判断文件是否存在
h."-d"和"!-d"用来判断目录是否存在
i."-e"和"!-e"用来判断文件或目录是否存在
j."-x"和"!-x"用来判断文件是否为可执行
k.部分正则表达式可以在()内，用$1~$9来访问
3.return指令

语法：return code ;使用环境：server,location,if ;

该指令用于结束规则的执行并返回状态码给客户端。

示例：如果访问的url以".sh"或".bash"结尾，则返回403状态码

location ~ .*.(sh|bash)?$
{
return 403;
}
4.rewrite 指令

语法：rewrite regex replacement flag

默认值：none ; 使用环境：server,location,if

该指令根据表达式来重定向uri，或者修改字符串。指令根据配置文件中的顺序来执行。注意重写表达式只对相对路径有效。如果你想配对主机名，你应该使用if语句，示例如下：

if( $host ~* www.(.*) )
{
set $host_without_www $1;
rewrite ^(.*)$ http://$host_without_www$1 permanent;
}

rewrite指令的最后一项参数为flag标记，支持flag标记有：

1.last 相当于apache里面的[l]标记，表示rewrite。

2.break本条规则匹配完成后，终止匹配，不再匹配后面的规则。

3.redirect 返回302临时重定向，浏览器地址会显示跳转后的url地址。

4.permanent 返回301永久重定向， 浏览器地址会显示跳转后的url地址。

使用last和break实现uri重写，浏览器地址栏不变。而且两者有细微差别，使用alias指令必须用last标记;使用proxy_pass指令时，需要使用break标记。last标记在本条rewrite规则执行完毕后，会对其所在server{......}标签重新发起请求，而break标记则在本条规则匹配完成后，终止匹配。

一般在跟location中(location /{...})或直接在server标签中编写rewrite规则，推荐使用last标记；在非根location中(location /cms/{...})，则使用break。

如果uri中含有参数(/app/test.php?id=5)，默认情况下参数会被自动附加到替换串上，你可以通过在替换串的末尾加上?标记来解决这一问题。

例如：

rewrite ^/test(.*)$ http://www.111cn.net/home permanent;
访问http://www.111cn.net/test?id=5 会跳转到 http://www.111cn.net/home?id=5

例如：如果我们将类似url /photo/123456 重定向到 /path/to/photo/12/1234/123456.png

rewrite "/photo/([0-9]{2})([0-9]{2})([0-9]{2})" /path/to/photo/$1/$1$2/$1$2$3.png ;

注：如果正则表达式里面有花括号"{"或"}" ，应该使用双引号或单引号。

5.set指令

语法：set variable value ; 默认值:none ; 使用环境：server,location,if;

该指令用于定义一个变量，并给变量赋值。变量的值可以为文本、变量以及文本变量的联合。

示例：set $varname "hello world";

6.uninitialized_variable_warn指令

语法：uninitialized_variable_warn on|off

使用环境：http,server,location,if

该指令用于开启和关闭未初始化变量的警告信息，默认值为开启。

7.nginx rewrite可以用到的全局变量

$args ,$content_length ,$content_type ,$document_root ,$document_uri ,$host ,$http_user_agent ,$http_cookie ,$limit_rate ,$request_body_file ,$request_method ,$remote_addr ,$remote_port ,$remote_user ,$request_filename ,$request_uri ,$query_string ,$scheme ,$server_protocol ,$server_addr ,$server_name ,$server_port ,$uri

====(详情见附录)====

nginx的rewrite规则编写实例

1.当访问的文件和目录不存在时，重定向到某个php文件

if( !-e $request_filename )
{
rewrite ^/(.*)$ index.php last;
}

2.目录对换 /123456/xxxx ====> /xxxx?id=123456

rewrite ^/(d )/(. )/ /$2?id=$1 last;

3.如果客户端使用的是ie浏览器，则重定向到/ie目录下

if( $http_user_agent ~ msie)
{
rewrite ^(.*)$ /ie/$1 break;
}

4.禁止访问多个目录

location ~ ^/(cron|templates)/
{
deny all;
break;
}

5.禁止访问以/data开头的文件

location ~ ^/data
{
deny all;
}

6.禁止访问以.sh,.flv,.mp3为文件后缀名的文件

location ~ .*.(sh|flv|mp3)$
{
return 403;
}

7.设置某些类型文件的浏览器缓存时间

location ~ .*.(gif|jpg|jpeg|png|bmp|swf)$
{
expires 30d;
}
location ~ .*.(js|css)$
{
expires 1h;
}
8.给favicon.ico和robots.txt设置过期时间;
这里为favicon.ico为99天,robots.txt为7天并不记录404错误日志

location ~(favicon.ico) {

log_not_found off;

expires 99d;

break;

}

location ~(robots.txt) {

log_not_found off;

expires 7d;

break;

}

9.设定某个文件的过期时间;这里为600秒，并不记录访问日志

location ^~ /html/scripts/loadhead_1.js {

access_log off;

root /opt/lampp/htdocs/web;

expires 600;

break;

}

10.文件反盗链并设置过期时间
这里的return 412 为自定义的http状态码，默认为403，方便找出正确的盗链的请求
“rewrite ^/ http://img.111cn.net/leech.gif;”显示一张防盗链图片
“access_log off;”不记录访问日志，减轻压力
“expires 3d”所有文件3天的浏览器缓存

location ~* ^. .(jpg|jpeg|gif|png|swf|rar|zip|css|js)$ {

valid_referers none blocked *.c1gstudio.com *.c1gstudio.net localhost 208.97.167.194;

if ($invalid_referer) {

rewrite ^/ http://img.111cn.net/leech.gif;

return 412;

break;

}

access_log off;

root /opt/lampp/htdocs/web;

expires 3d;

break;

}

11.只充许固定ip访问网站，并加上密码

root /opt/htdocs/www;

allow 208.97.167.194;

allow 222.33.1.2;

allow 231.152.49.4;

deny all;

auth_basic “c1g_admin”;

auth_basic_user_file htpasswd;

12将多级目录下的文件转成一个文件，增强seo效果
/job-123-456-789.html 指向/job/123/456/789.html

rewrite ^/job-([0-9] )-([0-9] )-([0-9] ).html$ /job/$1/$2/jobshow_$3.html last;

13.将根目录下某个文件夹指向2级目录
如/shanghaijob/ 指向 /area/shanghai/
如果你将last改成permanent，那么浏览器地址栏显是/location/shanghai/

rewrite ^/([0-9a-z] )job/(.*)$ /area/$1/$2 last;

上面例子有个问题是访问/shanghai 时将不会匹配

rewrite ^/([0-9a-z] )job$ /area/$1/ last;

rewrite ^/([0-9a-z] )job/(.*)$ /area/$1/$2 last;

这样/shanghai 也可以访问了，但页面中的相对链接无法使用，
如./list_1.html真实地址是/area/shanghia/list_1.html会变成/list_1.html,导至无法访问。

那我加上自动跳转也是不行咯
(-d $request_filename)它有个条件是必需为真实目录，而我的rewrite不是的，所以没有效果

if (-d $request_filename){

rewrite ^/(.*)([^/])$ http://$host/$1$2/ permanent;

}

知道原因后就好办了，让我手动跳转吧

rewrite ^/([0-9a-z] )job$ /$1job/ permanent;

rewrite ^/([0-9a-z] )job/(.*)$ /area/$1/$2 last;

14.文件和目录不存在的时候重定向：

if (!-e $request_filename) {

proxy_pass http://127.0.0.1;

}

nginx和apache的rewrite规则实例对比

1.一般简单的nginx和apache规则的区别不大，基本能够完全兼容，例如：

apache: rewriterule ^/abc/$ /web/abc.php [l]

nginx: rewrite ^/abc/$ /web/abc.php last ;

我们可以看出来只要把apache的rewriterule改为nginx的rewrite，apache的[l]改为last 即可。

如果将apache的规则改为nginx规则后，用命令nginx -t 检查发现错误，则我们可以尝试给条件加上引号，例如：

rewrite “^/([0-9]{5}).html$” /x.php?id=$1 last;

2.apache和nginx的rewrite规则在url跳转时有细微区别：

apache: rewriterule ^/html/([a-za-z] )/.*$ /$1/ [r=301,l]

nginx: rewrite ^/html/([a-za-z] )/.*$ http://$host/$1/ premanent ;

我们可以看到在nginx的跳转中，我们需要加上http://$host，这是在nginx中强烈要求的。

3.下面是一些apache和nginx规则的对应关系

a.apache的rewritecond对应nginx的if

b.apache的rewriterule对应nginx的rewrite

c.apache的[r]对应nginx的redirect

d.apache的[p]对应nginx的last

e.apache的[r,l]对应nginx的redirect

f.apache的[p,l]对应nginx的last

g.apache的[pt,l]对应nginx的last

例如：允许指定的域名访问本站，其他的域名一律转向www.111cn.net

apache:

rewritecond %{http_host} !^(.*?).aaa.com$ [nc]
rewritecond %{http_host} !^localhost$
rewritecond %{http_host} !^192.168.0.(.*?)$
rewriterule ^/(.*)$ http://www.111cn.net [r,l]

nginx:

if( $host ~* ^(.*).aaa.com$ )
{
set $allowhost ‘1’;
}
if( $host ~* ^localhost )
{
set $allowhost ‘1’;
}
if( $host ~* ^192.168.1.(.*?)$ )
{
set $allowhost ‘1’;
}
if( $allowhost !~ ‘1’ )
{
rewrite ^/(.*)$ http://www.111cn.net redirect ;
}
《附录：nginx全局变量》

经常需要配置nginx ，其中有许多以 $ 开头的变量，经常需要查阅nginx 所支持的变量。nginx支持的http变量实现在 ngx_http_variables.c 的 ngx_http_core_variables存储实现

ngx_http_core_variables
static ngx_http_variable_t ngx_http_core_variables[] = {

{ ngx_string("http_host"), null, ngx_http_variable_header,
offsetof(ngx_http_request_t, headers_in.host), 0, 0 },

{ ngx_string("http_user_agent"), null, ngx_http_variable_header,
offsetof(ngx_http_request_t, headers_in.user_agent), 0, 0 },

{ ngx_string("http_referer"), null, ngx_http_variable_header,
offsetof(ngx_http_request_t, headers_in.referer), 0, 0 },

#if (ngx_http_gzip)
{ ngx_string("http_via"), null, ngx_http_variable_header,
offsetof(ngx_http_request_t, headers_in.via), 0, 0 },
#endif

#if (ngx_http_proxy || ngx_http_realip)
{ ngx_string("http_x_forwarded_for"), null, ngx_http_variable_header,
offsetof(ngx_http_request_t, headers_in.x_forwarded_for), 0, 0 },
#endif

{ ngx_string("http_cookie"), null, ngx_http_variable_headers,
offsetof(ngx_http_request_t, headers_in.cookies), 0, 0 },

{ ngx_string("content_length"), null, ngx_http_variable_header,
offsetof(ngx_http_request_t, headers_in.content_length), 0, 0 },

{ ngx_string("content_type"), null, ngx_http_variable_header,
offsetof(ngx_http_request_t, headers_in.content_type), 0, 0 },

{ ngx_string("host"), null, ngx_http_variable_host, 0, 0, 0 },

{ ngx_string("binary_remote_addr"), null,
ngx_http_variable_binary_remote_addr, 0, 0, 0 },

{ ngx_string("remote_addr"), null, ngx_http_variable_remote_addr, 0, 0, 0 },

{ ngx_string("remote_port"), null, ngx_http_variable_remote_port, 0, 0, 0 },

{ ngx_string("server_addr"), null, ngx_http_variable_server_addr, 0, 0, 0 },

{ ngx_string("server_port"), null, ngx_http_variable_server_port, 0, 0, 0 },

{ ngx_string("server_protocol"), null, ngx_http_variable_request,
offsetof(ngx_http_request_t, http_protocol), 0, 0 },

{ ngx_string("scheme"), null, ngx_http_variable_scheme, 0, 0, 0 },

{ ngx_string("request_uri"), null, ngx_http_variable_request,
offsetof(ngx_http_request_t, unparsed_uri), 0, 0 },

{ ngx_string("uri"), null, ngx_http_variable_request,
offsetof(ngx_http_request_t, uri),
ngx_http_var_nocacheable, 0 },

{ ngx_string("document_uri"), null, ngx_http_variable_request,
offsetof(ngx_http_request_t, uri),
ngx_http_var_nocacheable, 0 },

{ ngx_string("request"), null, ngx_http_variable_request_line, 0, 0, 0 },

{ ngx_string("document_root"), null,
ngx_http_variable_document_root, 0, ngx_http_var_nocacheable, 0 },

{ ngx_string("realpath_root"), null,
ngx_http_variable_realpath_root, 0, ngx_http_var_nocacheable, 0 },

{ ngx_string("query_string"), null, ngx_http_variable_request,
offsetof(ngx_http_request_t, args),
ngx_http_var_nocacheable, 0 },

{ ngx_string("args"),
ngx_http_variable_request_set,
ngx_http_variable_request,
offsetof(ngx_http_request_t, args),
ngx_http_var_changeable|ngx_http_var_nocacheable, 0 },

{ ngx_string("is_args"), null, ngx_http_variable_is_args,
0, ngx_http_var_nocacheable, 0 },

{ ngx_string("request_filename"), null,
ngx_http_variable_request_filename, 0,
ngx_http_var_nocacheable, 0 },

{ ngx_string("server_name"), null, ngx_http_variable_server_name, 0, 0, 0 },

{ ngx_string("request_method"), null,
ngx_http_variable_request_method, 0,
ngx_http_var_nocacheable, 0 },

{ ngx_string("remote_user"), null, ngx_http_variable_remote_user, 0, 0, 0 },

{ ngx_string("body_bytes_sent"), null, ngx_http_variable_body_bytes_sent,
0, 0, 0 },

{ ngx_string("request_completion"), null,
ngx_http_variable_request_completion,
0, 0, 0 },

{ ngx_string("request_body"), null,
ngx_http_variable_request_body,
0, 0, 0 },

{ ngx_string("request_body_file"), null,
ngx_http_variable_request_body_file,
0, 0, 0 },

{ ngx_string("sent_http_content_type"), null,
ngx_http_variable_sent_content_type, 0, 0, 0 },

{ ngx_string("sent_http_content_length"), null,
ngx_http_variable_sent_content_length, 0, 0, 0 },

{ ngx_string("sent_http_location"), null,
ngx_http_variable_sent_location, 0, 0, 0 },

{ ngx_string("sent_http_last_modified"), null,
ngx_http_variable_sent_last_modified, 0, 0, 0 },

{ ngx_string("sent_http_connection"), null,
ngx_http_variable_sent_connection, 0, 0, 0 },

{ ngx_string("sent_http_keep_alive"), null,
ngx_http_variable_sent_keep_alive, 0, 0, 0 },

{ ngx_string("sent_http_transfer_encoding"), null,
ngx_http_variable_sent_transfer_encoding, 0, 0, 0 },

{ ngx_string("sent_http_cache_control"), null, ngx_http_variable_headers,
offsetof(ngx_http_request_t, headers_out.cache_control), 0, 0 },

{ ngx_string("limit_rate"), ngx_http_variable_request_set_size,
ngx_http_variable_request_get_size,
offsetof(ngx_http_request_t, limit_rate),
ngx_http_var_changeable|ngx_http_var_nocacheable, 0 },

{ ngx_string("nginx_version"), null, ngx_http_variable_nginx_version,
0, 0, 0 },

{ ngx_string("hostname"), null, ngx_http_variable_hostname,
0, 0, 0 },

{ ngx_string("pid"), null, ngx_http_variable_pid,
0, 0, 0 },

{ ngx_null_string, null, null, 0, 0, 0 }
};
把这些变量提取下，总结如下：

arg_parameter #这个变量包含get请求中，如果有变量parameter时的值。
args #这个变量等于请求行中(get请求)的参数，例如foo=123&bar=blahblah;
binary_remote_addr #二进制的客户地址。
body_bytes_sent #响应时送出的body字节数数量。即使连接中断，这个数据也是精确的。
content_length #请求头中的content-length字段。
content_type #请求头中的content-type字段。
cookie_cookie #cookie cookie变量的值
document_root #当前请求在root指令中指定的值。
document_uri #与
uri相同。
host #请求主机头字段，否则为服务器名称。
hostname #set to the machine’s hostname as returned by gethostname
http_header
is_args #如果有
args参数，这个变量等于”?”，否则等于”"，空值。
http_user_agent #客户端agent信息
http_cookie #客户端cookie信息
limit_rate #这个变量可以限制连接速率。
query_string #与
args相同。
request_body_file #客户端请求主体信息的临时文件名。
request_method #客户端请求的动作，通常为get或post。
remote_addr #客户端的ip地址。
remote_port #客户端的端口。
remote_user #已经经过auth basic module验证的用户名。
request_completion #如果请求结束，设置为ok. 当请求未结束或如果该请求不是请求链串的最后一个时，为空(empty)。
request_method #get或post
request_filename #当前请求的文件路径，由root或alias指令与uri请求生成。
request_uri #包含请求参数的原始uri，不包含主机名，如：”/foo/bar.php?arg=baz”。不能修改。
scheme #http方法（如http，https）。
server_protocol #请求使用的协议，通常是http/1.0或http/1.1。
server_addr #服务器地址，在完成一次系统调用后可以确定这个值。
server_name #服务器名称。
server_port #请求到达服务器的端口号。

时间： / 作者：百科全说

09/11 13:19
如何在apache环境下配置rewrite规则 apache rewrite 规则 环境 url 静态化是一个利于搜索引擎的设置，通过 url 静态化，达到原来是动态的 php 页面转换为静态化的 html 页面，当然，这里的静态化是一种假静态，目的只是提高搜索引擎的搜索量，comsenz 旗下的产品 discuz!、supesite/x-space、ecshop、supev、uchome 等都支持此功能。当然这个功能还需要服务器环境的支持，下面介绍一下如何在 apache 服务器下配置 url
04/28 17:00
下面配置包含了，nginx配置的一个比较全面的反向代理的例子： user www www worker_processes 8; events { use epoll; worker_connections 10240; } pid /opt/work/log/nginx.pid; error_log /dev/null error; http { include /opt/nginx/conf/mime.types; default_type t
06/30 16:19
首先看一个完整代码示例，关于nginx 301 302跳转的。 301跳转设置： server { listen 80; server_name downcc.com; rewrite ^/(.*) http://www.downcc.com/$1 permanent; access_log off; } 302跳转设置： server { listen 80; server_name downcc.com; rewrite ^/(.*) http://www.downcc.com/$1 red
11/28 10:10
nginx 目录结构 复制代码 代码如下: nginx-0.8.54 │ nginx.exe //主程序 │ ├─conf │ │ fastcgi_params │ │ koi-utf │ │ koi-win │ │ mime.types │ │ nginx.conf //核心配置文件 │ │ win-utf │ │ │ └─vhost //虚拟主机目录 │ www.uctest.conf │ news.uctest.conf │ ├─contrib │ │ geo2nginx.pl │ │ r
04/12 04:59
google上有丰富的 nginx 的教程和样本配置文件，但很多时候时候，配置这些是一些技巧，一直对大家很有帮助。 include 文件 不要在您的主 nginx.conf 文件中配置所有的东西，你需要分成几个较小的文件。您的同事会很感激你的。比如我的结构，我定义我的 upstream 的 pool 的为一个文件，和一个文件定义 location 处理服务器上其它的应用。 例子： upstreams.conf upstream cluster1 {fair;server app01:70
12/24 23:51
如何使用nginx泛域名解析 反向代理 静态资源缓存呢? 1.安装nginx，安装过程不再赘述，记得带上pcre、gzip、sub、status这几个模块，另外如果想开通在线清理缓存功能，需要安装ngx_cache_purge这个第三方模块。 2.删除nginx.conf中默认的server段，此操作不做你会让你抱憾终身。 3.将以下代码插入nginx.conf尾部，-t测试-s reload重启即可。 代码如下 #定义缓存的临时目录以及缓存存储目录 proxy_temp_path /data/
07/05 01:55
现在很多朋友都选择了linux服务器下配置lnmp(linux nginx mysql php),这里分享下lnmp安装与配置方法，需要的朋友可以参考下 nginx与apache、lighttp性能综合对比，如下图: 注意：关闭rpm默认安装的apache和mysql 1.准备php函数的rpm包 yum -y install gcc gcc-c autoconf libjpeg libjpeg-devel libpng libpng-devel freetype freetype-deve
12/16 00:10
本文章来给大家总结了大量关于导致nginx中提示500 internal server error错误的原因总结与解决方法分析有需要了解的朋友可参考参考 现在越来越多的站点开始用 nginx ,("engine x") 是一个高性能的 http 和反向代理服务器，也是一个 imap/pop3/smtp 代理服务器。 nginx 是由 igor sysoev 为俄罗斯访问量第二的 rambler.ru 站点开发的，它已经在该站点运行超过两年半了。igor 将源代码以类bsd许可证的形式发布。 在高
07/30 23:55
1.硬盘空间满了使用 df -k 查看硬盘空间是否满了.清理硬盘空间就可以解决500错误.nginx如果开启了access log,在不需要的情况下,最好关闭access log.access log会占用大量硬盘空间. 2.nginx配置文件错误 这里不是指语法错误,nginx如果配置文件有语法错误,启动的时候就会提示.当配置rewrite的时候,有些规则处理不当会出现500错误,请仔细检查自己的rewrite规则.如果配置文件里有些变量设置不当,也会出现500错误,比如引用了一个没有值的变量
网站地图