Tinklaraštis

Coolify ir Claude Code: įdiekite projektą nuosavame VPS

Markdown

Coolify diegimas, „GitHub“ prijungimas, „Next.js“ diegimas, domenas ir HTTPS, MCP, VPS reikalavimai ir trikčių šalinimas. Techninės kainos doleriais ir pirminiai apribojimai.

Skaityti visą straipsnį

Ailoot dokumentacija — informacinė medžiaga, padedanti naudotis paslauga.

Platformos apribojimai ir mokėjimo sąlygos 2026 m.

Svarbiausia šio skyriaus mintis

Nemokami planai veikia tol, kol pirmą kartą viršijate limitą; tada reikia tarptautinės kortelės. 2022 m. „Heroku“ visiems panaikino nemokamą planą, o 2026 m. vasarį perėjo į palaikymo režimą. Naudodami savarankiškai priglobtą Coolify, serveris priklauso jums; nėra mokesčio už naudotoją ir neprisirišate prie tiekėjo.

Tipinis 2026 m. vibe coding scenarijus: per vakarą sukuriate MVP naudodami Cursor arba Claude Code, perkeliate jį į „GitHub“ saugyklą, atidarote vercel.com → prijungiate saugyklą → pasiekiate prenumeratos ekraną → įvedate kortelės duomenis → gaunate Transaction declined.

Tai nėra klaida ar laikinas sutrikimas.

„Railway“, „Render“, „Heroku“ — visur ta pati istorija. „Heroku“ iš tiesų 2022 m. visiems panaikino nemokamą planą, o 2026 m. vasarį projektas perėjo į palaikymo režimą — nebekuriamos naujos funkcijos ir nebesudaromos naujos „Enterprise“ sutartys. Naudotojui, turinčiam nepalaikomą kortelę, tai reiškia: „durys uždarytos; eikite aplinkui per tarpininką, kuris ima 20 % komisinį mokestį“.

Galite mokėti virtualiosiomis „Visa“ kortelėmis Kazachstane arba įmonių mokėjimo paslaugomis. Tačiau tai reiškia 20 % didesnę kainą, 30 minučių prie kiekvienos operacijos ir riziką, kad jūsų paskyra bus užblokuota, kai mokėjimo apdorotojas aptiks neatitinkančią šalį.

Pirminiame pavyzdyje buvo trys bandymai — su Vercel Pro, Railway ir Render.

Kas yra Coolify ir kaip veikia savarankiškai priglobta platforma?

Svarbiausia šio skyriaus mintis

Coolify yra atvirojo kodo, savarankiškai priglobiamas PaaS ir tiesioginė „Heroku“, „Vercel“ bei „Netlify“ alternatyva. Jis įdiegiamas viena curl komanda bet kuriame VPS su Ubuntu. Viduje naudojamas Docker + Traefik atvirkštiniam tarpiniam serveriui ir Let's Encrypt HTTPS. Palaikoma „GitHub“ integracija, automatinio diegimo saityno kabliukai, S3 atsarginės kopijos ir daugiau nei 280 paslaugų, įdiegiamų vienu spustelėjimu (PostgreSQL, Redis, MinIO). Savarankiškai priglobta versija visada nemokama ir be apribojimų. „GitHub“ ji turi 55,800 žvaigždučių ir Apache-2.0 licenciją.

Coolify yra atvirojo kodo projektas, sukurtas su Laravel + Docker, kuris bet kurį tuščią VPS paverčia programų diegimo platforma. Įdiekite Coolify vieną kartą, o visa kita atlikite žiniatinklio sąsajoje: prijunkite „GitHub“, pasirinkite saugyklą ir spustelėkite Deploy.

Oficialioje dokumentacijoje tai nusakyta trumpai ir tiksliai:

Coolify yra atvirojo kodo ir savarankiškai priglobta „Heroku“ / „Netlify“ / „Vercel“ ir kt. alternatyva.

— Coolify „GitHub“ README, https://github.com/coollabsio/coolify

Coolify sudaro keturios dalys:

  1. Žiniatinklio sąsaja, sukurta naudojant Laravel 12 + Livewire 3 + Tailwind v4 — programoms valdyti skirta valdymo aplinka.
  2. Docker + Docker Compose — kiekviena programa veikia atskirame konteineryje.
  3. Atvirkštinis tarpinis serveris (Traefik arba Caddy) — priima gaunamą HTTP/HTTPS srautą ir nukreipia jį į konteinerius.
  4. Let's Encrypt integracija — automatiškai išduoda ir atnaujina SSL sertifikatus visiems domenams.

Pagrindinės funkcijos, dėl kurių Coolify funkcijomis prilygsta Vercel:

FunkcijaVercelCoolify
Automatinis diegimas po git push✅✅ (per „GitHub“ saityno kabliuką)
Nemokamas HTTPS✅✅ (Let's Encrypt)
PR peržiūros diegimai✅✅ (per „GitHub App“)
Aplinkos kintamųjų sąsaja✅✅
Duomenų bazių atsarginės kopijos❌ (neturi savo duomenų bazių)✅ (į su S3 suderinamą saugyklą)
PostgreSQL / Redis / MongoDB$20+/mėn. už kiekvieną✅ Įdiegiama vienu spustelėjimu, nemokamai
Suplanuotos užduotys (cron)❌✅ (cron sintaksė)
Mokestis už naudotoją$20/naudotojui/mėn.Nėra
Priklausomybė nuo tiekėjoDidelė (Edge Functions, ISR)Nulinė (jūsų Docker)
Pasaulinis CDN✅❌ (tik jūsų VPS)

Vienintelis dalykas, kurio Coolify neturi iškart, yra pasaulinis CDN. Tai sąžiningas atsakymas. Jei jūsų projektas skirtas pasaulinei auditorijai ir norite sumažinti delsą JAV bei Europoje, naudokite Cloudflare; statiniam turiniui jis nemokamas.

Kaina: savarankiškai priglobta versija visada nemokama — programų, serverių ar diegimų skaičius neribojamas. Coolify Cloud kainuoja $5/mėn. už 2 serverius ir $3 už kiekvieną papildomą — tačiau serveriai vis tiek priklauso jums; Coolify Cloud tik priglobia valdymo skydelį.

Naujausia versija — v4.1.0, išleista 2026 m. gegužės 18 d. Naujos funkcijos: beta versijos Railpack komponavimo paketas, audito žurnalai, diegimų konfigūracijų skirtumai ir vietinis MCP galinis taškas (tik skaitymui). Šaltinis: „GitHub“ leidimai.

Kokį VPS pasirinkti Coolify 2026 m.?

Svarbiausia šio skyriaus mintis

Coolify reikia mažiausiai 2 vCPU, 2 GB RAM, 30 GB SSD ir Ubuntu LTS (20.04, 22.04 arba 24.04). Toks VPS gali patogiai vienu metu paleisti 3–5 vibe coding būdu sukurtus projektus.

Minimalūs Coolify reikalavimai pateikti oficialioje dokumentacijoje:

ParametrasMinimumasRekomenduojama
CPU2 branduoliai2–4 branduoliai
RAM2 GB4 GB (paliekant vietos komponavimui)
Saugykla30 GB50–80 GB (atvaizdams ir duomenų bazėms)
ArchitektūraAMD64 arba ARM64 (64 bitų)AMD64
OSUbuntu LTS 20.04 / 22.04 / 24.0422.04 LTS
RootBūtinaPer SSH raktą, ne slaptažodį

2 GB RAM minimumas yra griežta apatinė riba. Turint 1 GB, diegimo programa pasiekia Docker, susiduria su OOM (atminties trūkumu) ir pakimba. Netaupykite RAM.

Kainų šaltiniai: Timeweb Cloud, FirstVDS ir Selectel.

Jei reikia daugiau galios (100 GB duomenų bazės, kelių Postgres egzempliorių), rinkitės Aeza Dedicated.

Ko NErinktis:

  • Bendrinamas VPS su 512 MB–1 GB RAM — net Coolify nepakaks. Toks serveris skirtas statinėms svetainėms su nginx, o ne PaaS.

Norite ne tik sukonfigūruoti diegimą, bet ir sukurti sąranką, kuri padėtų Claude veikti patikimai? Coolify yra vykdymo įrankis, tačiau be struktūruoto konteksto (CLAUDE.md, antrojo smegenų ir konteksto inžinerijos) Claude vis tiek haliucinuos vykdydamas ilgas užduotis. Visą sąranką sudaro visi trys elementai: AI klonas + Antrieji smegenys + Konteksto inžinerija — šis derinys paverčia Claude iš „haliucinuojančio asistento“ patikimu įrankiu.

Kaip įdiegti Coolify per 5 minutes

Svarbiausia šio skyriaus mintis

Diegiama viena komanda iš dokumentacijos. Paleidus ją, 8000 prievade pasirodo žiniatinklio sąsaja. Ten sukuriate pirmąjį administratorių ir matote tuščią valdymo skydelį. Nuo tuščio Ubuntu diegimo iki veikiančio Coolify praeina 5–7 minutės, iš kurių 3–4 minutės skiriamos apt-get install docker. Scenarijus atsisiunčia reikalingas priklausomybes ir pats sukonfigūruoja Docker; tereikia palaukti, kol baigs darbą.

1 žingsnis. Prisijunkite prie VPS per SSH.

Sukūrus VPS pas paslaugų teikėją, serverio IP adresas ir root slaptažodis bus atsiųsti el. paštu arba rodomi valdymo skydelyje. Prisijunkite iš savo kompiuterio:

ssh root@1.2.3.4

Jei paslaugų teikėjas vietoj slaptažodžio davė SSH raktą, prisijunkite su -i path/to/key. Toliau daroma prielaida, kad turite naują Ubuntu 22.04 arba 24.04 LTS diegimą.

2 žingsnis. Paleiskite Coolify diegimo komandą.

Viena komanda iš oficialios dokumentacijos:

curl -fsSL https://cdn.coollabs.io/coolify/install.sh | sudo bash

Scenarijus atlieka tris veiksmus:

  1. Patikrina sistemą (Ubuntu LTS? root? AMD64?)
  2. Įdiegia Docker ir Docker Compose, jei jie dar neįdiegti
  3. Atsisiunčia Coolify atvaizdus (coolify/coolify, coolify/realtime, traefik) ir paleidžia juos fone per docker-compose

Tai užtrunka 3–5 minutes. Matysite slenkančius apt-get žurnalus, o po jų — docker pull. Kai pasirodys Coolify v4.1.0 is now running, pereikite prie 3 žingsnio.

3 žingsnis. Atidarykite žiniatinklio sąsają.

Atidarykite naršyklėje:

http://1.2.3.4:8000

Coolify parodys sąrankos vedlį — pirmojo naudotojo sukūrimo formą. Įveskite el. pašto adresą ir slaptažodį, tada išsaugokite. Šis naudotojas automatiškai taps administratoriumi; kol kas kitų naudotojų nereikia.

Išsaugoję pateksite į tuščią valdymo skydelį: kairėje bus šoninė juosta su Resources / Projects / Servers / Sources / Notifications / Settings, o centre — raginimas „Add your first resource“.

4 žingsnis. Atidarykite prievadus paslaugų teikėjo užkardoje (ne UFW).

Coolify jau veikia, tačiau iš išorės pasiekiamas tik 8000 prievadas (valdymo skydelis). Kad naudotojai galėtų pasiekti jūsų programas, atidarykite 80 (HTTP) ir 443 (HTTPS) prievadus:

PrievadasPaskirtis
22SSH prieiga prie serverio
80Priima HTTP srautą; būtinas Let's Encrypt patvirtinimui
443Priima naudotojų HTTPS srautą
8000Coolify valdymo skydelis (uždarome sukonfigūravę pasirinktinį skydelio domeną)

Svarbi oficialioje dokumentacijoje aprašyta klaida:

Docker naudoja NAT pagrįstas iptables taisykles, kurios gali apeiti tradicines Linux užkardas, pavyzdžiui, UFW.

— Coolify dokumentacija (užkarda), https://coolify.io/docs/knowledge-base/server/firewall

Tai reiškia, kad net įjungus UFW ir uždarius visus prievadus, Docker per iptables vis tiek atvers konteinerius. UFW čia nenaudingas. Prievadus atidarykite ir uždarykite paslaugų teikėjo valdymo skydelyje, o ne per UFW. Timeweb / Selectel / Aeza atveju tai daroma žiniatinklio konsolės skiltyje „Network → Firewall“.

5 žingsnis (pasirinktinis). Susiekite valdymo skydelį su savo domenu.

Norėdami lankytis adresu https://coolify.example.com, o ne http://1.2.3.4:8000, sukurkite DNS A įrašą coolify.example.com → 1.2.3.4, Coolify eikite į Settings → Instance Settings → Instance Domain, įveskite savo padomenį ir išsaugokite. Coolify paprašys Let's Encrypt sertifikato ir po minutės iš naujo įkels valdymo skydelį per HTTPS.

Tada užkardoje galite uždaryti 8000 prievadą — valdymo skydelis bus pasiekiamas per HTTPS standartiniame 443 prievade.

Kaip prijungti „GitHub“: App ar PAT?

Svarbiausia šio skyriaus mintis

Coolify palaiko du „GitHub“ prijungimo būdus: GitHub App (rekomenduojamas) ir Personal Access Token (PAT). Rinkitės GitHub App: sąranka su vedliu trunka 5 minutes, veikia PR peržiūros, o leidimus galima tiksliai apriboti saugyklos lygmeniu. PAT yra pasenęs būdas senesniems atvejams; jis nepalaiko peržiūros diegimų ir kelia riziką suteikti visuotinę prieigą prie visų saugyklų. Oficialioje dokumentacijoje tiesiai sakoma: „95 % naudotojų GitHub App yra tinkamas pasirinkimas.“

Coolify eikite į Sources → + Add → GitHub App. Coolify parodys trijų ekranų vedlį:

  1. Name & description — pavadinkite šaltinį (įveskite github-main) ir, jei norite, pridėkite aprašymą.
  2. Configure on GitHub — mygtukas nukels į GitHub.com ir automatiškai atvers „GitHub App“ kūrimo formą su tinkamais leidimais.
  3. Confirm — grįžę iš „GitHub“ spustelėkite „Save“.

Antrame žingsnyje „GitHub“ paprašys patvirtinti Coolify reikalingus leidimus:

LeidimasLygisPaskirtis
ContentsTik skaitymasKlonuoti saugyklą
Pull RequestsSkaitymas ir rašymasSukurti peržiūros diegimus ir komentuoti PR
Email addressesTik skaitymasNustatyti įsipareigojimų autorius
MetadataTik skaitymasIšvardyti saugyklas

Tai minimalūs leidimai — „GitHub App“ negali matyti jūsų privačių raktų, rašyti į main ar pasiekti saugyklų, kurių aiškiai neprijungėte.

Oficialioje dokumentacijoje rašoma:

Personal Access Token (PAT) yra senasis būdas; rekomenduoju jo nenaudoti. Trūkumai:

  • PAT suteikia visuotinę prieigą prie visų jūsų saugyklų, įskaitant privačias
  • PR peržiūros neveikia — ši funkcija skirta tik GitHub App
  • Žetonas galioja ilgai (90 dienų, metus arba neribotai); jam nutekėjus, kyla problemų

PAT naudokite tik jei dirbate su organizacijos saugykla, kurios saugumo politika draudžia „GitHub Apps“, ir nėra kito būdo.

Išsaugoję šaltinį Coolify, valdymo skydelyje matysite „GitHub App“ ir prijungtų saugyklų sąrašą. Kurdami naują programą, galėsite pasirinkti bet kurią iš jų vienu spustelėjimu.

Kaip įdiegti Next.js projektą iš Claude Code per 6 žingsnius

Svarbiausia šio skyriaus mintis

Visas kelias nuo tuščios Claude Code sąrankos iki veikiančios svetainės: 1) tuščiame aplanke paleiskite claude, apibūdinkite projektą, o Claude sugeneruos kodą; 2) paleiskite git init && git remote add (Claude gali tai atlikti pats naudodamas slash komandą); 3) nusiųskite į „GitHub“; 4) Coolify pasirinkite „+ New Resource → Application“ ir saugyklą; 5) pridėkite aplinkos kintamuosius; 6) spustelėkite Deploy. Coolify aptiks Next.js, pasirinks Nixpacks komponavimo paketą, per 3–5 minutes sukurs Docker atvaizdą ir pateiks laikiną xxx formato domeną su iškart veikiančiu HTTPS.

1 žingsnis. Tuščiame aplanke apibūdinkite projektą Claude Code.

mkdir my-vibe-app
cd my-vibe-app
git init
claude

Sesijoje:

Sukurk Next.js 14 programą su app router:
- pagrindinį puslapį su naudotojų sąrašu
- /api/users galinį tašką, grąžinantį masyvą iš duomenų bazės
- Postgres per Prisma
- Tailwind stiliams
- .env.example su DATABASE_URL
- README.md su projekto paleidimo instrukcijomis

Claude sugeneruos failų struktūrą, package.json, prisma/schema.prisma ir .env.example. Taip pat paprašykite:

Sukurk Dockerfile gamybiniams komponavimams ir .dockerignore.

Tai pasirenkama — Coolify komponuos su Nixpacks ir be Dockerfile. Tačiau Dockerfile leidžia valdyti procesą ir didesniuose projektuose veikia greičiau.

2 žingsnis. Sukurkite „GitHub“ saugyklą ir įkelkite į ją projektą.

Tai galite atlikti rankiniu būdu per „GitHub“ sąsają ir git remote add origin ..., tačiau Claude Code gali tai padaryti pats:

/commit-push-pr Pradinė Next.js programa, sukurta naudojant Claude Code

Arba tiesiog pasakykite: „Įsipareigok visus pakeitimus ir nusiųsk juos į naują saugyklą my-vibe-app mano paskyroje.“ Claude naudos gh CLI, kad sukurtų privačią (arba viešą) saugyklą ir pirmą kartą įkeltų kodą. Šaltinis: oficiali Claude Code komanda.

3 žingsnis. Sukurkite programą Coolify.

Coolify valdymo skydelyje spustelėkite + New → Application. Atsivers forma:

  1. Source — pasirinkite github-main („GitHub App“, kurią prijungėte ankstesniame H2 skyriuje)
  2. Repository — sąraše pasirinkite my-vibe-app
  3. Branch — main
  4. Build Pack — Coolify aptiks automatiškai. Jei yra Dockerfile, naudos dockerfile; kitu atveju — nixpacks. Šį pasirinkimą galite pakeisti rankiniu būdu.
  5. Domain — kol kas palikite pasiūlytą laikiną reikšmę; vėliau pakeisite ją sava
  6. Port — Next.js numatytoji reikšmė 3000

Išsaugokite.

4 žingsnis. Pridėkite aplinkos kintamuosius.

Sukurtoje programoje atidarykite Environment Variables kortelę. Pridėkite kintamuosius po vieną:

DATABASE_URL=postgresql://user:pass@db-host:5432/mydb
NODE_ENV=production
ANTHROPIC_API_KEY=sk-ant-...

Jei neturite duomenų bazės, sukurkite ją tiesiai Coolify: + New → Database → PostgreSQL. Coolify per 30 seconds paleis Postgres konteinerį ir pateiks vidinį DATABASE_URL formatu postgresql://postgres@postgres-xyz:5432/postgres — įrašykite jį į programą.

Visi kintamieji užšifruojami Coolify duomenų bazėje ir nerodomi komponavimo žurnaluose.

5 žingsnis. Spustelėkite Deploy.

Viršutiniame dešiniajame kampe yra mėlynas Deploy mygtukas. Tiesioginiai žurnalai bus rodomi Logs kortelėje:

[stage: clone]   Klonuojama '<repository-url-from-github>'
[stage: build]   Aptiktas Next.js, naudojamas Nixpacks
[stage: build]   Diegiami Node 20, npm 10
[stage: build]   npm install (245s)
[stage: build]   npm run build (87s)
[stage: deploy]  Kuriamas konteineris my-vibe-app-xyz
[stage: deploy]  Konteineris paleistas, būklės patikra sėkminga
[stage: proxy]   Traefik maršrutas sukonfigūruotas laikinam domenui
[stage: ssl]     Išduotas Let's Encrypt sertifikatas laikinam domenui

Pirmasis komponavimas trunka 3–5 minutes (atsisiunčiamas bazinis Node atvaizdas ir įdiegiamos priklausomybės). Vėlesni komponavimai trunka 60–90 seconds, nes talpykloje laikomi Docker sluoksniai.

Kai būsena pasikeis į Running, nukopijuokite Coolify lauke Domains rodomą programos URL ir naršyklėje atverkite būtent jį. Toliau šią reikšmę naudokite kaip <app-url-from-coolify>; žyma kampiniuose skliaustuose yra vietaženklis, o ne tikras adresas. Turėtų pasirodyti pagrindinis puslapis su iškart veikiančiu HTTPS. Coolify laikinam domenui naudoja nemokamą pakaitinių simbolių DNS paslaugą, kuri išsprendžia bet kurį padomenį su IP adresu (1-2-3-4 → 1.2.3.4). Taip galite iškart atidaryti svetainę nekonfigūruodami savo DNS.

6 žingsnis. Patikrinkite, ar viskas veikia.

Atverkite ankstesnio žingsnio programos URL su pridėtu /api/users, pavyzdžiui, <app-url-from-coolify>/api/users, nedubliuodami pasvirojo brūkšnio. Tai 1 žingsnyje sukurtas JSON galinis taškas; šakninis programos URL yra pagrindinis puslapis. Jei gaunate 500 klaidą, pėdsaką matysite Logs kortelėje. Dažniausia pirmojo diegimo problema — DATABASE_URL nurodo neegzistuojančią duomenų bazę. Išspręskite ją Coolify sukūrę PostgreSQL egzempliorių (žr. 4 žingsnį) ir pakeitę DATABASE_URL.

15 minučių nuo to momento, kai užsakote VPS. Pirminiame pavyzdyje šis procesas naujame serveryje truko 12–18 minučių.

Kaip sukonfigūruoti pasirinktinį domeną ir HTTPS

Svarbiausia šio skyriaus mintis

Pasirinktinis domenas prijungiamas per 3 žingsnius: sukurkite DNS A įrašą, nukreipiantį į serverio IP, Coolify vietoj laikino domeno įveskite savo domeną, įjunkite Automatic HTTPS ir spustelėkite Redeploy. Let's Encrypt automatiškai išduos SSL sertifikatą praėjus 2–3 minutėms po DNS sklaidos (paprastai tai trunka 5–30 minučių). Svarbiausia, kad spustelėjus Redeploy DNS jau būtų išsprendžiamas; kitaip Let's Encrypt patvirtinimas nepavyks ir iki kito bandymo reikės laukti 12 minučių.

1 žingsnis. Domeno registratoriaus valdymo skydelyje sukurkite DNS A įrašą.

Pirminiuose pavyzdžiuose naudojami Reg.ru, Beget arba Timeweb priglobti domenai. Veiksmai tokie patys:

Įrašo tipasPavadinimasReikšmė
Aapp (arba @ šakniniam domenui)1.2.3.4 (serverio IP)

Išsaugokite, atidarykite konsolę ir patikrinkite:

dig app.example.com +short
# Turėtų grąžinti 1.2.3.4

Jei nieko negrąžinama arba rodomas kitas IP, DNS dar neišplito. Palaukite 5–30 minučių.

2 žingsnis. Coolify įveskite savo domeną.

Programoje atidarykite Configuration → General kortelę. Lauke Domains laikiną programos URL, nukopijuotą iš Coolify, pakeiskite į https://app.example.com (naudodami savo sukonfigūruotą domeną). Įjunkite Automatic HTTPS (paprastai jis įjungtas pagal numatytuosius nustatymus).

Išsaugokite ir spustelėkite Redeploy.

3 žingsnis. Palaukite Let's Encrypt sertifikato.

Komponavimo žurnaluose bus rodoma:

[stage: ssl]  Prašoma Let's Encrypt sertifikato app.example.com domenui
[stage: ssl]  HTTP patikra nusiųsta į /.well-known/acme-challenge/xxx
[stage: ssl]  Patvirtinimas sėkmingas, sertifikatas išduotas
[stage: ssl]  Sertifikatas įdiegtas, HTTPS įjungtas

Po 2–3 minučių svetainė bus pasiekiama adresu https://app.example.com, o adreso juostoje matysite žalią spynelę.

Kas gali nepavykti naudojant Let's Encrypt (3 dažniausios problemos iš oficialaus trikčių šalinimo vadovo):

  1. Užkardoje uždarytas 80 prievadas. Let's Encrypt patvirtina domeną HTTP užklausa — siunčia užklausą į http://app.example.com/.well-known/acme-challenge/xxx. Jei 80 prievadas uždarytas, patvirtinimas nepavyks. Atidarykite jį paslaugų teikėjo užkardoje.
  2. Įjungtas Cloudflare tarpinis serveris (oranžinis debesis). Jis perima Let's Encrypt užklausą ir pateikia savo numatytąjį puslapį, todėl patvirtinti nepavyksta. Sprendimas — pasirinkti „DNS only“ (pilką debesį) arba per Cloudflare API sukonfigūruoti DNS-01 iššūkį.
  3. DNS dar neišplito. Jei A įrašą sukūrėte prieš 30 sekundžių ir iškart spustelėjote Redeploy, Let's Encrypt domeno dar nematys. Palaukite 5–30 minučių, kol DNS įrašas pasklis serveriuose.

Let's Encrypt dažnio limitas: 5 nesėkmingi bandymai per valandą vienam domenui, limitas atsistato po vieną bandymą kas 12 minučių. Jei jį pasieksite, nespauskite Redeploy 10 kartų iš eilės; patikrinkite žurnalus, išspręskite problemą ir bandykite dar kartą po 12 minučių.

Kaip Claude Code per MCP valdo Coolify?

Svarbiausia šio skyriaus mintis

Per Model Context Protocol Claude Code gauna tiesioginę prieigą prie Coolify API — galite paprašyti „įdiegti šią programą“, pradėti komponavimą, patikrinti būseną, perskaityti žurnalus arba atnaujinti aplinkos kintamuosius. Galimi trys variantai: forsonny/Coolify-MCP-Server (pagrindinis, 7 operacijų kategorijos), dazeb/coolify-mcp-enhanced (daugiau nei 15 papildomų įrankių ir vieno spustelėjimo duomenų bazės diegimas) ir ajmcclary/Coolify-Manager (Claude Skill, sukurtas aplink oficialią CLI). Nuo v4.1.0 (2026 m. gegužės 18 d.) Coolify teikia vietinį MCP galinį tašką be trečiųjų šalių serverių, tačiau kol kas jis tik skaitomas.

Model Context Protocol (MCP) yra Anthropic standartas, leidžiantis Claude Code bendrauti su išorinėmis sistemomis (daugiau skaitykite MCP serverių vadove). Prijunkite MCP serverį ir Claude gaus įrankių rinkinį, kuriuo galės naudotis. Yra trys paruošti Coolify serveriai ir viena vietinė parinktis.

1 variantas. forsonny/Coolify-MCP-Server-for-Claude-Code — pagrindinis.

Ką jis gali:

  • Programos: sukurti, paleisti, sustabdyti, paleisti iš naujo
  • Paslaugos: išvardyti, sukurti, paleisti / sustabdyti / paleisti iš naujo
  • Diegimai: peržiūrėti vykdomus, gauti pagal UUID
  • Komandos ir nariai: išvardyti, gauti informaciją
  • SSH raktai: išvardyti, sukurti
  • Aplinkos kintamieji: pilnas CRUD programoms ir paslaugoms
  • Serverio įžvalgos: domenai serveryje, būklė, versija

Diegimas:

git clone '<OFFICIAL_URL>'
cd Coolify-MCP-Server-for-Claude-Code
npm install
npm run build
# .env faile:
#   COOLIFY_BASE_URL=https://coolify.example.com
#   COOLIFY_API_TOKEN=[iš Coolify Settings → API Tokens]
npm run setup  # automatiškai sukonfigūruoja Claude Code

Tada Claude Code galite įvesti:

Parodyk Coolify programos my-vibe-app būseną ir 3 naujausius diegimus.

Claude pateiks lentelę.

2 variantas. dazeb/coolify-mcp-enhanced — išplėstinis (rekomenduojamas).

Ką jis prideda prie pagrindinio rinkinio:

  • Vienu spustelėjimu per AI įdiegiamas PostgreSQL / Redis / MinIO — paprašykite „sukonfigūruok man Postgres“, ir sukuriamas konteineris bei grąžinamas DATABASE_URL
  • Stebėjimas realiuoju laiku ir išteklių naudojimas — kiekvienos programos CPU/RAM realiuoju laiku
  • Masinis env konfigūracijų atnaujinimas — viena komanda atnaujinkite 20 kintamųjų
  • Docker Compose palaikymas — diekite kelių paslaugų programas

Claude Code konfigūracija (.mcp.json projekto šakniniame aplanke):

{
  "mcpServers": {
    "coolify-enhanced": {
      "command": "node",
      "args": ["/path/to/coolify-mcp-enhanced/dist/index.js"],
      "env": {
        "COOLIFY_ACCESS_TOKEN": "your-token-here",
        "COOLIFY_BASE_URL": "https://coolify.example.com"
      }
    }
  }
}

3 variantas. ajmcclary/Coolify-Manager — Claude Skill, sukurtas aplink CLI.

Tai ne MCP serveris, o Claude Code Skill, apgaubiantis oficialią Coolify CLI. Jame yra:

  • Paslaugų ir konteinerių būklės diagnostika
  • SSL sertifikatų diagnostika
  • Kelių egzempliorių palaikymas (jei turite kelis Coolify serverius)
  • Trikčių šalinimo receptai

Diegimas: atsisiųskite įgūdį ir įdėkite jį į ~/.claude/skills/coolify-manager/. Claude Code jį aptiks ir pasiūlys atlikti atitinkamas užduotis.

4 variantas (naujas 2026 m. gegužę). Vietinis MCP Coolify v4.1.0.

2026 m. gegužės 18 d. datuotame v4.1.0 pakeitimų žurnale rašoma:

Pridėtas egzemplioriaus lygmens MCP palaikymas su tik skaitymo įrankiais Coolify ištekliams ir API / UI.

Coolify dabar turi savo MCP galinį tašką — galite tiesiogiai prijungti Claude Code be trečiųjų šalių serverių. Kol kas jis tik skaitomas (programų sąrašai, būsenos, konfigūracijos) ir neturi keitimo operacijų. Tačiau to pakanka daugeliui užduočių, pavyzdžiui, „papasakok apie infrastruktūrą“.

Prijunkite per .mcp.json:

{
  "mcpServers": {
    "coolify-native": {
      "url": "https://coolify.example.com/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer <your-api-token>"
      }
    }
  }
}

Tikimasi, kad vietinis MCP v4.2 arba v4.3 versijoje įgis visą rašymo prieigą — Coolify komanda pažadėjo ją suteikti iki 2026 m. pabaigos.

5 pirmojo diegimo klaidos ir kaip jų išvengti

Svarbiausia šio skyriaus mintis

Dažniausios pirmojo diegimo klaidos: nepakanka RAM, uždarytas 80 prievadas, Cloudflare tarpinis serveris sutrikdo Let's Encrypt veikimą, UFW neapsaugo Docker, pasirinktas PAT vietoj GitHub App. Visa tai aprašyta oficialioje dokumentacijoje, tačiau neturint praktinės patirties lengva su šiomis problemomis susidurti. Toliau pateikiamas 5 punktų kontrolinis sąrašas, pagrįstas pradine Coolify diegimo patirtimi.

1 klaida: mažiau nei 2 GB RAM — diegimas nutrūksta dėl OOM.

Požymis: curl install.sh pasiekia docker pull coolify/coolify, pakimba ties 70 %, tada procesas nutraukiamas su Killed (signal 9). dmesg | tail žurnaluose rodoma Out of memory: Killed process.

Sprendimas:

# Laikinai problemai išspręsti sukurkite 4 GB apsikeitimo failą
sudo fallocate -l 4G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab

Ilgainiui padidinkite RAM iki 4 GB. Coolify veikia naudojant apsikeitimo sritį, tačiau didelių Next.js projektų komponavimas gali nepavykti.

2 klaida: įjungtas UFW, bet Docker vis tiek atveria prievadus.

Požymis: įjungėte UFW ir uždarėte visus prievadus, išskyrus 22, tačiau jūsų programa vis tiek pasiekiama internete per kokį nors atsitiktinį prievadą (pavyzdžiui, 3000).

Priežastis iš oficialios dokumentacijos:

Coolify veikia Docker aplinkoje, o Docker naudoja NAT pagrįstas iptables taisykles ir gali apeiti tradicines Linux užkardas, pavyzdžiui, UFW.

— Coolify dokumentacija (užkarda), https://coolify.io/docs/knowledge-base/server/firewall

Sprendimas: naudokite užkardą paslaugų teikėjo valdymo skydelyje, ne UFW. Timeweb / Selectel / Aeza turi „Firewall“ arba „Network → Firewall“ skiltį, kur taisyklės konfigūruojamos virtualiojo tinklo lygmeniu — jos suveikia paketams dar nepasiekus Docker.

Alternatyva — ufw-docker, scenarijus, pritaikantis UFW darbui su Docker. Vis dėlto paprasčiau tai padaryti valdymo skydelyje.

3 klaida: Cloudflare tarpinis serveris (oranžinis debesis) sutrikdo Let's Encrypt veikimą.

Požymis: po Redeploy žurnaluose rodoma Let's Encrypt validation failed - challenge returned 403.

Priežastis: Cloudflare tarpininkauja Let's Encrypt HTTP užklausai ir vietoj jūsų iššūkio failo pateikia savo puslapį.

Sprendimas — pasirinkite vieną iš dviejų variantų:

  1. Pasirinkite „DNS only“ (pilką debesį Cloudflare). Trūkumas: prarasite Cloudflare CDN ir apsaugą.
  2. Sukonfigūruokite DNS-01 iššūkį per Cloudflare API. Coolify eikite į Settings → SSL Configuration, pasirinkite Cloudflare teikėją ir įveskite API žetoną su Zone:Read ir DNS:Edit leidimais. Let's Encrypt domeną patvirtins per TXT įrašą, o ne HTTP.

Antrąjį variantą sudėtingiau konfigūruoti, tačiau jis leidžia palikti Cloudflare tarpinį serverį.

4 klaida: PAT vietoj GitHub App — neveikia PR peržiūros.

Požymis: prijungėte „GitHub“ per Personal Access Token; viskas veikia, tačiau PR peržiūros diegimai nekuriami. Atidarėte PR „GitHub“, bet Coolify nieko nepasirodė.

Priežastis: PR peržiūros yra išskirtinė GitHub App funkcija. PAT per saityno kabliuką negauna pull_request įvykių.

Sprendimas: prijunkite „GitHub“ iš naujo naudodami App. Sources → Add → GitHub App → užbaikite vedlį. Seną PAT šaltinį galite ištrinti.

5 klaida: „Coolify == Vercel“ nėra visiškai tiesa.

Ko Coolify nedaro iškart:

VercelCoolifyKą daryti
Pasaulinis CDNNėraNaudokite Cloudflare (statiniam turiniui nemokamas)
Laipsniškas statinis generavimasNėrarevalidatePath veikia tik jūsų serveryje
Vaizdų optimizavimasNėraNaudokite next/image su vietiniu įkėlikliu arba Cloudflare Images
Automatinis mastelio keitimas apkrovos šuolių metuNėraKeiskite mastelį rankiniu būdu; atnaujinkite VPS
Edge FunctionsNėraNaudokite įprastus API maršrutus

Jei jūsų projektas yra didelio srauto SaaS, skirtas pasaulinei auditorijai, ir jam reikia mažesnės nei < 100 ms delsos visame pasaulyje, Coolify netinka — rinkitės Vercel Enterprise. Jei kuriate MVP ir bandote jį su 100–1,000 naudotojų per dieną, Coolify suteikia viską, ko reikia.

Iš sąžiningos savarankiškai priglobto sprendimo analizės:

Šio vadovo pavadinime minimos 15 minučių reiškia sklandų pirmąjį vieno projekto diegimą. Visai infrastruktūrai su stebėsena, atsarginėmis kopijomis ir įspėjimais sukonfigūruoti prireiks vieno ar dviejų vakarų. Būkite sąžiningi sau.

Kiek per metus sutaupysite, palyginti su Vercel?

Svarbiausia šio skyriaus mintis

Taip pat yra „paslėptas laiko mokestis“: 5–10 valandų pradinei sąrankai ir 1–2 valandos per mėnesį priežiūrai.

Toliau pateikti Vercel skaičiai yra straipsnio 2026 m. gegužės scenarijų įverčiai, o ne dabartinės kainos. Tai tik viena palyginimo pusė. Savarankiškai talpinama Coolify neturi licencijos mokesčio, tačiau VPS, atsarginės kopijos, saugykla, srautas ir administravimas vis tiek kainuoja. Gaukite pirmiau nurodytus reikalavimus atitinkantį pasiūlymą; scenarijuose nepateikta skaitinė VPS kaina, todėl fiksuoto sutaupymo teiginys būtų nepagrįstas.

C tegu reiškia bendrą mėnesinę pasirinkto VPS, atsarginių kopijų saugyklos, papildomo srauto, stebėsenos ir pasirinktinio mokamo valdymo skydelio sąskaitą. Kiekvieną išlaidą įtraukite vieną kartą. r tegu reiškia jūsų valandinę administravimo kainą, visur naudojant tą pačią valiutą. Straipsnio laiko įvertis yra 5–10 valandų pradžioje ir 1–2 valandos per mėnesį: 17–34 valandos pirmaisiais metais, 12–24 valandos vėlesniais metais.

ScenarijusVercel įvertis per mėnesįVercel per metusCoolify infrastruktūra per mėnesįCoolify pirmųjų metų TCO su darbuPirmųjų metų sutaupymas prieš Vercel
Vienas prototipas, 100,000 apsilankymų per mėnesį$20 bazė + ~$5 srautas = $25$300C12C + (17–34)r$300 − 12C − (17–34)r
Penki projektai viename VPS$20 bazė + $30 srautas ir funkcijos = $50$600C12C + (17–34)r$600 − 12C − (17–34)r
Trys kūrėjai, penki projektai$60 vietos + $30 srautas = $90$1,080C12C + (17–34)r$1,080 − 12C − (17–34)r

Jei apkrovoms reikia skirtingų serverių dydžių, kiekvienam scenarijui naudokite atskirą C. Mėnesiniam palyginimui pradinės sąrankos laiką paskirstykite per 12 mėnesių: pirmųjų metų mėnesinis ekvivalentas yra C + (17–34)r/12. Vėlesnių metų TCO — 12C + (12–24)r. Formulės palygina nurodytą Vercel įvertį su savarankiškos prieglobos išlaidomis; atitinkamas administravimo išlaidas įtraukite ir Vercel pusėje. Neigiamas sutaupymas reiškia, kad su jūsų įvestimis savarankiška priegloba kainuoja daugiau. Neįtraukite to paties inžinieriaus viso atlyginimo dar kartą, jei r jį jau apima.

Prieš persijungdami įrašykite C pagal tikrą teikėjo pasiūlymą ir atsarginių kopijų planą, pasirinkite r, tada mėnesį palyginkite tikrą naudojimą. Be šių įvesčių straipsnis pateikia kainos modelį, o ne sutaupymo doleriais teiginį.

Pagrindinė nauda — ne pinigai. Perėjus prie Coolify nebelieka kategorijos „priklausomas nuo kieno nors kito mokėjimo politikos“. Nebereikia virtualių tarpininkų kortelių su 20 % komisiniu mokesčiu.

Coolify nėra pigesnis Vercel. Tai kitos kategorijos produktas: infrastruktūra priklauso jums, prisiimate atsakomybę už ją ir sutaupote pinigų sutikdami su jos sudėtingumu.

Jei prototipo diegimas yra pirmoji užduotis, kurią atliekate sugeneravę jį Claude Code, aplinkos valdymas (env, paslaptys, suplanuotos užduotys, atsarginės kopijos) yra konteksto inžinerijos dalis. Be struktūros, apibrėžiančios, „kur kas yra“, Claude pasimeta, o jūs gaištate laiką su kiekvienu pakeitimu. Visą sąranką sudaro: AI klonas (Skills ir Subagents, pritaikyti jūsų metodikai) + Antrieji smegenys (projekto žinių bazė) + Konteksto inžinerija (Plan Mode, /compact, vykdymo aplinka). Tai 3 ramsčiai, be kurių AI haliucinuoja.

Visas konteksto darbo procesas: AI klonas + Antrieji smegenys + Konteksto inžinerija.

Daugiau medžiagos rasite Ailoot.

Išsamiau

Klausimai ir atsakymai

Kuris URL po diegimo turi grąžinti JSON?

Nukopijuokite Coolify lauke Domains rodomą programos URL ir atverkite jo /api/users kelią. Šakninis URL yra pagrindinis puslapis; /api/users yra pavyzdiniame projekte nurodytas JSON galinis taškas.

Kaip apskaičiuoti, ar savarankiška priegloba taupo pinigus?

Mėnesines VPS, atsarginių kopijų, saugyklos, srauto, stebėsenos ir pasirinktinio skydelio išlaidas sudėkite į C. Pirmųjų metų bendroji savarankiškos prieglobos kaina yra 12C ir 17–34 valandos pagal jūsų valandinį tarifą; palyginkite su metiniu scenarijaus Vercel įverčiu ir abiejose pusėse įtraukite palyginamas administravimo sąnaudas.

Visi straipsniai