Dagu项目：支持反向转发的环境变量配置优化

背景介绍

在分布式系统架构中，反向转发是常见的部署模式。Dagu作为一个工作流调度工具，在实际生产环境中经常需要部署在反向转发服务器之后。然而当前版本存在一个明显的功能缺失——无法正确识别和适应反向转发环境，这导致了一些部署上的不便。

问题分析

当Dagu运行在反向转发后面时，所有请求的URL路径都会经过转发服务器的重写。例如，用户可能通过https://example.com/dagu访问Dagu服务，而实际上Dagu运行在http://localhost:8080。这种情况下，Dagu生成的内部链接（如API端点）仍然会使用原始路径，导致前端无法正确调用后端接口。

技术解决方案

核心修改点

1. 配置系统扩展：

   • 在配置结构中新增BaseURL字段，用于存储基础URL路径
   • 通过环境变量DAGU_BASE_URL提供外部配置入口

2. URL生成逻辑重构：

   • 修改模板系统中的URL生成函数，使其能够结合基础URL和API路径
   • 确保所有内部链接都正确包含转发路径前缀

实现细节

配置系统的修改需要保持向后兼容性。当DAGU_BASE_URL未设置时，系统应继续使用默认行为。对于URL拼接操作，需要特别注意路径分隔符的处理，避免出现//这样的无效路径。

实际影响

这项改进将带来以下好处：

1. 部署灵活性提升：用户可以在各种反向转发配置下部署Dagu
2. 安全性增强：支持HTTPS终端的转发配置
3. 企业级适配：满足企业内部统一入口的访问需求

最佳实践建议

在生产环境中使用此功能时，建议：

1. 在转发服务器配置中明确设置X-Forwarded-*头信息
2. 确保DAGU_BASE_URL与转发配置的路径完全匹配
3. 在容器化部署时，通过环境变量注入配置

这项改进虽然看似简单，但对于Dagu的生产环境适用性有着重要意义，是项目向企业级应用迈进的重要一步。