Coolify dan Claude Code: Sebarkan Projek ke VPS Anda Sendiri
MarkdownMemasang Coolify, menyambungkan GitHub, menggunakan Next.js, domain dan HTTPS, MCP, keperluan VPS serta penyelesaian masalah. Harga teknikal dalam denominasi dolar dan batasan asal.
Baca artikel penuh
Dokumentasi Ailoot — bahan rujukan untuk menggunakan perkhidmatan ini.
Batasan Platform dan Syarat Pembayaran pada 2026
Rumusan utama
Pelan percuma berfungsi sehingga anda mula-mula melepasi had; selepas itu, kad antarabangsa diperlukan. Heroku menutup peringkat percumanya kepada semua orang pada 2022 dan memasuki mod penyelenggaraan pada Februari 2026. Dengan Coolify yang dihoskan sendiri, pelayan itu milik anda; tiada bil setiap tempat duduk dan tiada pergantungan kepada vendor.
Situasi lazim pembina vibe pada 2026: anda membina MVP dalam Cursor atau Claude Code pada waktu malam, memindahkannya ke repositori GitHub, membuka vercel.com → menyambungkan repositori → sampai ke skrin langganan → memasukkan kad anda → mendapat Transaction declined.
Ini bukan pepijat atau gangguan sementara.
Railway, Render, Heroku — ceritanya sama. Heroku sebenarnya menutup peringkat percumanya kepada semua orang pada 2022, dan pada Februari 2026 projek itu memasuki mod penyelenggaraan — tiada ciri baharu dan tiada kontrak Enterprise baharu. Bagi pengguna dengan kad yang tidak disokong, maksudnya: “pintu tertutup; gunakan orang tengah yang mengenakan komisen 20%.”
Anda boleh membayar melalui kad Visa maya di Kazakhstan atau perkhidmatan pembayaran korporat. Tetapi itu bermakna tambahan 20% pada harga, tambahan 30 minit bagi setiap transaksi dan risiko akaun anda disekat apabila pemproses pembayaran melihat ketidakpadanan negara.
Contoh asal merangkumi tiga percubaan — pada Vercel Pro, Railway dan Render.
Apakah Coolify, dan Bagaimanakah Platform Pengehosan Sendiri Berfungsi?
Rumusan utama
Coolify ialah PaaS sumber terbuka yang boleh dihoskan sendiri dan merupakan alternatif langsung kepada Heroku, Vercel dan Netlify. Ia dipasang dengan satu arahan curl pada mana-mana VPS yang menjalankan Ubuntu. Di sebalik tabir, ia menggunakan Docker + Traefik untuk proksi terbalik dan Let's Encrypt untuk HTTPS. Ia menyokong integrasi GitHub, webhook untuk penggunaan automatik, sandaran S3 dan lebih 280 perkhidmatan satu klik (PostgreSQL, Redis, MinIO). Versi pengehosan sendiri percuma selama-lamanya tanpa had. Ia mempunyai 55,800 bintang di GitHub dan lesen Apache-2.0.
Coolify ialah projek sumber terbuka yang dibina dengan Laravel + Docker, yang menukarkan mana-mana VPS kosong menjadi platform penggunaan aplikasi. Pasang Coolify sekali, kemudian lakukan segala-galanya melalui antara muka web: sambungkan GitHub, pilih repositori dan klik Deploy.
Dokumentasi rasmi menerangkannya secara ringkas dan tepat:
Coolify ialah alternatif sumber terbuka dan boleh dihoskan sendiri kepada Heroku / Netlify / Vercel dan sebagainya.
Di sebalik tabir, Coolify terdiri daripada empat bahagian:
- Antara muka web yang dibina dengan Laravel 12 + Livewire 3 + Tailwind v4 — papan pemuka untuk mengurus aplikasi anda.
- Docker + Docker Compose — setiap aplikasi berjalan dalam bekas, terasing daripada yang lain.
- Proksi terbalik (Traefik atau Caddy) — menerima trafik HTTP/HTTPS masuk dan mengarahkannya ke bekas.
- Integrasi Let's Encrypt — mengeluarkan dan memperbaharui sijil SSL secara automatik untuk semua domain.
Ciri utama yang menjadikan fungsi Coolify setanding dengan Vercel:
| Ciri | Vercel | Coolify |
|---|---|---|
| Penggunaan automatik apabila git push | ✅ | ✅ (melalui webhook GitHub) |
| HTTPS percuma | ✅ | ✅ (Let's Encrypt) |
| Penggunaan pratonton PR | ✅ | ✅ (melalui GitHub App) |
| UI pemboleh ubah persekitaran | ✅ | ✅ |
| Sandaran pangkalan data | ❌ (tiada pangkalan data sendiri) | ✅ (ke storan serasi S3) |
| PostgreSQL / Redis / MongoDB | $20+/bulan setiap satu | ✅ Satu klik, percuma |
| Tugasan berjadual (cron) | ❌ | ✅ (sintaks cron) |
| Bil setiap tempat duduk | $20/tempat duduk/bulan | Tiada |
| Pergantungan kepada vendor | Tinggi (Edge Functions, ISR) | Sifar (Docker anda) |
| CDN global | ✅ | ❌ (VPS anda sahaja) |
CDN global ialah satu-satunya perkara yang tidak disertakan Coolify secara terus. Itulah jawapan yang jujur. Jika projek anda mempunyai khalayak global dan anda perlu mengurangkan kependaman bagi pengguna di AS dan Eropah, letakkan Cloudflare di hadapan; ia percuma untuk kandungan statik.
Harga: versi pengehosan sendiri percuma selama-lamanya tanpa had bilangan aplikasi, pelayan atau penggunaan. Coolify Cloud tersedia pada harga $5/bulan untuk 2 pelayan + $3 bagi setiap pelayan tambahan — tetapi pelayan itu tetap milik anda; Coolify Cloud hanya mengehoskan papan pemuka.
Keluaran terkini ialah v4.1.0 bertarikh 18 Mei 2026. Ciri baharu termasuk pek binaan Railpack dalam beta, pengelogan audit, perbezaan konfigurasi antara penggunaan dan titik akhir MCP natif (baca sahaja). Sumber: keluaran GitHub.
VPS Mana yang Patut Anda Dapatkan untuk Coolify pada 2026?
Rumusan utama
Coolify memerlukan sekurang-kurangnya 2 vCPU, 2 GB RAM, 30 GB SSD dan Ubuntu LTS (20.04, 22.04 atau 24.04). VPS seperti ini boleh menjalankan 3–5 projek vibe-coded serentak dengan selesa.
Keperluan minimum Coolify diambil terus daripada dokumentasi rasmi:
| Parameter | Minimum | Disyorkan |
|---|---|---|
| CPU | 2 teras | 2–4 teras |
| RAM | 2 GB | 4 GB (dengan ruang lebihan untuk binaan) |
| Storan | 30 GB | 50–80 GB (untuk imej + pangkalan data) |
| Seni bina | AMD64 atau ARM64 (64-bit) | AMD64 |
| OS | Ubuntu LTS 20.04 / 22.04 / 24.04 | 22.04 LTS |
| Root | Diperlukan | Melalui kunci SSH, bukan kata laluan |
Minimum — 2 GB RAM — ialah had minimum yang keras. Dengan 1 GB, pemasang sampai ke Docker, mengalami OOM (kehabisan memori) lalu tergantung. Jangan berjimat pada RAM.
Sumber harga: Timeweb Cloud, FirstVDS dan Selectel.
Jika anda memerlukan lebih kuasa (pangkalan data 100 GB, beberapa tika Postgres), dapatkan Aeza Dedicated.
Jangan dapatkan:
- VPS dikongsi dengan RAM 512 MB–1 GB — tidak mencukupi untuk Coolify pun. Ini untuk laman statik pada nginx, bukan untuk PaaS.
Mahu bukan sahaja menyediakan penggunaan, tetapi juga membina persediaan yang menjadikan Claude boleh dipercayai? Coolify ialah alat pelaksanaan, tetapi tanpa konteks berstruktur (CLAUDE.md, otak kedua dan kejuruteraan konteks), Claude masih akan berhalusinasi dalam tugasan panjang. Persediaan lengkap merangkumi ketiga-tiganya: Klon AI + Otak Kedua + Kejuruteraan Konteks — gabungan inilah yang menukarkan Claude daripada “pembantu yang berhalusinasi” menjadi alat yang boleh dipercayai.
Cara Memasang Coolify dalam 5 Minit
Rumusan utama
Pemasangan menggunakan satu arahan curl daripada dokumentasi. Apabila ia bermula, antara muka web akan muncul pada port 8000. Di situ anda mencipta pengguna admin pertama dan melihat papan pemuka kosong. Masa sebenar daripada pemasangan Ubuntu kosong hingga Coolify berjalan ialah 5–7 minit, dan 3–4 minit daripadanya digunakan untuk apt-get install docker. Skrip mendapatkan kebergantungan yang diperlukan dan mengkonfigurasi Docker sendiri; anda hanya perlu menunggu sehingga selesai.
Langkah 1. Sambung ke VPS melalui SSH.
Selepas anda mencipta VPS dengan penyedia, alamat IP pelayan dan kata laluan root akan muncul dalam e-mel atau panel kawalan. Sambung dari mesin setempat anda:
ssh root@1.2.3.4
Jika penyedia memberikan kunci SSH dan bukannya kata laluan, sambung dengan -i path/to/key. Mulai sekarang, saya mengandaikan anda menggunakan pemasangan Ubuntu 22.04 atau 24.04 LTS yang baharu.
Langkah 2. Jalankan arahan pemasangan Coolify.
Satu arahan daripada dokumentasi rasmi:
curl -fsSL https://cdn.coollabs.io/coolify/install.sh | sudo bash
Skrip itu melakukan tiga perkara:
- Memeriksa sistem (Ubuntu LTS? root? AMD64?)
- Memasang Docker dan Docker Compose jika belum dipasang
- Memuat turun imej Coolify (
coolify/coolify,coolify/realtime,traefik) dan menjalankannya di latar belakang melalui docker-compose
Proses ini mengambil masa 3–5 minit. Anda akan melihat log apt-get bergerak, diikuti docker pull. Apabila anda melihat Coolify v4.1.0 is now running, pergi ke langkah 3.
Langkah 3. Buka antara muka web.
Buka alamat ini dalam pelayar anda:
http://1.2.3.4:8000
Coolify akan memaparkan wizard persediaan — borang untuk mencipta pengguna pertama. Masukkan e-mel dan kata laluan, kemudian simpannya. Pengguna ini secara automatik menjadi admin; anda belum memerlukan pengguna lain.
Selepas menyimpan, anda akan dibawa ke papan pemuka kosong: bar sisi di sebelah kiri dengan Resources / Projects / Servers / Sources / Notifications / Settings, serta arahan di tengah yang berbunyi “Add your first resource.”
Langkah 4. Buka port dalam firewall penyedia (bukan UFW).
Coolify sudah berjalan, tetapi hanya port 8000 (papan pemuka) yang boleh diakses dari luar. Untuk membolehkan pengguna mencapai aplikasi anda, anda perlu membuka port 80 (HTTP) dan 443 (HTTPS):
| Port | Tujuan |
|---|---|
| 22 | Akses SSH ke pelayan |
| 80 | Menerima trafik HTTP, diperlukan untuk pengesahan Let's Encrypt |
| 443 | Menerima trafik HTTPS pengguna |
| 8000 | Papan pemuka Coolify (kita akan menutupnya selepas mengkonfigurasi domain tersuai untuk papan pemuka) |
Perkara penting yang mudah terlepas pandang dalam dokumentasi rasmi:
Docker menggunakan peraturan iptables berasaskan NAT yang boleh memintas firewall Linux tradisional seperti UFW.
Ini bermakna walaupun anda mengaktifkan UFW dan menutup semua port, Docker masih akan mendedahkan bekasnya melalui iptables. UFW tidak berguna di sini. Penyelesaiannya ialah membuka dan menutup port dalam panel kawalan penyedia, bukan melalui UFW. Dengan Timeweb / Selectel / Aeza, anda melakukannya dalam bahagian “Network → Firewall” pada konsol web.
Langkah 5 (pilihan). Pautkan papan pemuka kepada domain anda.
Untuk melawati https://coolify.example.com dan bukannya http://1.2.3.4:8000, cipta rekod DNS A coolify.example.com → 1.2.3.4, pergi ke Settings → Instance Settings → Instance Domain dalam Coolify, masukkan subdomain anda dan simpan. Coolify akan meminta sijil Let's Encrypt dan, seminit kemudian, memuat semula papan pemuka melalui HTTPS.
Selepas itu, anda boleh menutup port 8000 dalam firewall — papan pemuka akan tersedia melalui HTTPS pada port standard 443.
Cara Menyambungkan GitHub: App atau PAT?
Rumusan utama
Coolify menyokong dua cara untuk menyambung ke GitHub: GitHub App (disyorkan) dan Personal Access Token (PAT). Gunakan GitHub App: persediaan mengambil masa 5 minit dengan wizard, pratonton PR berfungsi dan kebenaran boleh ditetapkan secara terperinci pada peringkat repositori. PAT ialah pilihan lapuk untuk kes lama; ia tiada penggunaan pratonton dan membawa risiko akses global kepada semua repositori anda. Dokumentasi rasmi menyatakannya secara langsung, “bagi 95% pengguna, GitHub App ialah pilihan yang tepat.”
Dalam Coolify, pergi ke Sources → + Add → GitHub App. Coolify akan memaparkan wizard tiga skrin:
- Nama & penerangan — namakan sumber itu (masukkan
github-main) dan tambah penerangan jika mahu. - Configure on GitHub — butang yang membawa anda ke GitHub.com dan membuka borang penciptaan GitHub App secara automatik dengan kebenaran yang betul.
- Confirm — selepas kembali dari GitHub, klik “Save.”
Pada langkah kedua, GitHub akan meminta anda mengesahkan kebenaran yang diminta Coolify:
| Kebenaran | Tahap | Tujuan |
|---|---|---|
| Contents | Baca sahaja | Mengklon repositori |
| Pull Requests | Baca-tulis | Mencipta penggunaan pratonton dan mengulas PR |
| Email addresses | Baca sahaja | Mengenal pasti commit |
| Metadata | Baca sahaja | Menyenaraikan repositori |
Ini ialah kebenaran minimum — GitHub App tidak dapat melihat kunci peribadi anda, tidak boleh menulis ke main dan tidak boleh mengakses repositori yang belum anda sambungkan secara jelas.
Daripada dokumentasi rasmi:
Personal Access Token (PAT) ialah kaedah lama; saya syorkan supaya anda tidak menggunakannya. Kekurangannya:
- PAT memberikan akses global kepada semua repositori anda (termasuk repositori peribadi)
- Pratonton PR tidak berfungsi — ciri itu hanya tersedia melalui GitHub App
- Token itu bertahan lama (90 hari, setahun atau selama-lamanya) — jika ia bocor, akibatnya buruk
Gunakan PAT hanya jika anda bekerja dengan repositori organisasi yang dasar keselamatannya melarang GitHub Apps dan tiada cara lain.
Selepas menyimpan sumber dalam Coolify, anda akan melihat GitHub App dalam papan pemuka bersama senarai repositori yang disambungkan. Apabila anda mencipta aplikasi baharu, anda boleh memilih mana-mana daripadanya dengan satu klik.
Cara Menggunakan Coolify untuk Menggunakan Projek Next.js daripada Claude Code dalam 6 Langkah
Rumusan utama
Laluan lengkap daripada persediaan Claude Code yang kosong hingga laman langsung: 1) jalankan claude dalam folder kosong, terangkan projek dan Claude menjana kod; 2) jalankan git init && git remote add (Claude boleh melakukannya sendiri melalui arahan slash); 3) push ke GitHub; 4) dalam Coolify, pilih “+ New Resource → Application” dan pilih repositori; 5) tambah pemboleh ubah persekitaran; 6) Deploy. Coolify akan mengesan bahawa projek itu Next.js, memilih pek binaan Nixpacks, membina imej Docker dalam 3–5 minit dan menyediakan domain sementara dengan HTTPS tersedia secara langsung.
Langkah 1. Terangkan projek kepada Claude Code dalam folder kosong.
mkdir my-vibe-app
cd my-vibe-app
git init
claude
Dalam sesi itu:
Bina projek Next.js 14 app router:
- halaman utama dengan senarai pengguna
- titik akhir /api/users mengembalikan tatasusunan daripada pangkalan data
- Postgres melalui Prisma
- Tailwind untuk gaya
- .env.example dengan DATABASE_URL
- README.md dengan arahan untuk menjalankan projek
Claude akan menjana struktur fail, package.json, prisma/schema.prisma dan .env.example. Minta juga:
Cipta Dockerfile untuk binaan pengeluaran dan .dockerignore.
Ini pilihan sahaja — Coolify akan membina dengan Nixpacks walaupun tanpa Dockerfile. Tetapi Dockerfile memberi anda kawalan terhadap proses dan lebih pantas untuk projek yang lebih besar.
Langkah 2. Cipta repositori GitHub dan push kepadanya.
Anda boleh melakukannya secara manual melalui UI GitHub + git remote add origin ..., tetapi Claude Code boleh melakukannya sendiri:
/commit-push-pr Initial Next.js app generated with Claude Code
Atau cukup katakan: “Commit everything and push it to a new repository my-vibe-app under my account.” Claude akan menggunakan CLI gh untuk mencipta repositori peribadi (atau awam) dan membuat push pertama. Sumber: arahan rasmi Claude Code.
Langkah 3. Cipta Application dalam Coolify.
Dalam papan pemuka Coolify, klik + New → Application. Borang akan terbuka:
- Source — pilih
github-main(GitHub App yang anda sambungkan dalam H2 sebelumnya) - Repository — pilih
my-vibe-appdaripada senarai - Branch —
main - Build Pack — Coolify akan mengesannya secara automatik. Jika terdapat Dockerfile, Coolify akan menggunakan
dockerfile. Jika tiada, Coolify akan menggunakannixpacks. Anda boleh menukarnya secara manual. - Domain — biarkan nilai yang dicadangkan buat masa ini; ia sementara dan anda akan menggantikannya dengan domain sendiri kemudian
- Port —
3000untuk Next.js secara lalai
Simpan.
Langkah 4. Tambah pemboleh ubah persekitaran.
Dalam aplikasi yang dicipta, buka tab Environment Variables. Tambah pemboleh ubah satu demi satu:
DATABASE_URL=postgresql://user:pass@db-host:5432/mydb
NODE_ENV=production
ANTHROPIC_API_KEY=sk-ant-...
Jika anda tiada pangkalan data, cipta satu terus dalam Coolify: + New → Database → PostgreSQL. Coolify akan melancarkan bekas Postgres dalam 30 saat dan memberikan DATABASE_URL dalaman dalam format postgresql://postgres:pass@postgres-xyz:5432/postgres — masukkannya dalam aplikasi anda.
Semua pemboleh ubah disulitkan dalam pangkalan data Coolify dan tidak dipaparkan dalam log binaan.
Langkah 5. Klik Deploy.
Di penjuru kanan atas terdapat butang Deploy berwarna biru. Log langsung akan muncul dalam tab Logs:
[stage: clone] Cloning '<repository-url-from-github>'
[stage: build] Detected Next.js, using Nixpacks
[stage: build] Installing Node 20, npm 10
[stage: build] npm install (245s)
[stage: build] npm run build (87s)
[stage: deploy] Creating container my-vibe-app-xyz
[stage: deploy] Container started, health check passed
[stage: proxy] Traefik routing configured
[stage: ssl] Let's Encrypt cert issued
Binaan pertama mengambil masa 3–5 minit (imej asas Node dimuat turun dan kebergantungan dipasang). Binaan seterusnya mengambil masa 60–90 saat hasil caching lapisan Docker.
Apabila status berubah kepada Running, salin URL aplikasi dalam medan Domains Coolify dan buka URL tepat itu dalam pelayar. Gunakan nilai tersebut sebagai <app-url-from-coolify> di bawah; label dalam kurungan sudut ialah pemegang tempat, bukan alamat sebenar. Halaman utama anda sepatutnya muncul dengan HTTPS tersedia secara langsung. Perkhidmatan DNS wildcard percuma menyelesaikan mana-mana subdomain yang mengandungi alamat IP (1-2-3-4 → 1.2.3.4). Coolify menggunakannya untuk domain sementara supaya anda boleh membuka laman serta-merta tanpa mengkonfigurasi DNS sendiri.
Langkah 6. Semak bahawa semuanya berfungsi.
Buka URL aplikasi daripada langkah sebelumnya dengan /api/users ditambah, contohnya <app-url-from-coolify>/api/users tanpa menggandakan garis miring. Ini endpoint JSON yang dicipta dalam Langkah 1; URL akar aplikasi ialah halaman utama. Jika berlaku ralat 500, anda akan melihat jejak tindanan dalam tab Logs. Masalah paling lazim pada penggunaan pertama ialah DATABASE_URL menunjuk kepada pangkalan data yang tidak wujud. Betulkannya dengan mencipta tika PostgreSQL dalam Coolify (lihat langkah 4 di atas) dan menggantikan DATABASE_URL.
15 minit, bermula dari saat anda memesan VPS. Dalam contoh asal, aliran kerja ini mengambil masa 12–18 minit pada pelayan baharu.
Cara Mengkonfigurasi Domain Tersuai dan HTTPS
Rumusan utama
Domain tersuai disambungkan dalam 3 langkah: cipta rekod DNS A yang menunjuk kepada IP pelayan, masukkan domain anda dalam Configuration Coolify sebagai ganti perkhidmatan DNS wildcard percuma, aktifkan Automatic HTTPS dan klik Redeploy. Let's Encrypt akan mengeluarkan sijil SSL secara automatik 2–3 minit selepas penyebaran DNS (biasanya 5–30 minit). Keperluan utamanya ialah DNS sudah pun membuat resolusi apabila anda mengklik Redeploy; jika tidak, pengesahan Let's Encrypt akan gagal dan anda perlu menunggu 12 minit sebelum percubaan seterusnya.
Langkah 1. Cipta rekod DNS A dalam panel kawalan pendaftar domain anda.
Contoh asal menggunakan domain yang dihoskan di Reg.ru, Beget atau Timeweb. Prosesnya sama:
| Jenis rekod | Nama | Nilai |
|---|---|---|
| A | app (atau @ untuk domain akar) | 1.2.3.4 (IP pelayan) |
Simpannya, buka konsol dan semak:
dig app.example.com +short
# Sepatutnya mengembalikan 1.2.3.4
Jika tiada hasil atau IP yang berbeza dipulangkan, DNS belum tersebar. Tunggu 5–30 minit.
Langkah 2. Masukkan domain anda dalam Coolify.
Dalam aplikasi, buka tab Configuration → General. Dalam medan Domains, gantikan URL aplikasi sementara yang disalin daripada Coolify dengan https://app.example.com (menggunakan domain dikonfigurasikan anda sendiri). Aktifkan Automatic HTTPS (biasanya diaktifkan secara lalai).
Simpan dan klik Redeploy.
Langkah 3. Tunggu sijil Let's Encrypt.
Log binaan akan memaparkan:
[stage: ssl] Requesting Let's Encrypt cert for app.example.com
[stage: ssl] HTTP challenge sent to /.well-known/acme-challenge/xxx
[stage: ssl] Validation passed, cert issued
[stage: ssl] Cert installed, HTTPS enabled
Dalam 2–3 minit, laman anda akan tersedia di https://app.example.com dengan ikon mangga hijau pada bar alamat.
Perkara yang boleh menyebabkan masalah dengan Let's Encrypt (3 isu teratas daripada panduan penyelesaian masalah rasmi):
- Port 80 tertutup dalam firewall. Let's Encrypt mengesahkan menggunakan cabaran HTTP — ia menghantar permintaan ke
http://app.example.com/.well-known/acme-challenge/xxx. Pengesahan tidak akan berjaya tanpa port 80. Bukanya dalam firewall penyedia. - Proksi Cloudflare diaktifkan (awan jingga). Ia memintas permintaan Let's Encrypt dan mengembalikan halaman pemegang tempatnya sendiri — pengesahan gagal. Penyelesaiannya ialah menukar kepada “DNS only” (awan kelabu) atau mengkonfigurasi cabaran DNS-01 melalui API Cloudflare.
- DNS belum tersebar. Jika anda mencipta rekod A 30 saat lalu dan terus mengklik Redeploy, Let's Encrypt tidak akan melihat domain anda. Tunggu 5–30 minit untuk DNS tersebar merentasi pelayan.
Had kadar Let's Encrypt: 5 percubaan gagal sejam bagi satu domain, dengan pemulihan pada kadar 1 setiap 12 minit. Jika anda mencapai had itu, jangan klik Redeploy 10 kali berturut-turut; semak log, betulkan masalah dan cuba lagi dalam 12 minit.
Bagaimanakah Claude Code Mengurus Coolify Melalui MCP?
Rumusan utama
Melalui Model Context Protocol, Claude Code mendapat akses terus kepada API Coolify — anda boleh menyebut “gunakan aplikasi ini” untuk memulakan binaan, menyemak status, membaca log atau mengemas kini pemboleh ubah persekitaran. Terdapat tiga pilihan: forsonny/Coolify-MCP-Server (asas, 7 kategori operasi), dazeb/coolify-mcp-enhanced (15+ alat tambahan dengan penggunaan pangkalan data satu klik) dan ajmcclary/Coolify-Manager (Claude Skill yang dibina berdasarkan CLI rasmi). Bermula dengan v4.1.0 (18 Mei 2026), Coolify menyediakan titik akhir MCP natif tanpa pelayan pihak ketiga — tetapi buat masa ini ia baca sahaja.
Model Context Protocol (MCP) ialah piawaian daripada Anthropic yang membolehkan Claude Code berkomunikasi dengan sistem luaran (lihat panduan pelayan MCP untuk maklumat lanjut). Sambungkan pelayan MCP dan Claude akan mendapat set alat yang boleh dipanggilnya. Terdapat tiga pelayan sedia guna untuk Coolify, serta satu pilihan natif.
Pilihan 1. forsonny/Coolify-MCP-Server-for-Claude-Code — asas.
Fungsinya:
- Aplikasi: cipta, mulakan, hentikan, mulakan semula
- Perkhidmatan: senaraikan, cipta, mulakan/hentikan/mulakan semula
- Penggunaan: lihat yang sedang berjalan, dapatkan mengikut UUID
- Pasukan & Ahli: senaraikan, dapatkan maklumat
- Kunci SSH: senaraikan, cipta
- Pemboleh ubah persekitaran: CRUD penuh untuk aplikasi dan perkhidmatan
- Wawasan Pelayan: domain bagi setiap pelayan, kesihatan, versi
Pemasangan:
git clone '<OFFICIAL_URL>'
cd Coolify-MCP-Server-for-Claude-Code
npm install
npm run build
# In .env:
# COOLIFY_BASE_URL=https://coolify.example.com
# COOLIFY_API_TOKEN=[from Coolify Settings → API Tokens]
npm run setup # automatically configures Claude Code
Selepas itu, anda boleh menaip ini dalam Claude Code:
Tunjukkan status aplikasi my-vibe-app dalam Coolify dan 3 penggunaan terkini.
Claude akan mengembalikan jadual.
Pilihan 2. dazeb/coolify-mcp-enhanced — dipertingkatkan (disyorkan).
Penambahan kepada set asas:
- Penggunaan PostgreSQL / Redis / MinIO satu klik melalui AI — minta “sediakan Postgres untuk saya,” dan ia akan mencipta bekas serta mengembalikan DATABASE_URL
- Pemantauan masa nyata + penggunaan sumber — CPU/RAM bagi setiap aplikasi dalam masa nyata
- Kemas kini konfigurasi env secara pukal — kemas kini 20 pemboleh ubah dengan satu arahan
- Sokongan Docker Compose — gunakan aplikasi berbilang perkhidmatan
Konfigurasi untuk Claude Code (.mcp.json di akar projek):
{
"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"
}
}
}
}
Pilihan 3. ajmcclary/Coolify-Manager — Claude Skill yang dibina berdasarkan CLI.
Ia bukan pelayan MCP, sebaliknya Claude Code Skill yang membalut CLI Coolify rasmi. Ia merangkumi:
- Diagnostik kesihatan untuk perkhidmatan dan bekas
- Diagnostik sijil SSL
- Sokongan berbilang tika (jika anda mempunyai beberapa pelayan Coolify)
- Resipi penyelesaian masalah
Pemasangan: muat turun skill dan letakkannya dalam ~/.claude/skills/coolify-manager/. Claude Code akan mengesannya dan menawarkannya untuk tugasan yang berkaitan.
Pilihan 4 (baharu pada Mei 2026). MCP natif dalam Coolify v4.1.0.
Log perubahan v4.1.0 bertarikh 18 Mei 2026 menyatakan:
Menambah sokongan MCP pada peringkat tika dengan alat baca sahaja untuk sumber Coolify dan API/UI.
Coolify kini menyediakan titik akhir MCP sendiri — anda boleh menyambungkan Claude Code secara langsung tanpa pelayan pihak ketiga. Buat masa ini ia baca sahaja (senarai aplikasi, status, konfigurasi), tanpa operasi pengubahsuaian. Namun, itu memadai untuk kebanyakan tugasan seperti “ceritakan tentang infrastruktur.”
Sambungkannya melalui .mcp.json:
{
"mcpServers": {
"coolify-native": {
"url": "https://coolify.example.com/api/v1/mcp",
"headers": {
"Authorization": "Bearer <your-api-token>"
}
}
}
}
Tunggu sehingga MCP natif mendapat akses tulis penuh dalam v4.2 atau v4.3 — pasukan Coolify menjanjikannya menjelang penghujung 2026.
5 Perkara yang Mudah Terlepas Pandang Semasa Penggunaan Pertama — dan Cara Mengelakkannya
Rumusan utama
Ralat paling lazim semasa penggunaan pertama ialah RAM tidak mencukupi, port 80 tertutup, proksi Cloudflare mengganggu Let's Encrypt, UFW gagal melindungi Docker dan pemilihan PAT berbanding GitHub App. Semuanya diterangkan dalam dokumentasi rasmi, tetapi mudah dihadapi tanpa pengalaman langsung. Berikut ialah senarai semak 5 perkara berdasarkan pengalaman asal memasang Coolify buat kali pertama.
Perkara 1: RAM kurang daripada 2 GB — pemasangan gagal dengan OOM.
Gejala: curl install.sh sampai ke docker pull coolify/coolify, tergantung pada 70%, kemudian proses dimatikan dengan Killed (signal 9). Log dmesg | tail menunjukkan Out of memory: Killed process.
Penyelesaian:
# Create a 4 GB swap file to solve the problem temporarily
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
Untuk jangka panjang, naik taraf kepada RAM 4 GB. Coolify berfungsi dengan swap, tetapi binaan projek Next.js yang besar mungkin gagal.
Perkara 2: UFW diaktifkan, tetapi Docker masih membuka port.
Gejala: anda mengaktifkan UFW dan menutup semua port kecuali 22, tetapi aplikasi anda masih boleh diakses dari internet pada port rawak tertentu (seperti 3000).
Puncanya, menurut dokumentasi rasmi:
Coolify berjalan pada Docker, yang menggunakan peraturan iptables berasaskan NAT dan boleh memintas firewall Linux tradisional seperti UFW.
Penyelesaian: gunakan firewall dalam panel kawalan penyedia, bukan UFW. Timeweb / Selectel / Aeza mempunyai bahagian “Firewall” atau “Network → Firewall” untuk mengkonfigurasi peraturan pada peringkat rangkaian maya — peraturan itu berfungsi sebelum paket sampai ke Docker.
Alternatifnya ialah ufw-docker, skrip yang menampal UFW supaya serasi dengan Docker. Namun, itu lebih rumit berbanding mengklik dalam panel kawalan.
Perkara 3: Proksi Cloudflare (awan jingga) mengganggu Let's Encrypt.
Gejala: selepas Redeploy, log menunjukkan Let's Encrypt validation failed - challenge returned 403.
Sebab: Cloudflare memproksi permintaan HTTP Let's Encrypt dan mengembalikan halamannya sendiri dan bukannya fail cabaran anda.
Penyelesaian — pilih salah satu daripada dua pilihan:
- Tukar kepada “DNS only” (awan kelabu dalam Cloudflare). Kekurangan: anda kehilangan CDN dan perlindungan Cloudflare.
- Konfigurasikan cabaran DNS-01 melalui API Cloudflare. Dalam Coolify, pergi ke Settings → SSL Configuration, pilih penyedia Cloudflare dan masukkan token API dengan kebenaran Zone:Read dan DNS:Edit. Let's Encrypt akan mengesahkan melalui rekod TXT dan bukannya HTTP.
Pilihan kedua lebih rumit untuk disediakan, tetapi mengekalkan proksi Cloudflare.
Perkara 4: PAT menggantikan GitHub App — pratonton PR tidak berfungsi.
Gejala: anda menyambungkan GitHub melalui Personal Access Token; semuanya berfungsi, tetapi penggunaan pratonton tidak dicipta untuk PR. Anda membuka PR dalam GitHub, tetapi tiada apa-apa muncul dalam Coolify.
Sebab: pratonton PR ialah ciri eksklusif GitHub App. PAT tidak menerima peristiwa pull_request melalui webhook.
Penyelesaian: sambungkan semula GitHub melalui App. Sources → Add → GitHub App → lengkapkan wizard. Anda boleh memadam sumber PAT lama.
Perkara 5: “Coolify == Vercel” tidak sepenuhnya benar.
Perkara yang tidak dilakukan Coolify secara terus:
| Vercel | Coolify | Perkara yang perlu dilakukan |
|---|---|---|
| CDN global | Tiada | Letakkan Cloudflare di hadapan (percuma untuk kandungan statik) |
| Penjanaan Semula Statik Tambahan | Tiada | revalidatePath hanya berfungsi pada pelayan anda |
| Pengoptimuman imej | Tiada | Gunakan next/image dengan pemuat setempat atau Cloudflare Images |
| Penskalaan automatik semasa waktu puncak | Tiada | Skalakan secara manual; naik taraf VPS anda |
| Edge Functions | Tiada | Gunakan laluan API biasa |
Jika projek anda ialah SaaS trafik tinggi dengan khalayak global dan keperluan kependaman < 100 ms di seluruh dunia, Coolify tidak sesuai; pilih Vercel Enterprise. Jika anda pembina vibe dengan MVP yang sedang diuji kepada 100–1,000 pengguna sehari, Coolify mencukupi untuk segala-galanya.
Daripada analisis pengehosan sendiri yang jujur:
15 minit dalam tajuk panduan ini merujuk kepada laluan paling lancar untuk penggunaan pertama satu projek. Persediaan infrastruktur lengkap dengan pemantauan, sandaran dan amaran mengambil masa satu atau dua malam. Bersikap jujur dengan diri sendiri.
Berapa Banyak yang Anda Akan Jimat dalam Setahun Berbanding Vercel?
Rumusan utama
Terdapat “cukai masa tersembunyi” sebanyak 5–10 jam untuk persediaan awal dan 1–2 jam sebulan untuk penyelenggaraan.
Angka Vercel di bawah ialah anggaran senario Mei 2026 artikel ini, bukan sebut harga semasa. Ia hanya satu sisi perbandingan. Coolify dihoskan sendiri tiada yuran lesen, tetapi VPS, sandaran, storan, trafik dan operasi masih menelan kos. Dapatkan sebut harga yang memenuhi keperluan di atas; harga VPS berangka tidak dibekalkan dalam senario ini, maka dakwaan penjimatan tetap tidak disokong.
Biarkan C ialah jumlah bil infrastruktur bulanan untuk VPS dipilih, storan sandaran, trafik tambahan, pemantauan dan sebarang pilihan papan pemuka berbayar. Kira setiap perbelanjaan sekali. Biarkan r ialah kos sejam kerja operasi anda, dengan mata wang sama sepanjang pengiraan. Anggaran masa artikel ialah 5–10 jam awal ditambah 1–2 jam sebulan: 17–34 jam pada tahun pertama dan 12–24 jam pada tahun kemudian.
| Senario | Anggaran Vercel/bulan | Vercel/tahun | Infrastruktur Coolify/bulan | TCO Coolify tahun pertama, termasuk tenaga kerja | Penjimatan tahun pertama berbanding Vercel |
|---|---|---|---|---|---|
| Satu prototaip, 100,000 kunjungan/bulan | $20 asas + ~$5 lebar jalur = $25 | $300 | C | 12C + (17–34)r | $300 − 12C − (17–34)r |
| Lima projek pada satu VPS | $20 asas + $30 lebar jalur/fungsi = $50 | $600 | C | 12C + (17–34)r | $600 − 12C − (17–34)r |
| Tiga pembangun, lima projek | $60 tempat duduk + $30 lebar jalur = $90 | $1,080 | C | 12C + (17–34)r | $1,080 − 12C − (17–34)r |
Gunakan C berasingan bagi setiap senario jika beban kerja memerlukan saiz pelayan berbeza. Untuk perbandingan bulanan, agihkan masa persediaan awal merentas 12 bulan: nilai bulanan setara tahun pertama ialah C + (17–34)r/12. TCO tahun kemudian ialah 12C + (12–24)r. Formula ini membandingkan anggaran Vercel dinyatakan dengan perbelanjaan pengehosan sendiri; sertakan juga kos operasi setara di pihak Vercel. Penjimatan negatif bermakna pengehosan sendiri lebih mahal berdasarkan input anda. Jangan kira semula gaji penuh jurutera yang sama jika r sudah merangkuminya.
Sebelum bertukar, isikan C daripada sebut harga penyedia sebenar dan pelan sandaran, pilih r, kemudian bandingkan penggunaan sebenar selama sebulan. Tanpa input itu, artikel menyokong model kos, bukan dakwaan penjimatan dolar.
Manfaat utamanya bukan wang. Apabila anda beralih ke Coolify, kategori “bergantung pada dasar pembayaran orang lain” lenyap. Kad maya dengan komisen 20% tidak lagi diperlukan.
Coolify bukan Vercel yang lebih murah. Ia kategori produk yang berbeza: anda memiliki infrastruktur itu, bertanggungjawab terhadapnya dan menjimatkan wang dengan menerima kerumitannya.
Jika penggunaan prototaip ialah tugasan pertama anda selepas penjanaan dalam Claude Code, maka pengurusan persekitaran (env, rahsia, tugasan berjadual, sandaran) merupakan sebahagian daripada kejuruteraan konteks. Tanpa struktur untuk “tempat segala-galanya disimpan,” Claude akan tersesat dan anda akan kehilangan masa pada setiap perubahan. Persediaan lengkap merangkumi: Klon AI (Skills dan Subagents yang disesuaikan dengan metodologi anda) + Otak Kedua (pangkalan pengetahuan projek) + Kejuruteraan Konteks (Plan Mode, /compact, persekitaran pelaksanaan). Inilah 3 tonggak yang tanpanya AI berhalusinasi.
Sumber
- Dokumentasi rasmi Coolify: Pengenalan
- Panduan pemasangan Coolify
- Gambaran keseluruhan pek binaan Coolify
- Pangkalan pengetahuan Firewall Coolify
- Penyelesaian masalah Let's Encrypt Coolify
- Harga Coolify
- GitHub Coolify: keluaran v4.1.0
- Gambaran keseluruhan Claude Code
- Timeweb Cloud VPS
- FirstVDS VPS
- Selectel VPS/VDS
- Harga Vercel
Aliran kerja konteks lengkap: Klon AI + Otak Kedua + Kejuruteraan Konteks.
Bahan lain tersedia di Ailoot.
Butiran lanjut
Soalan lazim: Coolify dan Claude Code: Sebarkan Projek ke VPS Anda Sendiri
URL manakah patut memulangkan JSON selepas penggunaan?
Salin URL aplikasi dalam medan Domains Coolify dan buka laluan /api/users padanya. URL akar ialah halaman utama; /api/users ialah endpoint JSON yang ditentukan dalam projek contoh.
Bagaimanakah saya mengira sama ada pengehosan sendiri menjimatkan wang?
Jumlahkan VPS bulanan, sandaran, storan, trafik, pemantauan dan caj papan pemuka pilihan sebagai C. TCO pengehosan sendiri tahun pertama ialah 12C ditambah 17–34 jam pada kos sejam anda; bandingkan dengan anggaran Vercel tahunan senario dan sertakan kos operasi setara pada kedua-dua pihak.