Dokku部署Yii应用时端口号异常问题的分析与解决

问题背景

在使用Dokku部署基于Yii 1.1框架的PHP应用时，开发者遇到了一个奇怪的问题：应用在运行过程中会随机地将URL重定向到包含8080端口的形式（如https://xxx.com:8080/$PATH），而实际上应用应该使用标准的80端口。

技术环境分析

该应用使用了以下技术栈：

• Yii 1.1 PHP框架
• Serversideup提供的Docker镜像（serversideup/php:8.3-fpm-nginx-bookworm）
• Dokku作为部署平台
• 某CDN服务作为CDN（使用Flexible SSL模式）

问题根源探究

经过技术分析，这个问题源于多层网络代理环境下的端口传递机制：

1. Docker容器内部：应用配置监听8080端口（通过EXPOSE 8080）
2. Dokku代理层：将外部80端口映射到容器8080端口（通过dokku ports:set http:80:8080）
3. 应用框架层：Yii框架根据接收到的请求信息生成URL

当请求经过多层代理时，如果代理头信息传递不正确，Yii框架可能会错误地使用容器内部的8080端口来构造URL，而不是使用外部访问的标准80端口。

解决方案

方案一：修正代理头信息

最根本的解决方案是确保Nginx正确传递代理头信息：

dokku nginx:set $APP_NAME x-forwarded-port-value '$http_x_forwarded_port'
dokku nginx:set $APP_NAME x-forwarded-proto-value '$http_x_forwarded_proto'
dokku proxy:build-config $APP_NAME
dokku ps:restart $APP_NAME

这个方案通过明确设置X-Forwarded-Port和X-Forwarded-Proto头信息，确保应用能够正确识别外部访问的端口和协议。

方案二：调整Yii配置

对于Yii 1.1框架，可以在配置文件中强制指定主机名和端口：

return array(
    // ...
    'components' => array(
        'request' => array(
            'hostInfo' => 'https://xxx.com',
            'baseUrl' => '',
        ),
    ),
);

这样可以避免框架自动从请求中获取端口信息。

方案三：使用Dokku buildpacks替代Dockerfile

如果问题持续存在，可以考虑不使用自定义Dockerfile，而是改用Dokku的buildpacks来部署应用：

dokku builder:set $APP_NAME selected herokuish

最佳实践建议

1. 多层代理环境：在容器化部署中，确保所有代理层都正确传递和重写头信息
2. 框架配置：对于老版本框架（如Yii 1.1），显式配置主机信息比依赖自动检测更可靠
3. 端口映射：在Dokku中，保持外部端口（80/443）与内部服务端口的一致性可以减少此类问题
4. 日志监控：定期检查Nginx和应用的访问日志，确保URL生成符合预期

总结

在复杂的容器化部署环境中，端口和协议信息的正确传递至关重要。通过合理配置代理头信息和框架设置，可以避免URL生成异常的问题。对于使用Dokku部署传统PHP应用的开发者来说，理解这些底层机制有助于快速定位和解决类似问题。

这个问题也提醒我们，在现代化部署架构中，老版本框架可能需要额外的配置调整才能完美适应容器化和反向代理的环境。