Coolify项目升级至v4.0.0-beta.380版本后的端口变更问题解析

在Coolify项目从v4-beta.379升级到v4.0.0-beta.380版本后，部分用户报告了实例无法通过域名访问的问题。经过技术分析，这主要是由于项目在最新版本中对容器端口映射进行了重要调整。

问题现象

升级完成后，用户发现虽然Coolify容器仍在运行，但出现以下典型症状：

1. 实例无法通过预设的域名访问
2. 部分用户报告容器状态显示为"unhealthy"
3. 通过IP:Port直接访问时，可能收到"connection reset by peer"错误

根本原因

技术团队在v4.0.0-beta.380版本中修改了默认端口映射配置。原先版本中，外部端口8000映射到容器内部的80端口，而新版本将其调整为映射到8080端口。这一变更旨在解决项目中的另一个已知问题。

解决方案

对于遇到此问题的用户，可以采用以下两种解决方案：

1. 手动修改配置： 用户可以编辑docker-compose.prod.yml文件，将端口映射从8000:80调整为8000:8080。修改后需要执行升级脚本使变更生效。

2. 完整升级： 运行项目提供的升级脚本，该脚本会自动应用新的端口配置。这是推荐的做法，因为它能确保所有相关配置都得到正确更新。

技术建议

对于使用Coolify的生产环境，建议采取以下最佳实践：

1. 在升级前检查版本变更日志，了解可能的配置变动
2. 确保升级过程中没有其他服务占用8080端口
3. 升级后验证所有核心功能是否正常
4. 对于关键业务系统，建议先在测试环境验证升级

后续维护

Coolify技术团队已确认此问题与端口变更直接相关。用户无需担心这是未知的系统缺陷，按照上述方案处理即可恢复正常服务。未来版本可能会进一步优化升级流程，减少此类配置变更带来的影响。

对于容器显示"unhealthy"状态的情况，这通常是端口变更导致的健康检查失败，在正确配置端口映射后该问题会自行解决。