Nginx常见基本配置---rewrite 使用指南

野性酷女 2024-04-19 13:39 89阅读 0赞

# Nginx常见基本配置—rewrite 使用指南 #

## 前言 ##

rewrite是 ngx\_ http\_ rewrite\_ module模块下的指令，使用频率非常高。

## 内部重定向 ##

rewrite支持的配置环境有 server、 location、 if，它通过 break和 last来完成内部重定向功能。内部重定向是在 Nginx内部发送请求的操作，它可以将请求转发到其他的 location或对 URL进行修改，而不必通过 HTTP连接请求，整个操作非常高效。相关示例如下：  
![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0xMODQ1ODc2NDI1_size_16_color_FFFFFF_t_70][]  
![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0xMODQ1ODc2NDI1_size_16_color_FFFFFF_t_70 1][]

如果需要将内部重定向的请求记录到日志里，请使用 rewrite\_ log。

指令： rewrite_ log
    语法： rewrite_ log on | off;
    默认值： rewrite_ log off;
    环境： http、 server、 location、 if

**注意：在 rewrite后面跟随的参数始终是正则表达式，并且当内部重定向时 URL的参数是不会丢失的。**

## 域名跳转 ##

通过 rewrite可以实现域名间的跳转，常见的跳转类型有 301、 302。

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0xMODQ1ODc2NDI1_size_16_color_FFFFFF_t_70 2][]

永久重定向和临时重定向的区分是为爬取搜索引擎而设置的。如果状态码是 301，表示网页地址永久改变，搜索引擎会将旧页面的地址替换成新页面的地址，用户在搜索引擎搜索网站时，就不会再去旧地址了。

如果状态码是 302，表示临时重定向，搜索引擎会保留旧页面的地址，因为它认为跳转只是暂时的。当用户使用搜索引擎搜索网站时，会首先进入旧地址然后再被跳转到 302指定的新地址。

## 跳转 POST请求 ##

301和 302的跳转并不适合用于 POST请求，如果 POST请求被跳转的话，会先被转化为 GET请求，且请求体的内容会丢失，为此 HTTP 1. 1提供了新的跳转状态码 307和 308。

状态码 307的意义和 302一样，都是临时重定向；而 308和 301一样，都是永久重定向。但如果要求在跳转过程中保持客户端的请求方法不变，需要使用 return指令，示例如下：

![2019091822100788.jpg][]

指令： return
    语法： return code [text];

其中 code是状态码。 return指令会立即返回一个 HTTP状态码给客户端，并附加一个文本信息到响应体中，因为此方式缺少 Default\_ Type响应头，所以当使用浏览器打开时无法直接展示文本信息，而会将文本下载到本地。

return指令用法示例如下：

*  return code URL;支持 301、 302、 303、 307和 308跳转。
 *  return URL;默认支持 302跳转。

环境： server、 location、 if

**注意：如果把 return和 proxy\_ pass配置为同一级别，那么会直接执行 return，而不会执行 proxy\_ pass，同一 location块下的其他指令也不会再被执行。**

## 设置变量的值 ##

指令： set
    语法： set $ variable value;
    环境： server、 location、 if
    含义：设置指定变量的值，值可以是文本、变量或文本和变量的组合。因为是为当前请求设置的值，所以会在请求结束后被清除掉。

![2019091822145236.jpg][]  
![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0xMODQ1ODc2NDI1_size_16_color_FFFFFF_t_70 3][]

## 限速白名单 ##

Nginx提供了 ngx\_ http\_ limit\_ req\_ module和 ngx\_ http\_ limit\_ conn\_ module等模块来完成限制请求访问的功能，可以对请求的访问频率、 User-Agent、带宽等各种条件进行限速。

例如当 User-Agent有问题时，要对其进行限速，则代码如下：

![20190918221615862.jpg][]

可以参考 Wiki，网上也有很多相关的文章，这里不再一一赘述。限速一般会对请求的访问频率进行控制，但如果有些请求是内部访问不需要限速该如何处理呢？相关配置如下所示：  
![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0xMODQ1ODc2NDI1_size_16_color_FFFFFF_t_70 4][]  
![20190918221700623.jpg][]  
**注意：整个配置都在 http块内。**

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0xMODQ1ODc2NDI1_size_16_color_FFFFFF_t_70]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/18/461168b07ca54c5fb508c8499bc16b94.jpg
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0xMODQ1ODc2NDI1_size_16_color_FFFFFF_t_70 1]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/18/9a6085f90e804fd5a5e6e4944cd83c90.jpg
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0xMODQ1ODc2NDI1_size_16_color_FFFFFF_t_70 2]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/18/84719c76ab0b471cb8ced6f7c324e7cf.jpg
[2019091822100788.jpg]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/18/e67467896a56423da05b417f4bf62178.jpg
[2019091822145236.jpg]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/18/0608c334d6564d928d59f6537488ef36.jpg
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0xMODQ1ODc2NDI1_size_16_color_FFFFFF_t_70 3]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/18/8b3c0687c1734da797de7707b06c7b4d.jpg
[20190918221615862.jpg]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/18/3372880f3f6c4d029ab6655bac5f386e.jpg
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0xMODQ1ODc2NDI1_size_16_color_FFFFFF_t_70 4]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/18/0737b8f1d5644ed1a3f8bc77652c28a9.jpg
[20190918221700623.jpg]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/18/d129fa6b99224f018b293db604510688.jpg