DDNS-Go项目二级目录反代配置问题解决方案

问题背景

在使用DDNS-Go项目时，很多用户会选择通过Nginx反向代理的方式将服务部署在二级目录下，例如http://example.com/ddns。然而在v6.6版本引入登录页面后，出现了路径定位错误的问题——系统会错误地跳转到根目录下的/login而非预期的/ddns/login路径。

问题分析

这种路径跳转错误通常源于以下几个技术点：

1. 绝对路径与相对路径：Web应用中的链接和重定向如果使用绝对路径(如/login)，会忽略代理配置中的二级目录前缀。

2. HTTP重定向处理：后端应用发出的重定向响应头(Location字段)如果没有考虑代理路径，会导致浏览器直接跳转到根目录。

3. 前端资源引用：HTML、CSS和JavaScript中硬编码的资源路径同样会忽略代理前缀。

解决方案

基础代理配置

首先需要确保基本的反向代理配置正确：

location /ddns/ {
    proxy_pass http://127.0.0.1:9876/;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
}

关键修复配置

针对路径跳转问题，需要添加以下关键配置项：

1. 重定向修正：

proxy_redirect / $scheme://$http_host/ddns/;

这条指令会自动修正后端返回的重定向响应，将根路径重写为包含二级目录的路径。

2. 前端资源路径替换：

sub_filter_types text/html application/javascript text/css;
sub_filter 'href="/' 'href="/ddns/';
sub_filter 'src="/' 'src="/ddns/';
sub_filter_once off;

这些配置会动态修改HTML、JS和CSS中的资源引用路径，确保所有前端资源都能正确加载。

完整配置示例

结合上述要点，完整的Nginx配置如下：

location /ddns/ {
    proxy_pass http://127.0.0.1:9876/;
    
    # 修正重定向
    proxy_redirect / $scheme://$http_host/ddns/;
    
    # 修正前端资源路径
    sub_filter_types text/html application/javascript text/css;
    sub_filter 'href="/' 'href="/ddns/';
    sub_filter 'src="/' 'src="/ddns/';
    sub_filter_once off;
    
    # 标准代理头设置
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
    proxy_http_version 1.1;
}

配置说明

1. proxy_redirect：这是解决登录跳转问题的关键，它会自动修改Location头中的路径。

2. sub_filter：用于修改响应内容中的路径引用，确保CSS、JS和图片等资源能正确加载。

3. sub_filter_once off：确保替换操作在整个响应内容中多次执行，而不是仅替换第一次出现。

4. WebSocket支持：通过Upgrade和Connection头确保WebSocket功能正常。

验证方法

配置完成后，可以通过以下步骤验证：

1. 访问http://example.com/ddns应显示正常界面
2. 点击登录按钮应跳转到http://example.com/ddns/login而非根目录
3. 检查浏览器开发者工具中的Network选项卡，确认所有资源加载成功
4. 检查是否有404错误，特别是CSS和JS文件

注意事项

1. 确保Nginx版本支持sub_filter模块(通常默认包含)
2. 修改配置后记得重载Nginx服务
3. 如果使用HTTPS，确保证书配置正确
4. 对于更复杂的部署场景，可能需要调整sub_filter规则

通过以上配置，可以完美解决DDNS-Go在二级目录部署时的路径跳转问题，为用户提供无缝的使用体验。