用途:在 Coolify Cloud(app.coolify.io)上通过 API 创建或更新 docker-compose 服务,并完成域名、环境变量、公开访问、自动更新与部署验证。coolify CLI 可启动/停止/查看/部署,但不能创建或编辑 compose 服务,此类操作需走 REST API。
主要能力:用 POST /services 创建服务、PATCH /services/{uuid} 修改;先准备 server/project/environment 的 UUID;用 urls API 字段固定自定义域名(不用 SERVICE_FQDN_*);通过 envs API 下发密钥;可基于上游镜像摘要轮询触发重新部署。
必要用法:docker_compose_raw 必须 base64 编码,否则返回 422。API 返回 201/200 只表示任务已排队,不代表容器已运行,必须在目标机器上验证容器健康且真实请求返回 2xx。修改应通过 API 改存储的源 compose,不要改盒子上 /data/coolify/services/<uuid>/docker-compose.yml 渲染文件。域名需先解析到该服务器,否则 TLS 证书会静默失败。令牌存 ~/.config/coolify-cloud.env(chmod 600),命令示例:coolify context add cloud https://app.coolify.io "$COOLIFY_CLOUD_API_TOKEN";coolify context verify。
适用场景:向 Coolify Cloud 管理的服务器部署新 compose 服务、修改运行中服务的镜像/端口/环境/卷/健康检查、设置自动更新、排查 API 成功但容器未启动、迁移自托管 Coolify 到 Cloud。
限制:不适用于编写应用/Dockerfile 本身、仅查状态或日志(CLI 已够)、git-push/Nixpacks 构建路径,以及纯面板 UI 问题。本地构建的 :local 镜像无仓库备份,清理后下次部署会失败;勿用 Watchtower 绕过 Coolify 重建;勿把密钥内联进 compose。具体 API 字段细节与脚本用法以官方资料为准,其他未提供。