Coolify (Самостоятельная PaaS)

1. Обзор концепции и системная проблема

Облачные PaaS-платформы (Vercel, Heroku, Netlify, Render) предложили разработчикам непревзойденный уровень комфорта: простой git push автоматически собирает проект, выделяет домен, подключает SSL и разворачивает сервис. Однако за этот комфорт компании расплачиваются финансовой кабалой и жесткими архитектурными ограничениями:

• Грабительский биллинг: стоимость трафика в облаках в 10–20 раз превышает рыночную, а счета за превышение лимитов могут достигать тысяч долларов.
• Серверлесс-таймауты: лимит на выполнение функций (15–60 секунд) делает невозможным запуск автономных агентских циклов, сложного скрапинга или длительных размышлений языковых моделей.
• Вендор-локин: специфические оптимизации усложняют перенос кода на собственное железо.

Coolify предлагает лучшее из двух миров: опыт Vercel на собственном сервере стоимостью $5–$20 в месяц. Это открытая система управления сервером (Self-Hosted PaaS), которая устанавливается одной командой, подключается к репозиториям GitHub/GitLab и берет на себя весь цикл сборки, маршрутизации трафика и администрирования баз данных.

2. Архитектурная таксономия и ментальная модель

Архитектурный каркас Coolify базируется на оркестрации Docker-демона и динамическом прокси:

┌─────────────────────────────────────────────────────────────┐
│                    COOLIFY HOST ARCHITECTURE                │
├─────────────────────────────────────────────────────────────┤
│ 1. Dynamic Reverse Proxy (Traefik v3 Core Engine)           │
│    • Автоматический роутинг портов через Docker Labels        │
│    • Автоматические SSL-сертификаты Let's Encrypt (ACME)       │
├─────────────────────────────────────────────────────────────┤
│ 2. Coolify Control Plane (Laravel API & Live Web UI)        │
│    • Менеджер вебхуков GitHub / GitLab                      │
│    • Управление переменными окружения (.env encryption)       │
├─────────────────────────────────────────────────────────────┤
│ 3. Polyglot Build Engine:                                   │
│    • Nixpacks (Автодетекция языков: Node, Bun, Python, Go)     │
│    • Dockerfile / Docker Compose Builder                    │
├─────────────────────────────────────────────────────────────┤
│ 4. Managed Datastores & Storage (Postgres, Redis, S3 Backup)│
└─────────────────────────────────────────────────────────────┘

1. Динамический обратный прокси (Traefik Engine):
   • Центральный диспетчер входящего трафика. Он постоянно слушает сокет Docker: когда поднимается новый контейнер с метками домена, Traefik мгновенно подхватывает его, выпускает SSL-сертификат и начинает направлять HTTP/HTTPS запросы без перезапуска прокси.
2. Универсальный движок сборки (Nixpacks & Docker):
   • Обеспечивает сборку кода без необходимости вручную писать сложные Dockerfile. Nixpacks автоматически распознает версию Node.js, устанавливает зависимости через pnpm и генерирует минимальный контейнер.
3. Управление данными в один клик (Managed Databases):
   • Развертывание производственных инстансов PostgreSQL, Redis, MySQL, ClickHouse или MinIO с автоматическим шифрованным бэкапом в облачное хранилище S3 (AWS или Cloudflare R2) по расписанию.
4. Изоляция окружений (Preview Deployments):
   • Автоматическое поднятие отдельных эфемерных копий сервиса для каждого открытого Pull Request на временных поддоменах.

3. Технический пайплайн и внутренняя механика

Жизненный цикл непрерывного деплоя (GitOps Lifecycle) в Coolify:

1. Фиксация кода и вебхук: Инженер делает git push origin main. GitHub отправляет подписанный HMAC-вебхук на API Coolify.
2. Валидация и запуск воркера: Coolify проверяет сигнатуру безопасности, загружает свежий коммит по заданному SHA-хешу и запускает изолированный билд-контейнер.
3. Фаза компиляции (Nixpacks Build): Устанавливаются зависимости, запускается сборка приложения (npm run build). Создается оптимизированный рабочий Docker-образ.
4. Плавное переключение трафика (Rolling Deployment):
   • Поднимается новый контейнер с приложением на новом внутреннем порту.
   • Traefik проверяет состояние здоровья (Health Check).
   • Как только новый контейнер отвечает HTTP 200, прокси переключает трафик, а старый контейнер останавливается (Zero-Downtime Swap).
5. Алертинг и уведомления: Статус успешного деплоя отправляется инженеру в Telegram или Discord с ссылкой на коммит.

4. Практические инженерные сценарии в продакшене

01. Развертывание Next.js 15 Full-Stack платформы на сервере за $10

Полноценный запуск коммерческого SaaS на VPS в Hetzner:

• Coolify собирает Next.js фронтенд, поднимает базу PostgreSQL и Redis для кеширования сессий.
• Трафик проходит через встроенный Traefik с поддержкой HTTP/2 и SSL.
• Сервис выдерживает миллион просмотров в месяц с нулевыми дополнительными затратами на облако.

02. Хостинг долгосрочных AI-агентов без таймаутов

Развертывание сложных бэкенд-процессов (LangGraph, автоскрейпинг):

• На Vercel запрос обрывается через 60 секунд.
• В Coolify агент может автономно работать 4 часа подряд в фоновом контейнере, поддерживая открытые WebSockets соединения с клиентом.

03. Создание временных превью-средств (PR Previews)

Организация комфортного ревью для команды:

• При открытии PR #87 Coolify автоматически поднимает приложение по адресу pr-87.gotburnout.dev.
• Тестировщик проверяет функционал наживо до слияния в основную ветку, после чего контейнер автоматически удаляется при закрытии PR.

5. Подводные камни, типовые ошибки и безопасность

• Падение сервера из-за переполнения памяти (Build OOM): Сборка современных фронтенд-проектов на Next.js может потреблять до 3–4 ГБ оперативной памяти во время оптимизации бандлов. На серверах с 2 ГБ RAM обязательно создайте файл подкачки (swapfile) минимум на 4 ГБ.
• Оставление панели управления открытой для сканеров: По умолчанию интерфейс Coolify работает на порту 8000. Обязательно защитите его собственным доменом с принудительной двухфакторной аутентификацией (2FA), или закройте фаерволом UFW, пропуская трафик только через Tailscale/VPN.
• Переполнение дискового пространства старыми образами Docker: Ежедневный деплой создает десятки скомпилированных слоев. Если не включить автоматическую очистку (Docker Cleanup Scheduler), диск переполнится за несколько недель.
• Хранение паролей к базам данных в незащищенных файлах: Используйте встроенный менеджер секретов Coolify для инжекции переменных окружения вместо коммита файлов .env в репозиторий.