Coolify项目中服务栈版本更新后的容器残留问题分析

在Coolify平台使用服务栈模板(如Supabase)时，用户可能会遇到一个常见问题：当更新Docker镜像版本后，旧版本的容器实例仍会显示在UI界面中，尽管它们已经处于"exited"状态。这种现象不仅影响界面整洁度，还可能干扰后续操作如定时任务的创建。

问题现象

当用户通过Coolify UI修改服务栈中的Docker镜像版本后，系统会正确部署新版本的容器，但同时会保留旧版本的容器记录。这些旧记录会以"exited"状态显示在服务列表中，无法通过常规的UI操作完全清除。更值得注意的是，当尝试通过设置界面删除这些残留容器时，删除操作会无限期挂起，无法完成。

技术背景

Coolify平台在管理服务栈时，对于每个镜像版本的更新，都会在底层数据库中创建新的记录，而非更新现有记录。这种设计导致了同一服务的多个版本记录会同时存在于数据库中，进而反映在用户界面上。

具体来说，Coolify会将服务信息存储在以下数据库表中：

• service_applications：存储非数据库类型的服务
• service_databases：存储数据库类型的服务

潜在影响

1. 界面混乱：用户界面会显示多个相同服务的不同版本，影响使用体验
2. 功能干扰：在创建定时任务等操作时，目标服务选择列表中会出现多个版本，增加误操作风险
3. 资源占用：虽然容器已停止，但相关记录仍占用系统资源

解决方案

虽然官方尚未发布正式修复，但可以通过以下步骤手动清理残留记录：

1. 连接到Coolify数据库容器
2. 查询并确认目标服务栈的ID
3. 执行SQL语句删除重复记录，保留最新版本

对于应用程序服务：

WITH ranked_services AS (
  SELECT
    id,
    name,
    created_at,
    ROW_NUMBER() OVER (PARTITION BY name ORDER BY created_at DESC) AS row_num
  FROM
    service_applications
  WHERE
    service_id = <service_id>
)
DELETE FROM service_applications
WHERE id IN (
  SELECT id
  FROM ranked_services
  WHERE row_num > 1
);

对于数据库服务：

WITH ranked_services AS (
  SELECT
    id,
    name,
    created_at,
    ROW_NUMBER() OVER (PARTITION BY name ORDER BY created_at DESC) AS row_num
  FROM
    service_databases
  WHERE
    service_id = <service_id>
)
DELETE FROM service_databases
WHERE id IN (
  SELECT id
  FROM ranked_services
  WHERE row_num > 1
);

完成清理后，建议重启相关服务栈以确保系统状态一致。

注意事项

1. 进行数据库操作前，建议先备份数据
2. 清理后可能需要重新配置相关的定时任务
3. 此解决方案为临时措施，建议关注官方更新以获取永久性修复

最佳实践建议

1. 在更新服务栈前，记录当前各服务的版本信息
2. 更新后检查服务状态，确认新版本正常运行
3. 定期清理不再需要的服务记录
4. 创建定时任务时，仔细核对目标服务版本

通过理解这一问题背后的机制，用户可以更有效地管理Coolify平台上的服务栈，确保系统运行的整洁性和可靠性。