Coolify (Self-hosted PaaS)

1. Przegląd koncepcji i problem systemowy

Platformy chmurowe PaaS (Vercel, Heroku, Netlify, Render) zaoferowały developerom bezprecedensowy poziom komfortu: proste git push automatycznie buduje projekt, przydziela domenę, konfiguruje SSL i wdraża serwis. Jednak za ten komfort firmy płacą finansowym uzależnieniem oraz sztywnymi ograniczeniami architektonicznymi:

• Drastyczne koszty rozliczeń: cena transferu danych w chmurze przewyższa rynkową o 10–20 razy, a rachunki za przekroczenie limitów mogą sięgać tysięcy dolarów.
• Timeouty Serverless: limity czasu wykonania funkcji (15–60 sekund) uniemożliwiają uruchamianie autonomicznych cykli agentowych, skomplikowanego scrapingu czy długotrwałego wnioskowania modeli językowych.
• Vendor lock-in: specyficzne optymalizacje utrudniają migrację kodu na własną infrastrukturę sprzętową.

Coolify oferuje najlepsze z dwóch światów: doświadczenie Vercel na własnym serwerze za $5–$20 miesięcznie. Jest to otwarty system zarządzania serwerem (Self-Hosted PaaS), instalowany jedną komendą, integrujący się z repozytoriami GitHub/GitLab i przejmujący cały cykl budowania, routingu ruchu oraz administracji bazami danych.

2. Taksonomia architektury i model mentalny

Szkielet architektoniczny Coolify opiera się na orkiestracji demona Docker oraz dynamicznym proxy:

┌─────────────────────────────────────────────────────────────┐
│                    ARCHITEKTURA HOSTA COOLIFY               │
├─────────────────────────────────────────────────────────────┤
│ 1. Dynamiczny Reverse Proxy (Silnik Traefik v3)             │
│    • Automatyczne routowanie portów przez etykiety Docker   │
│    • Automatyczne certyfikaty SSL Let's Encrypt (ACME)      │
├─────────────────────────────────────────────────────────────┤
│ 2. Płaszczyzna sterowania Coolify (API Laravel & Live UI)   │
│    • Menedżer webhooków GitHub / GitLab                     │
│    • Zarządzanie zmiennymi środowiskowymi (.env encryption) │
├─────────────────────────────────────────────────────────────┤
│ 3. Wielojęzyczny silnik budowania:                          │
│    • Nixpacks (Auto-detekcja języków: Node, Bun, Python, Go)│
│    • Budowanie przez Dockerfile / Docker Compose            │
├─────────────────────────────────────────────────────────────┤
│ 4. Zarządzane bazy danych i pamięć masowa (Postgres, Redis, │
│    S3 Backup)                                               │
└─────────────────────────────────────────────────────────────┘

1. Dynamiczny reverse proxy (Silnik Traefik):
   • Centralny dyspozytor ruchu przychodzącego. Nieustannie nasłuchuje socketu Docker: gdy podnosi się nowy kontener z etykietami domeny, Traefik natychmiast go przechwytuje, generuje certyfikat SSL i zaczyna kierować żądania HTTP/HTTPS bez restartu proxy.
2. Uniwersalny silnik budowania (Nixpacks & Docker):
   • Zapewnia kompilację kodu bez konieczności ręcznego pisania złożonych plików Dockerfile. Nixpacks automatycznie wykrywa wersję Node.js, instaluje zależności przez pnpm i generuje minimalny obraz kontenera.
3. Zarządzanie danymi jednym kliknięciem (Managed Databases):
   • Wdrażanie instancji produkcyjnych PostgreSQL, Redis, MySQL, ClickHouse lub MinIO z automatycznym szyfrowanym backupem do chmury S3 (AWS lub Cloudflare R2) zgodnie z harmonogramem.
4. Izolacja środowisk (Preview Deployments):
   • Automatyczne tworzenie odrębnych, efemerycznych kopii serwisu dla każdego otwartego Pull Requesta na tymczasowych subdomenach.

3. Pipeline techniczny i mechanika wewnętrzna

Cykl życia ciągłego wdrożenia (GitOps Lifecycle) w Coolify:

1. Commit kodu i webhook: Inżynier wykonuje git push origin main. GitHub wysyła podpisany webhook HMAC do API Coolify.
2. Walidacja i uruchomienie workera: Coolify sprawdza sygnaturę bezpieczeństwa, pobiera świeży commit według ustalonego hashu SHA i uruchamia izolowany kontener buildowy.
3. Faza kompilacji (Build Nixpacks): Instalowane są zależności, uruchamiana jest budowa aplikacji (npm run build). Tworzony jest zoptymalizowany obraz roboczy Docker.
4. Płynne przełączanie ruchu (Rolling Deployment):
   • Podnoszony jest nowy kontener aplikacji na nowym wewnętrznym porcie.
   • Traefik sprawdza stan zdrowia (Health Check).
   • Gdy tylko nowy kontener odpowiada HTTP 200, proxy przełącza ruch, a stary kontener zostaje zatrzymany (Zero-Downtime Swap).
5. Alerting i powiadomienia: Status pomyślnego wdrożenia jest wysyłany inżynierowi na Telegram lub Discord wraz z linkiem do commita.

4. Praktyczne scenariusze inżynierskie w produkcji

01. Wdrożenie pełnej platformy Next.js 15 Full-Stack na serwerze za $10

Pełne uruchomienie komercyjnego SaaS na VPS w Hetzner:

• Coolify buduje frontend Next.js, podnosi bazę PostgreSQL oraz Redis do cache’owania sesji.
• Ruch przechodzi przez wbudowany Traefik z obsługą HTTP/2 i SSL.
• Serwis obsługuje milion wyświetleń miesięcznie przy zerowych dodatkowych kosztach chmurowych.

02. Hosting długotrwałych agentów AI bez timeoutów

Wdrażanie złożonych procesów backendowych (LangGraph, autoscraping):

• Na Vercel żądanie jest przerywane po 60 sekundach.
• W Coolify agent może działać autonomicznie przez 4 godziny w tle w kontenerze, utrzymując otwarte połączenia WebSocket z klientem.

03. Tworzenie tymczasowych środowisk preview (PR Previews)

Organizacja wygodnego code review dla zespołu:

• Przy otwarciu PR #87 Coolify automatycznie podnosi aplikację pod adresem pr-87.gotburnout.dev.
• Tester sprawdza funkcjonalność na żywo przed scaleniem do gałęzi głównej, po czym kontener jest automatycznie usuwany przy zamknięciu PR.

5. Pułapki, typowe błędy i bezpieczeństwo

• Awaria serwera przez przepełnienie pamięci (Build OOM): Budowanie nowoczesnych projektów frontendowych w Next.js może zużywać do 3–4 GB RAM podczas optymalizacji bundle’ów. Na serwerach z 2 GB RAM należy bezwzględnie utworzyć plik swap (swapfile) o rozmiarze minimum 4 GB.
• Pozostawienie panelu sterującego otwartego dla skanerów: Domyślnie interfejs Coolify działa na porcie 8000. Koniecznie zabezpiecz go własną domeną z wymuszonym uwierzytelnianiem dwuskładnikowym (2FA) lub zamknij firewallem UFW, przepuszczając ruch wyłącznie przez Tailscale/VPN.
• Przepełnienie dysku przez stare obrazy Docker: Codzienne wdrożenia tworzą dziesiątki skompilowanych warstw. Jeśli nie włączysz automatycznego czyszczenia (Docker Cleanup Scheduler), dysk wypełni się w ciągu kilku tygodni.
• Przechowywanie haseł do baz danych w niezabezpieczonych plikach: Korzystaj z wbudowanego menedżera sekretów Coolify do injektowania zmiennych środowiskowych zamiast commitowania plików .env do repozytorium.