DefectDojo项目在非根路径下的部署实践与解决方案

背景与挑战

在基于Docker的DefectDojo部署场景中，许多开发者会遇到一个经典问题：如何将应用部署在非根路径（如/bugs）而非默认的根路径（/）。这种需求常见于多应用共享同一服务器的场景，但官方文档对此的指导较为有限。

核心问题分析

通过社区讨论可知，该问题主要涉及三个技术层面：

1. Nginx反向代理配置：需要正确处理静态资源路径和动态请求转发
2. UWSGI服务配置：需要确保应用能识别和处理带前缀的URL
3. Django应用配置：需要正确设置URL前缀相关环境变量

解决方案实现

经过实践验证的有效配置方案如下：

1. Nginx关键配置

upstream uwsgi_server {
    server 127.0.0.1:3031;
}

location /bugs/static/ {
    alias /var/www/html/static/;
}

location /bugs/ {
    include uwsgi_params;
    uwsgi_pass uwsgi_server;
    uwsgi_read_timeout 1800;
}

2. Docker环境变量配置

在docker-compose文件中需要对以下服务进行配置：

• uwsgi服务
• celerybeat服务
• celeryworker服务
• initializer服务

关键环境变量：

environment:
  DD_URL_PREFIX: 'bugs'
  DD_LOGIN_URL: '/bugs/login'

3. 静态资源处理

需要将静态资源目录/static复制到Nginx可访问的路径（如/var/www/html），并确保权限正确。

注意事项

1. API兼容性：非根路径部署可能影响API端点访问，需要额外测试验证
2. 通知系统：需正确配置DD_SITE_URL参数确保通知中的链接正确
3. 路径一致性：所有相关服务必须使用相同的URL前缀配置

经验总结

该解决方案虽然解决了基础访问问题，但开发者需要注意：

• 该配置方式属于非标准部署方案，可能存在未发现的边缘情况
• 生产环境部署前应进行全面测试，特别是API接口和后台任务
• 建议监控日志中与路径相关的错误信息

对于需要严格生产环境支持的用户，建议考虑使用子域名而非路径前缀的方案，这能避免大多数路径相关的问题。