Dokku中实现单容器多端口多域名HTTPS配置的解决方案

背景介绍

在使用Dokku部署stack-auth应用时，遇到了一个典型的多端口多域名配置需求。该应用需要在两个不同端口(8101和8102)上运行服务，并且每个端口都需要通过不同的域名提供HTTPS访问。

问题分析

通过Dokku的标准配置命令：

dokku ports:add stackauth http:80:8102
dokku ports:add stackauth http:8101:8101
dokku domains:add stackauth auth-dashboard.domain.com auth.domain.com

只能实现8102端口的HTTPS访问，而8101端口只能通过HTTP访问。这是因为Dokku默认的Nginx配置模板无法直接支持为同一应用的不同端口配置独立的HTTPS服务。

技术挑战

1. 需要为同一Dokku应用配置多个HTTPS服务
2. 每个HTTPS服务需要绑定到不同的域名
3. 需要保持Dokku的自动化管理特性
4. 配置需要能够经受住应用重启和重新部署

解决方案

通过创建自定义的Nginx配置模板(nginx.conf.sigil)来解决这个问题。该模板需要包含：

1. 两个独立的HTTPS server块，分别对应不同的域名
2. 每个server块配置不同的proxy_pass指向对应的应用端口
3. 共享相同的SSL证书配置
4. 包含必要的超时和性能优化参数

实现细节

1. 创建自定义模板文件/home/dokku/stackauth/nginx.conf.sigil
2. 模板中包含三个server块：
   • 一个用于HTTP到HTTPS的重定向
   • 两个分别服务于不同域名的HTTPS服务
3. 每个HTTPS服务块配置了：
   • 独立的server_name指令
   • 对应的upstream后端
   • 共享的SSL证书配置
   • 优化的代理和超时设置

最佳实践

1. 使用自定义模板而非直接修改生成的Nginx配置
2. 保持错误页面和基本配置与Dokku标准一致
3. 为每个服务配置适当的超时和性能参数
4. 启用HTTP/2和gzip压缩提升性能
5. 配置完整的HTTP到HTTPS重定向

总结

通过自定义Nginx模板的方式，我们成功地在Dokku中实现了单容器多端口多域名的HTTPS服务配置。这种方法既保持了Dokku的自动化管理特性，又满足了复杂应用的特殊需求，为类似场景提供了一个可靠的解决方案。