nginx 301重定向设置

最新推荐文章于 2025-09-19 05:10:54 发布

转载最新推荐文章于 2025-09-19 05:10:54 发布 · 1.5k 阅读

1 ·

CC 4.0 BY-SA版权

原文链接：https://www.jianshu.com/p/aa0846c9c650

Linux 专栏收录该内容

69 篇文章

订阅专栏

本文详细介绍了如何在Nginx中配置HTTP和HTTPS协议下的重定向，确保访问不带www的网址能自动跳转至带www的域名。强调了在return字段中正确使用协议头和$request_uri参数的重要性，避免出现无限重定向和URL过长的错误。

在nginx中配置，使得访问不带www的网址自动重定向到带www的域名。

http协议的重定向

在nginx官方文档中有如下示例代码：

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

server {
    listen       80;
    server_name  www.example.com;
    ...
}

对于return字段，有两点需要特别注意：

必须带上协议头，即http://
必须带上$request_uri参数

踩坑：`return`字段必须带上协议头

经踩坑，不带上协议头，访问example.com会重定向到example.com/www.example.com/www.example.com/www.example.com/www.example.com...(url的长度达到8k+)，最终出现414 Request-URI Too Large错误。

我在进行测试时发现chrome会自动缓存301跳转，因此就算还原了nginx的配置文件，访问example.com仍然会重定向到刚才的超长网址上，一直都是414错误。有两种方法可以解决301缓存的问题：

在浏览器的设置中清除缓存数据
使用隐私窗口进行测试(正确的打开方式✅)

踩坑：必须带上`$request_uri`参数

full original request URI (with arguments)

nginx文档中对该变量的描述比较简单，通过搜索可以找到历史版本的说明，(stackoverflow,博客园,新浪博客)：

This variable is equal to the original request URI as received from the client including the args. It cannot be modified. Look at $uri for the post-rewrite/altered URI. Does not include host name. Example: "/foo/bar.php?arg=baz"

通过这个详细的描述，可以了解$request_uri参数表示从客户端发送来的原生请求URI，包括参数。

经踩坑，不带上$request_uri参数，访问example.com/abcd?123会重定向到www.example.com，即无论访问任何子路径，都会自动重定向到首页。

https协议的重定向

参考http协议的重定向，我们添加了如下的配置：

server {
    listen       443 ssl;
    server_name  example.com;
    return       301 https://www.example.com$request_uri;
}

server {
    listen       443 ssl;
    server_name  www.example.com;
    ...
}

重新加载nginx配置后，我们发现 https://example.com 无法访问，通过curl测试，返回下述错误信息：curl: (35) Server aborted the SSL handshake，很明显是ssl方面的问题。

而在配置前，https://example.com 和 https://www.example.com 都是可以正常访问的，原始配置如下：

server {
    listen          443 ssl;
    server_name     www.example.com;
    server_name     example.com;
    ssl_certificate      ssl/www.example.com.crt;
    ssl_certificate_key  ssl/www.example.com.key;
    ...
}

因此，我尝试在重定向的配置中也添加ssl_certificate的配置信息：

server {
    listen       443 ssl;
    server_name  example.com;
    ssl_certificate      ssl/www.example.com.crt;
    ssl_certificate_key  ssl/www.example.com.key;
    return       301 https://www.example.com$request_uri;
}

再次加载nginx配置后，发现 https://example.com 正常访问，并且可以自动重定向到 https://www.example.com 。