Coolify 自托管 PaaS 完全指南¶

# SSH 到你的服务器
ssh root@your-server-ip

# 一键安装脚本
curl -fsSL https://cdn.coollabs.io/coolify/install.sh | bash

# 安装完成后
# 打开 http://your-server-ip:8000
# 注册管理员账号

# 创建目录
mkdir -p /data/coolify/{source,ssh,applications,databases,backups,services,proxy,webhooks-during-maintenance}

# 下载 docker-compose
curl -fsSL https://cdn.coollabs.io/coolify/docker-compose.yml -o /data/coolify/source/docker-compose.yml
curl -fsSL https://cdn.coollabs.io/coolify/.env.production -o /data/coolify/source/.env

# 生成密钥
sed -i "s|APP_ID=.*|APP_ID=$(openssl rand -hex 16)|g" /data/coolify/source/.env
sed -i "s|APP_KEY=.*|APP_KEY=base64:$(openssl rand -base64 32)|g" /data/coolify/source/.env
sed -i "s|DB_PASSWORD=.*|DB_PASSWORD=$(openssl rand -base64 32)|g" /data/coolify/source/.env

# 启动
cd /data/coolify/source
docker compose up -d

fastapi
uvicorn[standard]

from fastapi import FastAPI
app = FastAPI()

@app.get("/")
def read_root():
    return {"message": "Hello from Coolify!"}

uvicorn main:app --host 0.0.0.0 --port 8000

Coolify UI → New Resource → Database → 选择类型：

PostgreSQL 16 ✓
MySQL 8 ✓
MariaDB ✓
MongoDB ✓
Redis ✓
ClickHouse ✓
DragonFly ✓
KeyDB ✓

# docker-compose.yml
version: '3.8'
services:
  app:
    build: .
    ports:
      - "3000:3000"
    environment:
      - DATABASE_URL=postgresql://user:pass@db:5432/mydb
    depends_on:
      - db

  db:
    image: postgres:16
    volumes:
      - pgdata:/var/lib/postgresql/data
    environment:
      POSTGRES_PASSWORD: secretpass

  redis:
    image: redis:7-alpine

volumes:
  pgdata:

Coolify UI → Application → Environment Variables

# 支持：
- 构建时变量 (Build)
- 运行时变量 (Runtime)
- Preview 环境变量 (PR Preview)

# 共享变量：
可以在 Team 级别设置共享环境变量，多个应用引用

1. Git Push 触发：
   - 在 Coolify 中启用 "Auto Deploy"
   - Coolify 自动在 GitHub 上设置 Webhook
   - 每次 push 到指定分支自动部署

2. API 触发：
   curl -X POST https://coolify.yourdomain.com/api/v1/deploy \
     -H "Authorization: Bearer $COOLIFY_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"uuid": "app-uuid"}'

3. PR Preview：
   - 每个 PR 自动创建预览环境
   - PR 合并后自动清理

Coolify UI → Database → Backups

- 计划备份：Cron 表达式（如每天凌晨3点）
- 备份保留：保留最近 N 份
- 备份存储：本地 / S3 / MinIO
- 手动备份：一键触发
- 恢复：从备份一键恢复

Coolify UI → Application → Logs
- 实时日志流
- 历史日志查看
- 容器资源使用（CPU/内存）

Coolify UI → Servers → 资源监控
- 服务器 CPU 使用率
- 内存使用
- 磁盘使用
- 网络流量

# nixpacks.toml（放在项目根目录）
[phases.setup]
nixPkgs = ["...", "ffmpeg"]  # 额外系统包

[phases.install]
cmds = ["npm ci"]

[phases.build]
cmds = ["npm run build"]

[start]
cmd = "npm start"

[variables]
NODE_ENV = "production"

# 查看构建日志
Coolify UI → Application → Deployments → 点击失败的部署

# 常见原因：
# 1. Dockerfile 错误
# 2. 依赖安装失败（网络问题）
# 3. 端口配置不匹配
# 4. 内存不足（增加 swap）

# 确保：
1. 域名 DNS 已正确指向服务器 IP
2. 端口 80 和 443 未被防火墙阻止
3. Traefik 正在运行
4. 等待 DNS 传播（可能需要几分钟）

# 在 Coolify 中，同一服务器的应用和数据库通过 Docker 网络通信
# 使用 Docker 内部主机名，不要用 localhost

# 正确：
DATABASE_URL=postgresql://user:pass@db-container-name:5432/dbname

# 在 Coolify UI 中查看数据库的内部连接地址

# Docker 镜像和构建缓存会占用大量空间
# 在服务器上清理
docker system prune -a --volumes

# 在 Coolify 中设置清理策略
# Settings → Cleanup 配置

# Coolify 支持自动更新
# Settings → 启用 Auto Update

# 或手动更新
cd /data/coolify/source
docker compose pull
docker compose up -d