coolify

Coolify - 自托管 PaaS

重要：密钥与 .env

• 切勿在任何技能文件夹中存储有效的 .env 文件或凭据。
• .env.template 文件只能放在技能中的 assets/ 目录内。
• 将有效密钥存储在 ~/.admin/.env 中，并从该处引用。

用途：在单台服务器上安装并运行 Coolify，然后通过 Nixpacks、Dockerfile 或 Docker Compose 部署应用。

步骤 0：收集所需信息（必需）

停止。在运行任何安装命令之前，向用户收集所有参数。

复制此清单并逐项确认：

Required Parameters:
- [ ] COOLIFY_SERVER_IP     - Target server IP address
- [ ] SSH_USER              - SSH username (default: ubuntu)
- [ ] SSH_KEY_PATH          - Path to SSH private key (default: ~/.ssh/id_rsa)
- [ ] COOLIFY_ROOT_USER_EMAIL    - Admin email address
- [ ] COOLIFY_ROOT_USER_PASSWORD - Admin password (see requirements below)
- [ ] COOLIFY_INSTANCE_DOMAIN    - Main Coolify URL (e.g., coolify.example.com)
- [ ] COOLIFY_WILDCARD_DOMAIN    - Base domain for apps (e.g., example.com)

Conditional Parameters (ask user):
- [ ] Using Cloudflare Tunnel for HTTPS? (Y/N)
      If Y: CLOUDFLARE_API_TOKEN, CLOUDFLARE_ACCOUNT_ID
- [ ] Need OAuth callbacks or webhooks? (Y/N)
      If Y: Will configure origin certificates
- [ ] Additional SSH public keys to authorize? (optional)

密码要求（Coolify 强制执行）

• 至少 8 个字符
• 至少包含一个大写字母（A-Z）
• 至少包含一个小写字母（a-z）
• 至少包含一个数字（0-9）
• 至少包含一个符号（!@#$%^&*）

确认所有必需参数后，才能继续步骤 1。

---

步骤 1：确定安装路径

根据用户的回答，选择相应的工作流：

路径 A：全自动化（推荐）

适用情况：新服务器、使用 Cloudflare Tunnel 提供 HTTPS、标准配置。

1. 阅读 references/ENHANCED_SETUP.md
2. 导出步骤 0 中收集的所有参数
3. 运行增强安装脚本

路径 B：手动安装

适用情况：现有服务器、自定义需求或故障排查。

1. 阅读 references/INSTALLATION.md
2. 按步骤执行 SSH 命令
3. 配置用于管理本地主机的 SSH 密钥（关键步骤）

---

步骤 2：配置安全的 HTTPS 访问

根据步骤 0 的回答确定访问方式：

场景	操作
Cloudflare Tunnel = 是	阅读 references/cloudflare-tunnel.md
OAuth/webhooks = 是	另请阅读 references/cloudflare-origin-certificates.md
仅使用直接 IP（开发环境）	跳过 Tunnel，通过 http://SERVER_IP:8000 访问

---

步骤 3：验证安装

运行此验证清单：

Verification:
- [ ] Coolify UI accessible at configured domain or IP:8000
- [ ] Login with COOLIFY_ROOT_USER_EMAIL and password works
- [ ] Servers → localhost shows "Connected" (green)
- [ ] If tunnel: HTTPS working at COOLIFY_INSTANCE_DOMAIN

如果本地主机未连接：SSH 密钥配置失败。请参阅 references/INSTALLATION.md 中的“配置 Coolify SSH 访问”部分。

---

导航

详细参考文档（仅一层）：

• 手动 SSH 安装：references/INSTALLATION.md
• 全自动配置：references/ENHANCED_SETUP.md
• 随附脚本：references/BUNDLED_SCRIPTS.md
• Cloudflare Tunnel（通配符）：references/cloudflare-tunnel.md
• 源站证书（OAuth/webhooks）：references/cloudflare-origin-certificates.md
• 错误 1033 故障排查：references/TROUBLESHOOTING_CF1033.md

重要规则

• 始终先安装带 Compose 插件的 Docker CE，再安装 Coolify。
• 未配置 HTTPS（Tunnel 或反向代理）时，不要将端口 8000 暴露到公网。
• 保持 /data/coolify 完整；将其视为状态数据。
• 始终配置 Coolify 的 SSH 密钥，以便管理本地主机。

日志集成

使用来自 admin 的集中式日志记录，记录重要操作：

log_admin "SUCCESS" "installation" "Installed Coolify" "version=4.x server=$SERVER_ID"
log_admin "SUCCESS" "system-change" "Configured Coolify" "domain=$DOMAIN"
log_admin "SUCCESS" "operation" "Deployed app via Coolify" "app=$APP_NAME"

相关技能

• devops 用于资产清单和资源配置。
• 提供商技能（oci、hetzner、contabo、digital-ocean、vultr、linode）用于特定提供商的 VM 配置。
• admin 用于在 WSL 中协调操作时提供本地 Docker/CLI 支持。

参考资料

• Coolify 文档：https://coolify.io/docs
• Coolify GitHub：https://github.com/coollabsio/coolify