TandoorRecipes项目在Docker+Apache子目录环境下的部署方案

前言

在容器化部署TandoorRecipes项目时，很多开发者会遇到在子目录(subfolder)环境下配置反向代理的挑战。本文将详细介绍如何在Docker容器中运行TandoorRecipes，并通过Apache反向代理将其部署在网站子目录(如/tandoor)下的完整解决方案。

核心配置要点

1. Apache反向代理配置

Apache配置需要特别注意两个关键部分：主应用路径和静态文件路径。以下是经过验证的有效配置：

<Location /tandoor>
    # 访问控制设置
    Require local
    Require forward-dns yourdomain.com
    Require ip 192.168.1.0/24
    
    # 反向代理设置
    ProxyPass http://tandoor.service:8080/tandoor
    ProxyPassReverse http://tandoor.service:8080/tandoor
    RequestHeader add X-Script-Name /tandoor
    RequestHeader set X-Forwarded-Proto "https"
    ProxyPreserveHost On
</Location>

<Location /tandoor/static>
    # 静态文件特殊处理
    ProxyPass http://tandoor.service:8080/tandoor/static
    ProxyPassReverse http://tandoor.service:8080/tandoor/static
    # 其余头部设置与主应用一致
</Location>

2. Docker环境变量配置

在docker-compose.yml中，必须正确设置以下关键环境变量：

environment:
  - SCRIPT_NAME=/tandoor
  - JS_REVERSE_SCRIPT_PREFIX=/tandoor
  - STATIC_URL=/tandoor/static/
  - MEDIA_URL=/tandoor/media/
  - GUNICORN_MEDIA=0
  - SECRET_KEY=your_secret_key
  - POSTGRES_HOST=postgres_host
  - POSTGRES_PORT=5432
  - POSTGRES_USER=db_user
  - POSTGRES_PASSWORD=db_password
  - POSTGRES_DB=db_name

技术细节解析

1. SCRIPT_NAME的重要性：这个环境变量告诉Django应用它被挂载在哪个URL前缀下，直接影响所有URL的生成。

2. 静态文件处理：静态文件需要单独配置Location块，确保CSS、JS等资源能正确加载。

3. HTTPS转发：通过X-Forwarded-Proto头部确保应用知道它运行在HTTPS环境下。

4. 卷挂载建议：

   • 静态文件目录(/static)建议使用绑定挂载(bind mount)
   • 媒体文件目录(/media)同样建议绑定挂载
   • Nginx配置建议使用Docker卷(volume)

常见问题解决方案

1. 404错误：检查SCRIPT_NAME是否与Apache配置中的路径一致。

2. 静态文件无法加载：确认静态文件Location块配置正确，且STATIC_URL环境变量设置无误。

3. 数据库连接问题：确保POSTGRES_*环境变量正确，数据库服务可访问。

4. HTTPS重定向循环：检查X-Forwarded-Proto头部是否正确设置为"https"。

最佳实践建议

1. 使用环境变量文件(.env)管理敏感信息，避免在docker-compose.yml中直接写入密码。

2. 考虑使用健康检查确保容器完全启动后再接受请求。

3. 定期备份媒体文件和数据库。

4. 监控容器日志以快速发现问题。

通过以上配置和注意事项，开发者可以顺利地在Docker+Apache环境下将TandoorRecipes部署到子目录中，为多应用共享同一域名提供了灵活解决方案。