coolify

Coolify 是一个流行的开源 PaaS（平台即服务）解决方案，在 GitHub 上拥有超过 20,000 个星标，旨在为开发者提供类似 Heroku 的自托管部署体验。该 Skill 作为 Coolify API 的完整客户端封装，允许用户通过命令行界面全面管理应用部署、数据库实例、Docker 服务及底层基础设施，实现从代码到生产的全链路自动化运维。

核心用法涵盖应用生命周期管理的方方面面。用户可通过简单的命令完成应用部署、启动、停止和重启操作，支持从公共 Git 仓库、私有 GitHub App、Dockerfile、Docker Compose 等多种来源构建应用。数据库管理功能尤为强大，原生支持 PostgreSQL、MySQL、MongoDB、Redis、KeyDB、ClickHouse、Dragonfly 等八种主流数据库，并提供自动备份配置与手动触发机制。此外，Skill 还支持服务器资源管理、项目环境隔离、团队权限控制以及 SSH 私钥和 GitHub App 集成，形成完整的 DevOps 工具链。

显著优点体现在其全栈覆盖能力与灵活性。首先，统一的管理界面消除了在不同工具间切换的成本，无论是应用部署还是数据库备份，均可通过一致的 CLI 接口完成。其次，多数据库原生支持避免了用户手动配置复杂的数据库容器，配合自动备份功能，极大降低了数据丢失风险。再者，与 GitHub App 的深度集成实现了基于 webhook 的自动部署，配合环境变量管理功能，能够轻松搭建 CI/CD 流水线。最后，作为纯 Bash 脚本实现，该 Skill 仅依赖系统自带的 curl 和 jq，无额外的第三方库依赖，部署轻量且代码完全透明可审计。

然而，该 Skill 也存在一定的局限性。操作复杂性方面，大多数命令要求使用 UUID 而非友好的名称标识，用户需要频繁执行 list 命令查询 UUID，交互体验有待优化。环境依赖上，必须预先配置 COOLIFY_TOKEN 环境变量，且对于自托管实例还需正确设置 API URL，对新手有一定门槛。此外，虽然 Skill 本身仅作为 API 客户端，但所有实际操作都依赖 Coolify 服务端的稳定性，网络中断或服务端故障将直接影响可用性。

适合的目标群体主要包括：需要自托管 PaaS 解决方案的中小开发团队、希望实现基础设施即代码的 DevOps 工程师、以及使用 Coolify 托管应用的全栈开发者。对于已经在使用 Coolify 平台的用户，该 Skill 是自动化部署脚本和日常运维管理的利器；对于考虑迁移到自托管 PaaS 的团队，这也是评估 Coolify 功能完整性的绝佳入口。

使用风险主要集中在 API 令牌管理和网络配置方面。COOLIFY_TOKEN 作为访问 Coolify 资源的凭证，一旦泄露可能导致严重的安全问题，建议妥善保管并定期轮换。自托管用户需确保 API 端点使用 HTTPS 加密传输，避免在公共网络环境下暴露令牌。此外，执行强制重建（--force）等操作可能导致服务短暂中断，生产环境使用时需谨慎。由于 Skill 通过 shell 脚本调用 curl，在极端情况下错误信息可能通过 stderr 泄露敏感信息，建议在自动化脚本中重定向错误输出。

核心用法

Coolify Skill 提供对 Coolify 云原生 PaaS 平台的完整 API 封装，涵盖应用部署、数据库管理、服务编排、服务器监控等全栈运维能力。用户通过 COOLIFY_TOKEN 环境变量认证后，可使用统一的 CLI 风格命令管理资源：

应用管理：支持从 GitHub 仓库、Dockerfile、Docker 镜像或 Docker Compose 创建应用，提供启动/停止/重启生命周期控制、实时日志查看及环境变量管理（含批量更新）。

数据库服务：内置 PostgreSQL、MySQL、MariaDB、MongoDB、Redis、KeyDB、ClickHouse、Dragonfly 八种数据库的创建与生命周期管理，支持自动化备份配置（cron 表达式）和手动触发备份。

基础设施：覆盖项目管理、多环境配置（开发/测试/生产）、服务器资源监控、SSH 密钥管理及 GitHub App 集成。

显著优点

1. 零依赖安全架构：纯 Bash 实现，仅依赖系统标准工具 curl 和 jq，无第三方 npm/pip 包，彻底规避供应链攻击风险
2. 官方 API 直连：所有请求均指向 app.coolify.io 官方端点（或用户自托管实例），使用 HTTPS + Bearer Token 认证，传输层完全加密
3. 完整功能覆盖：从应用创建、数据库部署到备份策略、团队权限，几乎复刻 Coolify Dashboard 的全部能力
4. 结构化输出：所有命令返回统一 JSON 格式，便于 Agent 自动化解析和后续处理
5. 自托管友好：通过 COOLIFY_API_URL 环境变量可无缝切换至私有化部署实例

潜在局限

• UUID 依赖：多数命令要求使用 UUID 而非名称标识资源，需先执行 list 查询增加操作步骤
• Bash 环境限制：依赖 Node.js 作为脚本执行器，Windows 环境需额外配置
• 无图形反馈：纯命令行交互，复杂拓扑依赖用户自行可视化理解
• API Token 全权限：Coolify Token 通常具备较高权限，误操作可能影响生产环境

适合人群

• 需要自动化 CI/CD 部署流程的 DevOps 工程师
• 管理多项目、多环境的基础设施管理员
• 希望用代码替代 Dashboard 操作的 Coolify 重度用户
• 寻求自托管 Heroku/Render 替代方案的技术团队

常规风险

| 风险类型 | 说明 | 缓解建议 |

|---------|------|---------|

| Token 泄露 | `COOLIFY_TOKEN` 如被窃取可操控全部资源 | 使用只读 Token 做监控，部署 Token 单独管理，定期轮换 |

| 误删生产资源 | `delete` 类命令无二次确认，UUID 输入错误导致事故 | 操作前执行 `list` 核对，生产环境建议禁用删除权限 |

| 备份配置错误 | cron 表达式错误导致备份失败或资源浪费 | 先用 `--frequency` 测试常见表达式，验证执行日志 |

| 自托管实例风险 | 自定义 `COOLIFY_API_URL` 可能指向不可信地址 | 强制使用 HTTPS，验证证书，避免 IP 直连 |