用途
Coolify API Skill 用于通过 Coolify API 管理 Coolify 部署、应用、数据库、服务与基础设施。它的仓库为 github.com/visiongeist/coolifycli。
主要能力
该技能覆盖以下操作:
- 应用:部署应用、管理应用生命周期(启动、停止、重启)、查看应用日志、创建应用(公开 Git 仓库、私有 GitHub App、Dockerfile、Docker 镜像、Docker Compose)、管理环境变量。
- 数据库:创建与管理数据库(PostgreSQL、MySQL、MariaDB、MongoDB、Redis、KeyDB、ClickHouse、Dragonfly)、数据库生命周期(启动、停止、重启、删除)、备份配置(列出、创建、获取、更新、触发手动备份、查看执行记录、删除)。
- 服务:管理 Docker Compose 服务(列出、获取详情、启动、停止、重启、删除、创建)及其环境变量。
- 部署:部署应用(按 UUID、按标签、强制重建、即时部署跳过队列)、列出部署、获取部署详情、取消部署。
- 服务器:列出、获取详情、创建、更新、验证、查看资源、查看域名、删除。
- 项目:列出、获取详情、创建、更新、删除,以及环境管理(列出、创建、获取、删除)。
- 团队:列出、获取当前团队、获取团队成员、按 ID 获取团队。
- 安全:管理 SSH 私钥(列出、获取、创建、更新、删除)。
- GitHub Apps:列出、获取、创建、更新、删除 GitHub App,以及列出仓库与分支。
使用方式
前置条件:
- Coolify API Token:在 Coolify 面板的 Keys & Tokens → API tokens 生成,设置 COOLIFY_TOKEN 环境变量。
- Coolify API URL(可选):自托管实例需设置 COOLIFY_API_URL 环境变量(默认 https://app.coolify.io/api/v1)。
- Node.js 20+:用于运行 CLI。
- API 访问:Coolify Cloud (app.coolify.io) 或自托管实例。
基本命令示例:
列出所有应用:{baseDir}/dist/coolify-cli.cjs applications list
获取应用详情:{baseDir}/dist/coolify-cli.cjs applications get --uuid abc-123
部署应用:{baseDir}/dist/coolify-cli.cjs deploy --uuid abc-123 --force
查看应用日志:{baseDir}/dist/coolify-cli.cjs applications logs --uuid abc-123
重启应用:{baseDir}/dist/coolify-cli.cjs applications restart --uuid abc-123
配置方式: 环境变量 COOLIFY_TOKEN 必填;COOLIFY_API_URL 选填。也可在 Clawdbot 配置 ~/.clawdbot/clawdbot.json 中设置 apiKey。
输出格式:所有命令返回结构化 JSON,成功响应包含 success、data、count;错误响应包含 success、error(type、message、hint)。
适用场景
- 部署新应用:列出服务器、创建应用、配置环境变量、执行部署。
- 设置带备份的数据库:创建数据库、配置每日备份、触发手动备份。
- 监控应用健康:检查应用状态、查看近期日志、列出近期部署。
限制
- 需要 Coolify API Token 与 Node.js 20+ 环境。
- 自托管实例需正确设置 COOLIFY_API_URL,否则可能出现连接被拒绝。
- API 请求频率过高会触发限流,客户端会自动指数退避重试。
- 文档未提供收费、价格或具体平台效果信息。