Nginx Proxy Manager实现URL重定向配置指南

Nginx Proxy Manager (NPM) 是一个基于Web的Nginx管理界面，可以方便地配置代理、SSL证书和URL重定向等功能。以下是使用NPM实现URL重定向的详细配置方法。

基本URL重定向配置

1. 创建重定向

1. 登录Nginx Proxy Manager控制台
2. 导航到"Hosts" → "Redirection Hosts"
3. 点击"Add Redirection Host"

2. 配置重定向参数

• Domain Names: 输入需要重定向的域名(如example.com)
• Scheme: 选择http或https
• Forward Hostname/IP: 留空(因为这是重定向而非代理)
• Forward Port: 留空
• Advanced → Redirection Type:
  • Permanent (301): 永久重定向
  • Temporary (302): 临时重定向
• Advanced → Forward Path: 目标路径(如/new-path)
• Advanced → Forward Scheme: 目标URL的协议(http或https)

3. 保存配置

点击"Save"应用配置，NPM会自动生成并应用Nginx配置。

高级重定向场景

1. 保留路径的重定向

要将old.com的所有路径重定向到new.com并保留路径结构：

1. 创建重定向主机
2. 在"Domain Names"填写old.com
3. 设置"Redirection Type"为301或302
4. 在"Forward Scheme"选择https
5. 在"Forward Hostname/IP"填写new.com
6. 勾选"Preserve Path"选项

2. 特定路径重定向

要将example.com/blog重定向到blog.example.com:

1. 创建代理主机指向blog.example.com
2. 在"Custom Locations"中添加:
   • Location: /blog
   • Scheme: https
   • Forward Hostname/IP: blog.example.com
   • Forward Port: 443

3. 通配符子域名重定向

将所有子域名重定向到主域名:

1. 创建重定向主机
2. 在"Domain Names"填写*.example.com
3. 设置目标为https://example.com
4. 在高级选项中添加自定义Nginx配置:

if ($host ~* ^(.+)\.example\.com$) {
    set $subdomain $1;
    return 301 https://example.com/$subdomain$request_uri;
}

自定义Nginx配置

对于更复杂的重定向需求，可以在"Advanced"选项卡中添加自定义Nginx配置:

# 重定向非www到www
if ($host !~* ^www\.) {
    return 301 https://www.$host$request_uri;
}

# 重定向特定路径
location = /old-page {
    return 301 https://$host/new-page;
}

# 重定向特定文件类型
location ~* \.(jpg|jpeg|gif|png)$ {
    return 301 https://cdn.example.com$request_uri;
}

常见问题解决

1. 重定向循环

检查重定向规则是否相互引用，特别是www和非www版本之间的重定向。

2. SSL证书问题

确保源域和目标域都有有效的SSL证书，或在重定向配置中正确设置协议。

3. 路径丢失

如果重定向后路径丢失，检查是否启用了"Preserve Path"选项或正确配置了$request_uri。

4. 配置不生效

• 检查NPM日志:docker logs nginx-proxy-manager
• 确保已应用配置(点击"Nginx" → "Reload Nginx")
• 清除浏览器缓存测试

最佳实践

1. 对永久移动的资源使用301重定向
2. 对临时维护页面使用302重定向
3. 尽量减少重定向链(避免多次跳转)
4. 测试重定向后的页面功能和SEO影响
5. 使用工具(如Redirect Mapper)检查网站的重定向结构

通过Nginx Proxy Manager的图形界面和自定义配置选项，您可以灵活地实现各种URL重定向需求。