SuperAPI AI 工具集

admin-app-coolify

部署与运维

查看项目

更新于 10-16 09:54

技能介绍

用途:在单台服务器上安装并运营 Coolify(开源自托管 PaaS),随后通过 Nixpacks、Dockerfile 或 Docker Compose 部署应用,在自有服务器上获得类似 Heroku 的体验。

主要能力:

  • 安装前强制收集参数:COOLIFY_SERVER_IP、SSH_USER(默认 ubuntu)、SSH_KEY_PATH(默认 ~/.ssh/id_rsa)、COOLIFY_ROOT_USER_EMAIL、COOLIFY_ROOT_USER_PASSWORD、COOLIFY_INSTANCE_DOMAIN、COOLIFY_WILDCARD_DOMAIN;必要时询问是否使用 Cloudflare Tunnel(需 CLOUDFLARE_API_TOKEN、CLOUDFLARE_ACCOUNT_ID)、是否需要 OAuth 回调或 webhook(将配置源证书)以及可选的额外 SSH 公钥。
  • 密码需满足 Coolify 强制要求:至少 8 位,含大写、小写、数字和符号(!@#$%^&*)。
  • 两条安装路径:Path A 全自动化(新服务器、Cloudflare Tunnel 提供 HTTPS、标准配置,读取 references/ENHANCED_SETUP.md 并运行增强脚本);Path B 手动安装(已有服务器、自定义需求或调试,读取 references/INSTALLATION.md 并按 SSH 步骤执行,需为 localhost 管理配置 SSH 密钥)。
  • HTTPS 接入方式:使用 Cloudflare Tunnel 时读取 references/cloudflare-tunnel.md;需要 OAuth/webhook 时另读 references/cloudflare-origin-certificates.md;仅开发用直连 IP 可跳过隧道,通过 http://SERVER_IP:8000 访问。
  • 安装后验证:UI 可在配置域名或 IP:8000 访问、用管理员邮箱与密码能登录、Servers → localhost 显示绿色 Connected、启用隧道时 HTTPS 正常。若 localhost 未连接,通常是 SSH 密钥配置失败,需参考 INSTALLATION.md 中“Configure Coolify SSH Access”。
  • 可使用 admin 的集中日志记录主要操作,例如 log_admin "SUCCESS" "installation" "Installed Coolify" "version=4.x server=$SERVER_ID",以及记录系统变更与部署操作。

关键规则:先安装带 Compose 插件的 Docker CE 再装 Coolify;不要在没有 HTTPS(隧道或反向代理)的情况下公开 8000 端口;保持 /data/coolify 完整,视为状态数据;始终为 localhost 管理配置 Coolify 的 SSH 密钥。

相关技能:admin-devops 用于清单与置备,admin-infra-* 用于特定云厂商 VM 设置,admin-wsl 用于从 WSL 协调时的本地 Docker/CLI 支持。

参考:Coolify 文档 https://coolify.io/docs ,GitHub https://github.com/coollabsio/coolify 。

限制:资料未提供具体安装命令、脚本源码、版本兼容范围与费用信息,相关细节暂未提供。