579_Coolify部署平台¶

# 最低配置：
# - 2 vCPU + 2GB RAM（Coolify 本身）
# - Ubuntu 22.04+ / Debian 12+ / CentOS
# - 需要 root 权限或 sudo
# 推荐配置：一台服务器跑 Coolify，另一台跑应用（$4-5/月VPS即可）

# 当前版本：v4.0.0（2026年4月正式发布）

# 用官方脚本一键安装（需要 root 或 sudo）
curl -fsSL https://cdn.coollabs.io/coolify/install.sh | bash

# 安装过程约 3-5 分钟，会自动：
# 1. 安装 Docker（如果没有）
# 2. 拉取 Coolify 镜像
# 3. 配置反向代理（Traefik）
# 4. 启动所有服务

# 安装完成后，浏览器访问：
# http://你的服务器IP:8000

# 首次访问需要创建管理员账号
# 设置强密码 + 开启两步验证（2FA）

cd /data/coolify                     # Coolify 数据目录
docker compose up -d                 # 启动
docker compose down                  # 停止
docker compose pull && docker compose up -d  # 更新到最新版
docker compose logs -f               # 查看日志

# 在 Coolify 管理面板操作：
# 1. 连接 Git 服务（GitHub/GitLab/Gitea/Bitbucket）
#    → Settings → Git → Add Source → 授权 OAuth
# 2. 创建新资源 → Application
# 3. 选择 Git 仓库和分支
# 4. 选择构建方式：
#    - Nixpacks（自动检测语言，类似 Heroku Buildpack）
#    - Dockerfile（使用项目里的 Dockerfile）
#    - Docker Compose（使用 docker-compose.yml）
# 5. 配置域名和环境变量
# 6. 点击 Deploy → 等待构建完成

# 在 Coolify 面板操作：
# 1. 创建新资源 → Database
# 2. 选择数据库类型：
#    - PostgreSQL / MySQL / MariaDB
#    - MongoDB / Redis / ClickHouse
# 3. 设置密码和端口
# 4. 点击 Start → 数据库就跑起来了
# 5. 在应用的环境变量里填入数据库连接串

# 创建新资源 → One-Click Service
# 可用模板 280+，包括：
# - Uptime Kuma（状态监控）
# - n8n（工作流自动化）
# - Plausible（网站分析）
# - Gitea（代码托管）
# - WordPress（博客/CMS）
# - Minio（对象存储）
# 选择模板 → 配置参数 → Deploy

# 在应用设置中：
# 1. 添加域名：your-app.example.com
# 2. DNS 解析指向 Coolify 服务器 IP（A记录）
# 3. Coolify 自动通过 Let's Encrypt 申请 SSL 证书
# 4. 自动续期，无需手动操作

# 也支持自定义 SSL 证书

# Coolify 支持管理多台远程服务器：
# 1. Settings → Servers → Add Server
# 2. 填入远程服务器 IP 和 SSH 密钥
# 3. Coolify 会自动在远程服务器安装 Docker
# 4. 之后可以选择在哪台服务器上部署应用

# 支持的服务器类型：
# - VPS / 云服务器
# - 裸金属服务器
# - 树莓派

# 在应用设置中管理环境变量：
# 1. 应用 → Environment Variables
# 2. 添加 key=value 对
# 3. 支持标记为 "Build" 或 "Runtime" 变量
# 4. 敏感变量可标记为 Secret（不会在日志中显示）

# 示例：
DATABASE_URL=postgresql://user:pass@db:5432/mydb  # 数据库连接
API_KEY=sk-xxxx                                    # API 密钥（标记为 Secret）
NODE_ENV=production                                # 运行环境

# 对于复杂应用，可以直接使用 docker-compose.yml
# 在 Coolify 中选择 "Docker Compose" 构建方式

# 示例 docker-compose.yml
services:
  app:
    build: .                          # 从 Dockerfile 构建
    environment:
      - DATABASE_URL=${DATABASE_URL}  # 使用 Coolify 管理的环境变量
    depends_on:
      - db
  db:
    image: postgres:16                # PostgreSQL 数据库
    volumes:
      - pgdata:/var/lib/postgresql/data
volumes:
  pgdata:

# 方法1：Git Webhook（推荐）
# Coolify 自动设置 Webhook，push 后自动部署

# 方法2：GitHub Actions 触发
# 在 GitHub Actions workflow 中调用 Coolify API：
curl -X POST "https://coolify.example.com/api/v1/deploy" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \   # Coolify API Token
  -H "Content-Type: application/json" \
  -d '{"uuid": "应用UUID"}'                      # 应用的 UUID

# === Coolify 常用操作 ===
# 安装：curl -fsSL https://cdn.coollabs.io/coolify/install.sh | bash
# 数据目录：/data/coolify/
# 配置文件：/data/coolify/.env
# 更新：docker compose pull && docker compose up -d

# === 默认端口 ===
# 8000  → Coolify 管理面板
# 80    → HTTP（Traefik）
# 443   → HTTPS（Traefik）

# === 支持的构建方式 ===
# Nixpacks   → 自动检测语言并构建（最简单）
# Dockerfile → 使用自定义 Dockerfile
# Docker Compose → 使用 docker-compose.yml
# Buildpack  → Heroku 兼容的构建包

# === 支持的 Git 平台 ===
# GitHub | GitLab | Bitbucket | Gitea | 自定义 Git