SuperAPI AI 工具集

coolify

部署与运维

查看项目

更新于 10-16 05:57

技能介绍

用途

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 请求频率过高会触发限流,客户端会自动指数退避重试。
  • 文档未提供收费、价格或具体平台效果信息。