Coolify және Claude Code: жобаны жеке VPS-іңізге орналастырыңыз
MarkdownCoolify орнату, GitHub қосу, Next.js орналастыру, домен мен HTTPS, MCP, VPS талаптары және ақауларды жою. Доллармен көрсетілген техникалық бағалар мен бастапқы шектеулер сақталған.
Мақаланы толық оқу
Ailoot құжаттамасы — қызметпен жұмыс істеуге арналған анықтамалық материалдар.
2026 жылғы платформа шектеулері мен төлем шарттары
Негізгі түйін
Тегін жоспарлар шектен алғаш асқанға дейін жұмыс істейді; содан кейін халықаралық карта қажет. Heroku 2022 жылы тегін деңгейін баршаға жапты, ал 2026 жылғы ақпанда қолдау режиміне өтті. Өзіңіз хосттайтын Coolify жағдайында сервер өзіңізге тиесілі; әр пайдаланушыға шаққандағы төлем де, жеткізушіге байлану да жоқ.
2026 жылғы vibe-кодтаушының әдеттегі жағдайы: Cursor немесе Claude Code ішінде кешкісін MVP жасайсыз, оны GitHub репозиторийіне көшіресіз, vercel.com сайтына кіріп → репозиторийді қосасыз → жазылым экранына жетесіз → картаңызды енгізесіз → Transaction declined деген хабарлама аласыз.
Бұл қате де, уақытша ақау да емес.
Railway, Render, Heroku — бәрінде жағдай бірдей. Heroku шынымен де 2022 жылы тегін деңгейін баршаға жапты, ал 2026 жылғы ақпанда жоба қолдау режиміне өтті — жаңа мүмкіндіктер де, Enterprise келісімшарттары да болмайды. Қолдау көрсетілмейтін картасы бар пайдаланушы үшін бұл: «есік жабық; 20% комиссия алатын делдал арқылы айналып өтіңіз» дегенді білдіреді.
Қазақстанның виртуалды Visa карталарымен немесе корпоративтік төлем қызметтері арқылы төлеуге болады. Бірақ бұл бағаға +20%, әр транзакцияға +30 минут және төлем процессоры елдің сәйкессіздігін байқаса, аккаунтыңыз бұғатталу қаупін қосады.
Бастапқы мысалда үш әрекет болды — Vercel Pro, Railway және Render арқылы.
Coolify деген не және өзі хостталатын платформа қалай жұмыс істейді?
Негізгі түйін
Coolify — ашық бастапқы коды бар, өзіңіз хосттай алатын PaaS және Heroku, Vercel, Netlify қызметтеріне тікелей балама. Ол Ubuntu орнатылған кез келген VPS-ке бір curl командасымен орнатылады. Ішкі жағында кері прокси үшін Docker + Traefik, ал HTTPS үшін Let's Encrypt қолданылады. GitHub интеграциясын, автоматты орналастыруға арналған вебхуктарды, S3 сақтық көшірмелерін және бір рет басып қосылатын 280+ қызметті (PostgreSQL, Redis, MinIO) қолдайды. Өзіңіз хосттайтын нұсқасы шектеусіз әрі мәңгі тегін. GitHub-та 55,800 жұлдызы және Apache-2.0 лицензиясы бар.
Coolify — Laravel + Docker көмегімен жасалған ашық бастапқы жоба; ол кез келген бос VPS-ті қолданбаларды орналастыру платформасына айналдырады. Coolify-ді бір рет орнатқан соң, қалғанының бәрін веб-интерфейс арқылы істейсіз: GitHub-ты қосып, репозиторийді таңдап, Deploy түймесін басасыз.
Ресми құжаттамада қысқа әрі нақты айтылған:
Coolify — Heroku / Netlify / Vercel және т.б. қызметтеріне ашық бастапқы коды бар әрі өзі хостталатын балама.
Ішкі жағында Coolify төрт бөліктен тұрады:
- Laravel 12 + Livewire 3 + Tailwind v4 негізінде жасалған веб-интерфейс — қолданбаларыңызды басқаруға арналған панель.
- Docker + Docker Compose — әр қолданба басқалардан оқшауланған контейнерде жұмыс істейді.
- Кері прокси (Traefik немесе Caddy) — кіріс HTTP/HTTPS трафигін қабылдап, контейнерлерге бағыттайды.
- Let's Encrypt интеграциясы — барлық доменге SSL сертификаттарын автоматты түрде береді және жаңартады.
Coolify-ді функционалдық жағынан Vercel-ге теңестіретін негізгі мүмкіндіктер:
| Мүмкіндік | Vercel | Coolify |
|---|---|---|
| Git push жасалғанда автоматты орналастыру | ✅ | ✅ (GitHub вебхугы арқылы) |
| Тегін HTTPS | ✅ | ✅ (Let's Encrypt) |
| PR алдын ала қарау орналастырулары | ✅ | ✅ (GitHub App арқылы) |
| Ортаның айнымалыларына арналған интерфейс | ✅ | ✅ |
| Дерекқор сақтық көшірмелері | ❌ (өз дерекқорлары жоқ) | ✅ (S3-үйлесімді қоймаға) |
| PostgreSQL / Redis / MongoDB | Айына $20+ әрқайсысы | ✅ Бір рет басып қосу, тегін |
| Жоспарланған тапсырмалар (cron) | ❌ | ✅ (cron синтаксисі) |
| Әр пайдаланушыға шаққандағы төлем | $20/пайдаланушы/ай | Жоқ |
| Жеткізушіге байлану | Жоғары (Edge Functions, ISR) | Нөл (өзіңіздің Docker) |
| Ғаламдық CDN | ✅ | ❌ (тек өз VPS-іңіз) |
Coolify әдепкіде қоспайтын жалғыз нәрсе — ғаламдық CDN. Шынын айтқанда, жағдай осындай. Жобаңыздың аудиториясы әлем бойынша таралса және АҚШ пен Еуропадағы пайдаланушылар үшін кідірісті азайту керек болса, алдына Cloudflare қойыңыз; статикалық мазмұнға ол тегін.
Бағасы: өзіңіз хосттайтын нұсқасы шектеусіз әрі мәңгі тегін — қолданбалар, серверлер немесе орналастыру санына шектеу жоқ. Coolify Cloud айына $5 тұрады (2 серверге) + әр қосымша серверге $3 — бірақ серверлер бәрібір өзіңіздікі; Coolify Cloud тек басқару панелін хосттайды.
Соңғы шығарылым — 2026 жылғы 18 мамырдағы v4.1.0. Жаңа мүмкіндіктеріне бета нұсқасындағы Railpack құрастыру пакеті, аудит журналын жүргізу, орналастырулар арасындағы конфигурация айырмашылықтары және төл MCP соңғы нүктесі (тек оқуға арналған) кіреді. Дереккөз: GitHub шығарылымдары.
2026 жылы Coolify үшін қандай VPS алу керек?
Негізгі түйін
Coolify-ге кемінде 2 vCPU, 2 GB RAM, 30 GB SSD және Ubuntu LTS (20.04, 22.04 немесе 24.04) қажет. Осындай VPS vibe-кодпен жасалған 3–5 жобаны қатар іске қоса алады.
Coolify-дің ең төменгі талаптары ресми құжаттамадан алынған:
| Параметр | Ең төменгісі | Ұсынылатыны |
|---|---|---|
| CPU | 2 ядро | 2–4 ядро |
| RAM | 2 GB | 4 GB (құрастыруға қосымша қорымен) |
| Жад | 30 GB | 50–80 GB (образдар мен дерекқорларға) |
| Архитектура | AMD64 немесе ARM64 (64-бит) | AMD64 |
| ОЖ | Ubuntu LTS 20.04 / 22.04 / 24.04 | 22.04 LTS |
| Root | Міндетті | Құпиясөзбен емес, SSH кілті арқылы |
Ең төменгі 2 GB RAM — қатаң төменгі шек. 1 GB болса, орнатқыш Docker-ге дейін жетіп, OOM (жадтың таусылуы) қатесіне ұшырап, тұрып қалады. RAM-ды үнемдемеңіз.
Баға дереккөздері: Timeweb Cloud, FirstVDS және Selectel.
Көбірек қуат керек болса (100 GB дерекқор, бірнеше Postgres данасы), Aeza Dedicated алыңыз.
МЫНАНЫ АЛМАҢЫЗ:
- 512 MB–1 GB RAM ортақ VPS — Coolify-дің өзіне де жетпейді. Бұл PaaS үшін емес, nginx-тағы статикалық сайттарға арналған.
Орналастыруды баптап қана қоймай, Claude сенімді жұмыс істейтін баптауды да құрғыңыз келе ме? Coolify — орындау құралы, бірақ құрылымды контекст (CLAUDE.md, екінші ми және контекст инженериясы) болмаса, Claude ұзақ тапсырмаларда бәрібір галлюцинация жасайды. Толық баптау осы үшеуінен тұрады: AI көшірмесі + Екінші ми + Контекст инженериясы — Claude-ты «галлюцинация жасайтын көмекшіден» сенімді құралға айналдыратын осы үйлесім.
Coolify-ді 5 минутта қалай орнатуға болады
Негізгі түйін
Орнату үшін құжаттамадағы бір curl командасы жеткілікті. Ол орындала бастағанда 8000 портында веб-интерфейс ашылады. Сол жерде алғашқы әкімші пайдаланушыны жасап, бос басқару панелін көресіз. Бос Ubuntu орнатылымынан жұмыс істеп тұрған Coolify-ге дейін шын мәнінде 5–7 минут кетеді, оның 3–4 минуты apt-get install docker командасына жұмсалады. Скрипт қажетті тәуелділіктерді алып, Docker-ді өзі баптайды; сізге оның аяқталуын күту ғана керек.
1-қадам. VPS-ке SSH арқылы қосылыңыз.
Провайдерде VPS жасағаннан кейін сервердің IP мекенжайы мен root құпиясөзі электрондық поштаға немесе басқару панеліне келеді. Жергілікті компьютеріңізден қосылыңыз:
ssh root@1.2.3.4
Егер провайдер құпиясөздің орнына SSH кілтін берген болса, -i path/to/key арқылы қосылыңыз. Бұдан әрі жаңа Ubuntu 22.04 немесе 24.04 LTS орнатылымы бар деп есептеймін.
2-қадам. Coolify орнату командасын орындаңыз.
Ресми құжаттамадағы бір команда:
curl -fsSL https://cdn.coollabs.io/coolify/install.sh | sudo bash
Скрипт үш әрекет орындайды:
- Жүйені тексереді (Ubuntu LTS пе? root па? AMD64 пе?)
- Docker мен Docker Compose орнатылмаған болса, орнатады
- Coolify образдарын (
coolify/coolify,coolify/realtime,traefik) жүктеп алып, docker-compose арқылы фонда іске қосады
Бұған 3–5 минут кетеді. apt-get журналдары жылжып, соңынан docker pull шығады. Coolify v4.1.0 is now running дегенді көрсеңіз, 3-қадамға өтіңіз.
3-қадам. Веб-интерфейсті ашыңыз.
Мұны браузерде ашыңыз:
http://1.2.3.4:8000
Coolify баптау шеберін — алғашқы пайдаланушыны жасауға арналған пішінді көрсетеді. Электрондық пошта мен құпиясөз енгізіп, сақтаңыз. Бұл пайдаланушы автоматты түрде әкімші болады; әзірге басқа пайдаланушылар қажет емес.
Сақтаған соң бос басқару панеліне өтесіз: сол жақта Resources / Projects / Servers / Sources / Notifications / Settings мәзірі, ал ортасында “Add your first resource” деген ұсыныс тұрады.
4-қадам. Провайдердің брандмауэрінде порттарды ашыңыз (UFW-де емес).
Coolify жұмыс істеп тұр, бірақ сырттан тек 8000 портын (басқару панелін) ашуға болады. Пайдаланушылар қолданбаларыңызға кіре алуы үшін 80 (HTTP) және 443 (HTTPS) порттарын ашу керек:
| Порт | Мақсаты |
|---|---|
| 22 | Серверге SSH арқылы қосылу |
| 80 | HTTP трафигін қабылдайды, Let's Encrypt тексеруіне қажет |
| 443 | Пайдаланушылардың HTTPS трафигін қабылдайды |
| 8000 | Coolify басқару панелі (панельге жеке домен баптаған соң бұл портты жабамыз) |
Ресми құжаттамадағы маңызды ескерту:
Docker NAT негізіндегі iptables ережелерін пайдаланып, UFW сияқты дәстүрлі Linux брандмауэрлерін айналып өтуі мүмкін.
Демек, UFW қосып, барлық портты жапсаңыз да, Docker контейнерлерін iptables арқылы сыртқа шығара береді. Бұл жерде UFW пайдасыз. Шешімі — порттарды UFW арқылы емес, провайдердің басқару панелінде ашып-жабу. Timeweb / Selectel / Aeza қызметтерінде мұны веб-консольдегі “Network → Firewall” бөлімінде жасайсыз.
5-қадам (қосымша). Басқару панелін доменге байланыстырыңыз.
http://1.2.3.4:8000 орнына https://coolify.example.com мекенжайына кіру үшін coolify.example.com → 1.2.3.4 деген DNS A жазбасын жасап, Coolify-де Settings → Instance Settings → Instance Domain бөліміне өтіп, қосалқы доменіңізді енгізіп, сақтаңыз. Coolify Let's Encrypt сертификатын сұратып, бір минуттан кейін басқару панелін HTTPS арқылы қайта жүктейді.
Одан кейін брандмауэрдегі 8000 портын жабуға болады — басқару панелі стандартты 443 портындағы HTTPS арқылы қолжетімді болады.
GitHub-ты қалай қосу керек: App па, PAT па?
Негізгі түйін
Coolify GitHub-қа қосылудың екі жолын қолдайды: GitHub App (ұсынылады) және Personal Access Token (PAT). GitHub App қолданыңыз: шебер арқылы баптау 5 минут алады, PR алдын ала қараулары жұмыс істейді, рұқсаттарды репозиторий деңгейінде дәл шектеуге болады. PAT — ескі жағдайларға арналған ескірген нұсқа; онда алдын ала қарау орналастырулары жоқ әрі барлық репозиторийге жаһандық қатынас беру қаупі бар. Ресми құжаттамада: «пайдаланушылардың 95%-ына GitHub App дұрыс таңдау» деп тікелей жазылған.
Coolify-де Sources → + Add → GitHub App бөліміне өтіңіз. Coolify үш экраннан тұратын шеберді көрсетеді:
- Name & description — дереккөзге атау беріңіз (
github-mainенгізіңіз), сипаттаманы қаласаңыз қосыңыз. - Configure on GitHub — GitHub.com сайтына апаратын түйме; ол дұрыс рұқсаттары бар GitHub App жасау пішінін автоматты түрде ашады.
- Confirm — GitHub-тан оралған соң “Save” түймесін басыңыз.
Екінші қадамда GitHub Coolify сұрайтын рұқсаттарды растауды сұрайды:
| Рұқсат | Деңгей | Мақсаты |
|---|---|---|
| Contents | Тек оқу | Репозиторийді клондау |
| Pull Requests | Оқу және жазу | Алдын ала қарау орналастыруларын жасау және PR-ларға пікір қалдыру |
| Email addresses | Тек оқу | Коммиттерді анықтау |
| Metadata | Тек оқу | Репозиторийлер тізімін көрсету |
Бұлар — ең аз рұқсаттар: GitHub App жеке кілттеріңізді көре алмайды, main тармағына жаза алмайды және сіз арнайы қоспаған репозиторийлерге кіре алмайды.
Ресми құжаттамадан:
Personal Access Token (PAT) — ескі әдіс; оны пайдаланбауға кеңес беремін. Кемшіліктері:
- PAT барлық репозиторийге (соның ішінде жеке репозиторийлерге) жаһандық қатынас береді
- PR алдын ала қараулары жұмыс істемейді — бұл мүмкіндік тек GitHub App-та бар
- Токен ұзақ уақытқа жарамды (90 күн, бір жыл немесе мерзімсіз) — ол таралып кетсе, жағдай қиын
PAT-ты тек GitHub Apps қолдануға қауіпсіздік саясаты тыйым салатын және оны айналып өтудің жолы жоқ ұйым репозиторийімен жұмыс істегенде ғана қолданыңыз.
Coolify-де дереккөзді сақтаған соң, басқару панелінде GitHub App және қосылған репозиторийлер тізімі көрінеді. Жаңа қолданба жасағанда, олардың кез келгенін бір рет басып таңдай аласыз.
Claude Code жобасын 6 қадамда қалай орналастыруға болады
Негізгі түйін
Claude Code-тың бос баптауынан іске қосылған сайтқа дейінгі толық жол: 1) бос қалтада claude іске қосып, жобаны сипаттаңыз, сонда Claude кодты жасайды; 2) git init && git remote add орындаңыз (Claude мұны slash командасы арқылы өзі істей алады); 3) GitHub-қа жіберіңіз; 4) Coolify-де “+ New Resource → Application” таңдап, репозиторийді белгілеңіз; 5) орта айнымалыларын қосыңыз; 6) Deploy басыңыз. Coolify оның Next.js екенін анықтап, Nixpacks құрастыру пакетін таңдайды, 3–5 минутта Docker образын құрастырады және HTTPS әдепкіде қосылған уақытша домен береді.
1-қадам. Бос қалтада Claude Code-қа жобаны сипаттаңыз.
mkdir my-vibe-app
cd my-vibe-app
git init
claude
Сеанс ішінде:
Build a Next.js 14 app router project:
- a home page with a list of users
- /api/users endpoint returns an array from the database
- Postgres via Prisma
- Tailwind for styles
- .env.example with DATABASE_URL
- README.md with instructions for running the project
Claude файлдарын, package.json, prisma/schema.prisma және .env.example құрылымын жасайды. Сондай-ақ мынаны сұраңыз:
Create a Dockerfile for production builds and a .dockerignore.
Бұл міндетті емес — Dockerfile болмаса да, Coolify Nixpacks арқылы құрастырады. Бірақ Dockerfile үдерісті бақылауға мүмкіндік береді әрі ірі жобалар үшін жылдамырақ.
2-қадам. GitHub репозиторийін жасап, оған жіберіңіз.
Мұны GitHub интерфейсі арқылы қолмен + git remote add origin ... көмегімен жасауға болады, бірақ Claude Code мұны өзі де істей алады:
/commit-push-pr Initial Next.js app generated with Claude Code
Немесе жай ғана: “Commit everything and push it to a new repository my-vibe-app under my account.” деп айтыңыз. Claude жеке (немесе ашық) репозиторий жасап, алғашқы push-ты орындау үшін gh CLI қолданады. Дереккөз: Claude Code-тың ресми командасы.
3-қадам. Coolify-де Application жасаңыз.
Coolify басқару панелінде + New → Application басыңыз. Пішін ашылады:
- Source — алдыңғы H2-де қосылған GitHub App
github-mainтаңдаңыз - Repository — тізімнен
my-vibe-appтаңдаңыз - Branch —
main - Build Pack — Coolify автоматты түрде анықтайды. Dockerfile болса,
dockerfileқолданады. Әйтпесеnixpacksпайдаланады. Мұны қолмен өзгертуге болады. - Domain — әзірге ұсынылған мәнді қалдырыңыз; ол уақытша, кейін өз доменіңізбен алмастырасыз
- Port — Next.js үшін әдепкіде
3000
Сақтаңыз.
4-қадам. Орта айнымалыларын қосыңыз.
Жасалған қолданбадағы Environment Variables қойындысын ашыңыз. Айнымалыларды бір-бірден қосыңыз:
DATABASE_URL=postgresql://user:pass@db-host:5432/mydb
NODE_ENV=production
ANTHROPIC_API_KEY=sk-ant-...
Дерекқорыңыз болмаса, оны тікелей Coolify-де жасаңыз: + New → Database → PostgreSQL. Coolify Postgres контейнерін 30 секундта іске қосып, postgresql://postgres:pass@postgres-xyz:5432/postgres пішіміндегі ішкі DATABASE_URL береді — оны қолданбаңызға енгізіңіз.
Барлық айнымалы Coolify дерекқорында шифрланады және құрастыру журналдарында көрсетілмейді.
5-қадам. Deploy түймесін басыңыз.
Жоғарғы оң жақта көк Deploy түймесі бар. Нақты уақыттағы журналдар 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 for temporary domain
[stage: ssl] Let's Encrypt cert issued for temporary domain
Алғашқы құрастыру 3–5 минут алады (Node базалық образын жүктеп, тәуелділіктерді орнатады). Кейінгі құрастырулар Docker қабаттарын кэштеу арқасында 60–90 секундта орындалады.
Күйі Running болғанда, Coolify ішіндегі Domains өрісінде көрсетілген қолданба URL мекенжайын көшіріп, браузерде дәл соны ашыңыз. Төменде оны <app-url-from-coolify> деп белгілейміз; бұрышты жақшадағы атау — нақты мекенжай емес, толтырғыш. HTTPS бірден қосылған басты бетіңіз көрінуі керек. Ол — тегін wildcard DNS қызметі; IP мекенжайы бар кез келген қосалқы доменді анықтайды (1-2-3-4 қосалқы домені 1.2.3.4 IP мекенжайына бағытталады). Coolify оны уақытша домендерге пайдаланады, сондықтан өз DNS-іңізді баптамай-ақ сайтты бірден аша аласыз.
6-қадам. Барлығы жұмыс істейтінін тексеріңіз.
Алдыңғы қадамдағы қолданба URL мекенжайына /api/users қосып ашыңыз, мысалы <app-url-from-coolify>/api/users; қиғаш сызықты қайталамаңыз. Бұл — 1-қадамда жасалған JSON endpoint, ал қолданбаның түбір URL мекенжайы — басты бет. 500 қатесі болса, стек ізі Logs қойындысында көрінеді. Алғашқы орналастыруда жиі болатын мәселе — DATABASE_URL жоқ дерекқорды көрсетуі. Оны Coolify-де PostgreSQL данасын жасап (жоғарыдағы 4-қадамды қараңыз), DATABASE_URL мәнін ауыстыру арқылы түзетіңіз.
VPS-ке тапсырыс берген сәттен бастап — 15 минут. Бастапқы мысалда бұл жұмыс жаңа серверде 12–18 минут алды.
Жеке домен мен HTTPS-ті қалай баптауға болады
Негізгі түйін
Жеке домен үш қадамда қосылады: сервердің IP мекенжайына бағыттайтын DNS A жазбасын жасаңыз, Coolify конфигурациясында уақытша доменді өз доменіңізбен ауыстырып, Automatic HTTPS қосыңыз да, Redeploy басыңыз. DNS таралғаннан кейін 2–3 минутта Let's Encrypt SSL сертификатын автоматты түрде береді (әдетте 5–30 минут). Негізгі талап — Redeploy басқан кезде DNS шешімі дайын болуы керек; әйтпесе Let's Encrypt тексеруі өтпей, келесі әрекетке дейін 12 минут күтуге тура келеді.
1-қадам. Тіркеушіңіздің басқару панелінде DNS A жазбасын жасаңыз.
Бастапқы мысалдарда Reg.ru, Beget немесе Timeweb хостингіндегі домендер қолданылған. Рәсімі бірдей:
| Жазба түрі | Атауы | Мәні |
|---|---|---|
| A | app (немесе түбірлік домен үшін @) | 1.2.3.4 (сервер IP-і) |
Сақтап, консоль ашып, тексеріңіз:
dig app.example.com +short
# 1.2.3.4 қайтаруы керек
Ештеңе немесе басқа IP қайтарса, DNS әлі таралмаған. 5–30 минут күтіңіз.
2-қадам. Доменіңізді Coolify-ге енгізіңіз.
Қолданбада Configuration → General қойындысын ашыңыз. Domains өрісінде Coolify-ден көшірілген уақытша қолданба URL мекенжайын өзіңіз баптаған доменге, мысалы https://app.example.com, ауыстырыңыз. Automatic HTTPS қосыңыз (әдетте әдепкіде қосулы болады).
Сақтап, Redeploy басыңыз.
3-қадам. Let's Encrypt сертификатын күтіңіз.
Құрастыру журналдарында мыналар көрсетіледі:
[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
2–3 минут ішінде сайтыңыз мекенжай жолағындағы жасыл құлып белгісімен https://app.example.com адресінде қолжетімді болады.
Let's Encrypt жұмысында не кедергі болуы мүмкін (ресми ақауларды жою нұсқаулығындағы ең жиі кездесетін 3 мәселе):
- Брандмауэрде 80 порт жабық. Let's Encrypt HTTP challenge арқылы тексереді —
http://app.example.com/.well-known/acme-challenge/xxxмекенжайына сұрау жібереді. 80 портсыз тексеру өтпейді. Оны провайдердің брандмауэрінде ашыңыз. - Cloudflare проксиі қосулы (қызғылт сары бұлт). Ол Let's Encrypt сұрауын ұстап, өз орнына арналған бетін қайтарады — тексеру өтпейді. Шешімі — “DNS only” (сұр бұлт) режиміне ауысу немесе Cloudflare API арқылы DNS-01 тексеруін баптау.
- DNS әлі таралмаған. A жазбасын 30 секунд бұрын жасап, бірден Redeploy бассаңыз, Let's Encrypt доменіңізді көрмейді. DNS серверлерге таралуы үшін 5–30 минут күтіңіз.
Let's Encrypt шектеуі: бір домен үшін сағатына 5 сәтсіз әрекет, қалпына келу қарқыны — әр 12 минутта 1 әрекет. Шекке жетсеңіз, Redeploy түймесін қатарынан 10 рет баспаңыз; журналдарды қарап, мәселені түзеп, 12 минуттан соң қайталап көріңіз.
Claude Code Coolify-ді MCP арқылы қалай басқарады?
Негізгі түйін
Model Context Protocol арқылы Claude Code Coolify API-іне тікелей қатынайды — қолданбаны құрастыруды бастау, күйін тексеру, журналдарын оқу немесе орта айнымалыларын жаңарту үшін “deploy this application” деп айта аласыз. Үш нұсқа бар: forsonny/Coolify-MCP-Server (негізгі, 7 санат операция), dazeb/coolify-mcp-enhanced (бір рет басып дерекқор орналастыруды қоса алғанда 15+ қосымша құрал) және ajmcclary/Coolify-Manager (ресми CLI айналасында жасалған Claude Skill). v4.1.0 нұсқасынан (2026 жылғы 18 мамыр) бастап Coolify үшінші тарап серверлерінсіз төл MCP соңғы нүктесін ұсынады, бірақ әзірше тек оқуға арналған.
Model Context Protocol (MCP) — Anthropic жасаған, Claude Code-қа сыртқы жүйелермен байланысуға мүмкіндік беретін стандарт (толығырақ MCP серверлері жөніндегі нұсқаулықты қараңыз). MCP серверін қоссаңыз, Claude шақыра алатын құралдар жиынын алады. Coolify үшін дайын үш сервер және бір төл нұсқа бар.
1-нұсқа. forsonny/Coolify-MCP-Server-for-Claude-Code — негізгі.
Мүмкіндіктері:
- Қолданбалар: жасау, іске қосу, тоқтату, қайта іске қосу
- Қызметтер: тізімдеу, жасау, іске қосу/тоқтату/қайта іске қосу
- Орналастырулар: орындалып жатқанын көру, UUID бойынша алу
- Топтар және мүшелер: тізімдеу, ақпарат алу
- SSH кілттері: тізімдеу, жасау
- Ортаның айнымалылары: қолданбалар мен қызметтер үшін толық CRUD
- Сервер туралы мәлімет: сервердегі домендер, күй, нұсқа
Орнату:
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 # автоматты түрде Claude Code баптайды
Одан кейін Claude Code-қа мынаны жазуға болады:
Show the status of the my-vibe-app application in Coolify and the 3 latest deployments.
Claude кестені қайтарады.
2-нұсқа. dazeb/coolify-mcp-enhanced — кеңейтілген (ұсынылады).
Негізгі жиынтыққа қосатыны:
- PostgreSQL / Redis / MinIO-ны бір рет басып орналастыру — AI-дан “set up Postgres for me” деп сұрасаңыз, контейнер жасап, DATABASE_URL қайтарады
- Нақты уақыттағы бақылау + ресурстарды пайдалану — әр қолданбаның CPU/RAM көрсеткішін нақты уақытта көру
- Ортаның конфигурациясын жаппай жаңарту — бір командамен 20 айнымалыны жаңарту
- Docker Compose қолдауы — бірнеше қызметтен тұратын қолданбаларды орналастыру
Claude Code конфигурациясы (жоба түбіріндегі .mcp.json):
{
"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-нұсқа. ajmcclary/Coolify-Manager — CLI негізінде жасалған Claude Skill.
Бұл MCP сервері емес, ресми Coolify CLI-ді орайтын Claude Code Skill. Ішінде:
- Қызметтер мен контейнерлердің күйін тексеру
- SSL сертификаттарының күйін тексеру
- Бірнеше дананы қолдау (бірнеше Coolify серверіңіз болса)
- Ақауларды жоюға арналған нұсқаулар
Орнату: skill-ді жүктеп алып, ~/.claude/skills/coolify-manager/ қалтасына салыңыз. Claude Code оны анықтап, тиісті тапсырмаларда ұсынады.
4-нұсқа (2026 жылғы мамырда қосылған). Coolify v4.1.0 ішіндегі төл MCP.
2026 жылғы 18 мамырдағы v4.1.0 өзгерістер тізімінде былай делінген:
Coolify ресурстары мен API/UI үшін тек оқуға арналған құралдармен дана деңгейіндегі MCP қолдауы қосылды.
Coolify енді өзінің MCP соңғы нүктесін ұсынады — Claude Code-ты үшінші тарап серверлерінсіз тікелей қосуға болады. Әзірше ол тек оқуға арналған (қолданбалар тізімі, күйлер, конфигурациялар), өзгерту операциялары жоқ. Бірақ бұл «инфрақұрылым туралы айтып бер» сияқты тапсырмалардың көбіне жеткілікті.
.mcp.json арқылы қосыңыз:
{
"mcpServers": {
"coolify-native": {
"url": "https://coolify.example.com/api/v1/mcp",
"headers": {
"Authorization": "Bearer <your-api-token>"
}
}
}
}
v4.2 немесе v4.3 нұсқаларында төл MCP-ге толық жазу мүмкіндігі қосылуын күтіңіз — Coolify командасы оны 2026 жылдың соңына дейін уәде етті.
Алғашқы орналастырудағы 5 кедергі және олардан қалай сақтануға болады
Негізгі түйін
Алғашқы орналастыруда жиі болатын қателер: RAM жеткіліксіздігі, 80 порттың жабық болуы, Cloudflare проксиінің Let's Encrypt жұмысын бұзуы, UFW-дің Docker-ді қорғай алмауы және GitHub App орнына PAT таңдау. Бұлардың бәрі ресми құжаттамада қамтылған, бірақ тәжірибесіз болсаңыз, бұларға оңай тап боласыз. Төменде Coolify-ді алғаш орнату тәжірибесіне негізделген 5 тармақтық тексеру тізімі берілген.
1-кедергі: 2 GB-тан аз RAM — орнату OOM қатесімен сәтсіз аяқталады.
Белгісі: curl install.sh командасы docker pull coolify/coolify кезеңіне жетіп, 70% деңгейінде тұрып қалады да, кейін үдеріс Killed (signal 9) деген хабармен тоқтатылады. dmesg | tail журналдарында Out of memory: Killed process көрсетіледі.
Шешімі:
# Мәселені уақытша шешу үшін 4 GB swap файлын жасаңыз
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
Ұзақ мерзімді шешім ретінде 4 GB RAM-ға жаңартыңыз. Coolify swap-пен жұмыс істейді, бірақ ірі Next.js жобаларын құрастыру сәтсіз болуы мүмкін.
2-кедергі: UFW қосулы, бірақ Docker порттарды бәрібір ашады.
Белгісі: UFW-ді қосып, 22-ден басқа барлық портты жаптыңыз, бірақ қолданба интернеттен қандай да бір кездейсоқ портта (мысалы, 3000) әлі ашық.
Себебі ресми құжаттамада түсіндірілген:
Coolify Docker-де жұмыс істейді; ол NAT негізіндегі iptables ережелерін пайдаланып, UFW сияқты дәстүрлі Linux брандмауэрлерін айналып өтуі мүмкін.
Шешімі: UFW емес, провайдердің басқару панеліндегі брандмауэрді пайдаланыңыз. Timeweb / Selectel / Aeza қызметтерінде виртуалды желі деңгейіндегі ережелерді баптайтын “Firewall” немесе “Network → Firewall” бөлімі бар — олар пакеттер Docker-ге жетпей тұрып жұмыс істейді.
Баламасы — Docker-мен үйлесімді болу үшін UFW-ді түзететін ufw-docker скрипті. Бірақ басқару панеліндегі түймені басқаннан күрделірек.
3-кедергі: Cloudflare проксиі (қызғылт сары бұлт) Let's Encrypt жұмысын бұзады.
Белгісі: Redeploy-тен кейін журналдарда Let's Encrypt validation failed - challenge returned 403 шығады.
Себебі: Cloudflare Let's Encrypt-тің HTTP сұрауын прокси арқылы өткізіп, challenge файлының орнына өз бетін қайтарады.
Шешімі — екі нұсқаның бірін таңдаңыз:
- “DNS only” режиміне ауысыңыз (Cloudflare-дегі сұр бұлт). Кемшілігі: Cloudflare CDN-і мен қорғанысынан айырыласыз.
- Cloudflare API арқылы DNS-01 challenge баптаңыз. Coolify-де Settings → SSL Configuration бөліміне өтіп, Cloudflare провайдерін таңдап, Zone:Read және DNS:Edit рұқсаттары бар API токенін енгізіңіз. Let's Encrypt HTTP орнына TXT жазбасы арқылы тексереді.
Екінші нұсқаны баптау күрделірек, бірақ Cloudflare проксиін сақтап қалады.
4-кедергі: GitHub App орнына PAT — PR алдын ала қараулары жұмыс істемейді.
Белгісі: GitHub-ты Personal Access Token арқылы қостыңыз; бәрі істейді, бірақ PR-ларға алдын ала қарау орналастырулары жасалмайды. GitHub-та PR аштыңыз, Coolify-де ештеңе шықпады.
Себебі: PR алдын ала қараулары — тек GitHub App-та болатын мүмкіндік. PAT вебхук арқылы pull_request оқиғаларын алмайды.
Шешімі: GitHub-ты App арқылы қайта қосыңыз. Sources → Add → GitHub App → шеберді аяқтаңыз. Ескі PAT дереккөзін жоюға болады.
5-кедергі: “Coolify == Vercel” деу толық дұрыс емес.
Coolify әдепкіде істей алмайтын нәрселер:
| Vercel | Coolify | Не істеу керек |
|---|---|---|
| Ғаламдық CDN | Жоқ | Алдына Cloudflare қойыңыз (статикалық мазмұнға тегін) |
| Incremental Static Regeneration | Жоқ | revalidatePath тек өз серверіңізде жұмыс істейді |
| Образдарды оңтайландыру | Жоқ | Жергілікті loader немесе Cloudflare Images арқылы next/image қолданыңыз |
| Қарбалас кезіндегі автоматты масштабтау | Жоқ | Қолмен масштабтаңыз; VPS-ті жаңартыңыз |
| Edge Functions | Жоқ | Әдеттегі API маршруттарын пайдаланыңыз |
Жобаңыз ғаламдық аудиториясы және дүние жүзі бойынша < 100 ms кідіріс талабымен жұмыс істейтін, трафигі жоғары SaaS болса, Coolify жарамайды; Vercel Enterprise таңдаңыз. MVP-ді күніне 100–1,000 пайдаланушымен сынап жүрген vibe-кодтаушы болсаңыз, Coolify қажеттінің бәрін қамтиды.
Шынайы өзі хосттайтын жүйе талдауынан:
Осы нұсқаулықтың атауындағы 15 минут бір жобаны алғаш орналастырудың қалыпты жолын білдіреді. Бақылау, сақтық көшірмелер мен ескертулер қамтылған толық инфрақұрылымды баптауға бір-екі кеш кетеді. Өзіңізге шындықты айтыңыз.
Vercel-мен салыстырғанда бір жылда қанша үнемдейсіз?
Негізгі түйін
Бастапқы баптауға 5–10 сағат және қызмет көрсетуге айына 1–2 сағат кететін «жасырын уақыт салығы» бар.
Төмендегі Vercel сандары — қазіргі ұсыныстар емес, мақаланың 2026 жылғы мамырдағы сценарий бағалаулары. Олар салыстырудың бір жағы ғана. Өзіңіз орналастырған Coolify лицензиясыз тегін болғанымен, VPS, сақтық көшірме, сақтау, трафик және күтім ақылы. Жоғарыдағы талаптарға сай нақты ұсыныс алыңыз; бұл сценарийлерде VPS бағасы берілмеген, сондықтан тұрақты үнемді уәде ету дәлелсіз.
C — таңдалған VPS, резервтік сақтау, қосымша трафик, мониторинг және ақылы панель нұсқасының жалпы айлық инфрақұрылым шоты болсын. Әр шығынды бір рет қосыңыз. r — барлық жерде бір валютамен алынған операциялық жұмыстың сағат құны. Мақала уақыты: басында 5–10 сағат, ай сайын 1–2 сағат, яғни бірінші жылы 17–34 сағат, кейін жылына 12–24 сағат.
| Сценарий | Vercel айлық бағалауы | Vercel жылына | Coolify инфрақұрылымы айына | Coolify бірінші жыл толық құны, еңбекті қоса | Vercel-мен салыстырған бірінші жыл үнемі |
|---|---|---|---|---|---|
| Бір прототип, айына 100,000 қаралым | $20 негіз + ~$5 трафик = $25 | $300 | C | 12C + (17–34)r | $300 − 12C − (17–34)r |
| Бір VPS-тегі бес жоба | $20 негіз + $30 трафик/функциялар = $50 | $600 | C | 12C + (17–34)r | $600 − 12C − (17–34)r |
| Үш әзірлеуші, бес жоба | $60 орындар + $30 трафик = $90 | $1,080 | C | 12C + (17–34)r | $1,080 − 12C − (17–34)r |
Жүктемеге әртүрлі сервер керек болса, әр сценарийге бөлек C қолданыңыз. Бастапқы баптау еңбегін 12 айға бөлгендегі бірінші жыл айлық баламасы — C + (17–34)r/12. Кейінгі жыл толық құны — 12C + (12–24)r. Формулалар берілген Vercel бағалауын өзіндік хостинг шығынымен салыстырады; Vercel жағына да салыстырмалы күтім құнын қосыңыз. Теріс үнем енгізген мәндерде өзіндік хостинг қымбат екенін білдіреді. r инженердің еңбекақысын қамтыса, толық жалақысын тағы қоспаңыз.
Ауысудан бұрын C мәнін нақты провайдер ұсынысы мен резерв жоспарынан толтырып, r таңдаңыз және бір айлық нақты тұтынуды салыстырыңыз. Бұл деректерсіз мақала долларлық үнемді емес, шығын үлгісін береді.
Басты пайдасы ақшада емес. Coolify-ге көшкенде «біреудің төлем саясатына тәуелді» деген санат жоғалады. 20% комиссиясы бар виртуалды делдал карталар енді қажет емес.
Coolify — Vercel-дің арзанырақ нұсқасы емес. Бұл — өнімнің басқа санаты: инфрақұрылым өзіңізге тиесілі, оған жауап бересіз және күрделілігін қабылдау арқылы ақша үнемдейсіз.
Егер прототипті орналастыру Claude Code-пен генерациялағаннан кейінгі алғашқы тапсырмаңыз болса, ортаны басқару (env, құпия деректер, жоспарланған тапсырмалар, сақтық көшірмелер) — контекст инженериясының бір бөлігі. «Барлығы қайда тұрады» деген құрылым болмаса, Claude адасады, ал әр өзгеріске уақыт жоғалтасыз. Толық баптау мыналардан тұрады: AI көшірмесі (әдіснамаңызға сай Skills және Subagents) + Екінші ми (жобаның білім қоры) + Контекст инженериясы (Plan Mode, /compact, орындау ортасы). Бұлар — AI-мен жұмысты реттеуге арналған 3 тірек.
Дереккөздер
Толық контекст жұмыс процесі: AI көшірмесі + Екінші ми + Контекст инженериясы.
Қосымша материалдар Ailoot сайтында бар.
Толығырақ
Жиі қойылатын сұрақтар
Орналастырғаннан кейін қай URL JSON қайтаруы керек?
Coolify Domains өрісіндегі қолданба URL мекенжайын көшіріп, оның /api/users жолын ашыңыз. Түбір URL — басты бет; /api/users — мысал жобасында көрсетілген JSON endpoint-і.
Өзіндік хостинг үнем беретінін қалай есептеймін?
Айлық VPS, резервтер, сақтау, трафик, мониторинг және қосымша панель ақысын C сомасына қосыңыз. Бірінші жылдағы толық шығын — 12C және өз сағат құныңызбен 17–34 сағат. Оны сценарийдің жылдық Vercel есебімен салыстырып, екі жаққа да салыстырмалы операциялық шығындарды қосыңыз.