企业官网建设流程全解析

终极DefectDojo故障排除指南：解决95%的部署和运行问题

【免费下载链接】django-DefectDojoOpen-Source Unified Vulnerability Management, DevSecOps & ASPM项目地址: https://gitcode.com/gh_mirrors/dj/django-DefectDojo

DefectDojo作为一款开源的漏洞管理和DevSecOps工具，帮助开发团队有效追踪和修复安全漏洞。本文将详细介绍DefectDojo常见的部署和运行问题及解决方案，让你快速排除故障，确保系统稳定运行。

一、Docker部署常见问题与解决方法

1.1 初始化失败：管理员账户创建问题

当使用Docker Compose部署时，有时会遇到管理员账户创建失败的情况。这通常是由于环境变量配置不当或初始化脚本执行错误导致的。

解决步骤：

1. 检查Docker日志获取详细错误信息：

   docker compose logs initializer

2. 确认环境变量设置正确，特别是管理员账户相关变量：

   • DD_ADMIN_USER
   • DD_ADMIN_MAIL
   • DD_ADMIN_PASSWORD

3. 如果初始化失败，可以手动执行初始化脚本：

   docker compose exec uwsgi /bin/bash -c '/app/docker/entrypoint-first-boot.sh'

1.2 容器启动后无法访问Web界面

容器成功启动但无法访问Web界面，可能是端口映射或网络配置问题。

解决步骤：

1. 检查容器运行状态：

   docker compose ps

2. 确认端口映射是否正确，默认情况下DefectDojo使用8080端口：

   netstat -tuln | grep 8080

3. 检查Nginx配置是否正确，相关配置文件位于：nginx/nginx.conf

二、数据库连接问题

2.1 数据库连接超时

数据库连接超时通常发生在数据库服务未就绪或网络配置错误时。

解决步骤：

1. 检查数据库容器是否正常运行：

   docker compose ps | grep postgres

2. 查看应用日志中的数据库连接错误：

   docker compose logs uwsgi | grep database

3. 确认数据库连接参数是否正确，相关环境变量包括：

   • DD_DATABASE_URL
   • DD_DB_NAME
   • DD_DB_USER
   • DD_DB_PASSWORD
   • DD_DB_HOST
   • DD_DB_PORT

2.2 数据库迁移失败

数据库迁移失败会导致应用无法启动，通常是由于数据库版本不兼容或迁移文件损坏。

解决步骤：

1. 手动执行数据库迁移命令：

   docker compose exec uwsgi python manage.py migrate

2. 如果迁移失败，尝试回滚到上一个稳定版本：

   docker compose exec uwsgi python manage.py migrate --fake-initial

3. 查看详细迁移日志：

   docker compose exec uwsgi python manage.py migrate --verbose

三、Jira集成常见问题

Jira集成是DefectDojo的重要功能，但配置过程中可能会遇到各种问题。

3.1 Jira配置时出现401/403错误

配置Jira集成时出现认证错误，通常是由于凭据不正确或权限不足。

解决步骤：

1. 验证Jira凭据是否正确，可以使用curl命令测试：

   curl -u <emailaddress>:<personal_access_token> \ -X GET \ -H "Content-Type: application/json" \ https://<COMPANY>.atlassian.net/rest/api/latest/issue/<JIRA_ISSUE_KEY>

2. 确认Jira用户具有足够的权限，至少需要创建和编辑问题的权限。

3. 检查Jira API URL是否正确，确保使用的是正确的Jira Cloud或Server URL。

图：Jira连接故障排除界面

3.2 "Push To Jira"后问题未在Jira中创建

使用"Push To Jira"功能后，问题未在Jira中创建，这可能是由于异步任务失败或Jira配置问题。

解决步骤：

1. 检查DefectDojo通知，查看是否有错误信息。
2. 确认Jira项目配置是否正确，特别是Issue类型和必填字段。
3. 检查Jira工作流是否允许创建此类问题。
4. 查看Celery worker日志，确认任务是否成功执行：

   docker compose logs celery_worker

四、Celery Worker问题

Celery Worker负责处理异步任务，如导入扫描结果、推送问题到Jira等。

4.1 Celery Worker无法启动

Celery Worker无法启动通常是由于连接问题或配置错误。

解决步骤：

1. 检查Celery Worker日志：

   docker compose logs celery_worker

2. 确认消息代理（如Redis）是否正常运行：

   docker compose ps | grep redis

3. 检查Celery配置，相关环境变量包括：

   • DD_BROKER_URL
   • DD_CELERY_RESULT_BACKEND

4.2 异步任务执行缓慢或失败

异步任务执行缓慢或失败可能是由于资源不足或任务配置问题。

解决步骤：

1. 增加Celery Worker资源限制，在docker-compose.yml中调整：

   celery_worker: ... deploy: resources: limits: cpus: '2' memory: 2G

2. 调整任务重试配置，相关环境变量包括：

   • DD_JIRA_MAX_RETRIES
   • DD_JIRA_CONNECT_TIMEOUT
   • DD_JIRA_READ_TIMEOUT

3. 监控系统资源使用情况，确保有足够的CPU和内存资源。

五、静态文件加载问题

静态文件（CSS、JavaScript）无法加载会导致界面显示异常。

解决步骤：

1. 检查Nginx配置，确保静态文件路径正确，相关配置文件：nginx/nginx.conf

2. 手动收集静态文件：

   docker compose exec uwsgi python manage.py collectstatic --noinput

3. 检查文件权限，确保Nginx可以访问静态文件目录：

   docker compose exec uwsgi chmod -R 755 /app/static

六、高级故障排除工具

6.1 数据库状态 reconciliation

当DefectDojo和Jira状态不同步时，可以使用管理命令进行 reconciliation：

docker compose exec uwsgi python manage.py jira_status_reconciliation

可以通过添加参数指定操作模式：

• --mode reconcile: 自动根据时间戳判断哪个状态更新
• --mode push_status_to_jira: 将DefectDojo状态推送到Jira
• --mode import_status_from_jira: 从Jira导入状态到DefectDojo

6.2 日志分析

DefectDojo的日志对于故障排除至关重要，可以通过以下命令查看不同组件的日志：

# Web应用日志 docker compose logs uwsgi # Celery Worker日志 docker compose logs celery_worker # 数据库日志 docker compose logs postgres # Nginx日志 docker compose logs nginx

七、获取帮助

如果遇到本文未涵盖的问题，可以通过以下渠道获取帮助：

• DefectDojo官方文档
• DefectDojo Slack社区
• GitHub Issues

通过以上方法，您应该能够解决大多数DefectDojo的部署和运行问题。如果问题仍然存在，请收集详细的错误日志和系统信息，以便社区能够更好地帮助您解决问题。

【免费下载链接】django-DefectDojoOpen-Source Unified Vulnerability Management, DevSecOps & ASPM项目地址: https://gitcode.com/gh_mirrors/dj/django-DefectDojo