使用nginx-proxy实现www子域名重定向到主域名的最佳实践

背景介绍

nginx-proxy是一个基于Docker的轻量级反向代理解决方案，能够自动为容器化的Web应用配置Nginx虚拟主机。在实际生产环境中，我们经常需要将带www的子域名（如www.example.com）永久重定向到主域名（example.com），这既是SEO最佳实践，也能统一网站入口。

问题分析

在默认配置下，nginx-proxy虽然可以同时处理带www和不带www的域名访问，但不会自动实现两者之间的重定向。常见误区是尝试通过.htaccess文件实现重定向，这在Nginx环境下是无效的，因为：

1. .htaccess是Apache的配置文件格式
2. Docker容器内的应用通常无法直接修改Nginx配置

解决方案

通过nginx-proxy的location_override机制可以实现优雅的重定向：

1. 首先在宿主机创建vhost配置目录

mkdir -p ./vhost

2. 在docker-compose.yml中挂载该目录到nginx-proxy容器

volumes:
  - ./vhost:/etc/nginx/vhost.d

3. 为www子域名创建重定向配置文件 在vhost目录下创建名为www.example.com_location_override的文件，内容为：

location / {
    return 301 https://example.com$request_uri;
}

实现原理

nginx-proxy在运行时会自动加载vhost.d目录下的配置文件：

1. 文件名格式为域名_location_override
2. 文件内容会作为Nginx的location块插入到对应域名的server配置中
3. 301重定向确保搜索引擎更新索引
4. $request_uri变量保留原始请求路径

进阶配置

对于需要更复杂重定向规则的情况，可以在配置文件中添加更多Nginx指令：

location / {
    if ($host = 'www.example.com') {
        return 301 https://example.com$request_uri;
    }
    # 其他规则...
}

注意事项

1. 确保同时申请SSL证书：在容器环境变量中同时配置LETSENCRYPT_HOST=example.com,www.example.com
2. 清除浏览器缓存测试重定向效果
3. 使用curl -v命令验证HTTP响应头是否包含301状态码
4. 重定向配置不会影响ACME验证路径(/.well-known/acme-challenge/)

总结

通过nginx-proxy的location_override机制，我们可以不修改容器内部配置就实现专业的域名重定向方案。这种方法具有以下优势：

• 配置持久化：不受容器重启影响
• 零侵入：不需要修改应用代码
• 高性能：由Nginx直接处理重定向
• 灵活扩展：支持更复杂的重定向逻辑

这种方案适用于所有使用nginx-proxy作为反向代理的Docker化Web应用，是生产环境部署的推荐做法。