在Dagu中配置反向代理子路径访问的解决方案

背景介绍

Dagu是一个工作流调度工具，提供了Web界面用于管理和监控工作流。在实际生产环境中，我们经常需要通过反向代理（如Nginx）将Dagu部署在子路径下，例如https://example.com/dagu。然而，当前版本的Dagu在子路径部署时会遇到静态资源路径不正确的问题。

问题分析

当用户尝试通过Nginx等反向代理将Dagu部署在子路径时，Web界面会尝试从根路径加载静态资源（如/assets/bundle.js），而实际上这些资源应该从子路径（如/dagu/assets/bundle.js）加载。这导致界面无法正常显示，因为浏览器无法找到正确的资源路径。

技术解决方案

Dagu开发团队已经确认将在未来版本中添加BASE_URL配置变量来解决这个问题。这个方案将允许用户：

1. 通过环境变量或配置文件指定基础URL路径
2. 使Web界面自动生成正确的资源路径
3. 支持各种反向代理场景下的部署

实现原理

BASE_URL的实现将涉及以下技术点：

1. 前端资源路径处理：Web界面将基于配置的BASE_URL动态生成资源路径
2. 路由适配：所有前端路由将自动适配配置的基础路径
3. API端点调整：后端API端点也将相应调整以匹配前端路径

部署建议

当该功能发布后，用户可以通过以下方式配置：

1. 在Dagu配置文件中设置：

base_url: "/dagu"

2. 或者通过环境变量：

export DAGU_BASE_URL="/dagu"

3. Nginx配置示例：

location /dagu {
    proxy_pass http://localhost:8080;
    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;
}

总结

Dagu即将推出的BASE_URL功能将完美解决子路径部署问题，使系统管理员能够更灵活地在现有基础设施中集成Dagu。这一改进将显著提升Dagu在企业环境中的部署便利性，同时也为多租户场景下的部署提供了可能性。