Статья 89 из 141
Гайды
Coolify на VPS: свой PaaS для деплоя приложений из Git, баз данных и HTTPS
Coolify — открытая панель для самостоятельного хостинга приложений, аналог Heroku или Vercel на вашем сервере. Вы подключаете Git-репозиторий, а Coolify сам собирает образ, запускает контейнер, выдаёт домен и сертификат Let’s Encrypt. В той же панели можно поднять PostgreSQL, MySQL, Redis и другие базы и настроить их бэкапы.
Coolify подойдёт, если вы держите на одном VPS несколько сайтов, ботов или API и не хотите вручную писать конфиги Nginx и docker-compose.yml для каждого.
Требования
Заголовок раздела «Требования»| Ресурс | Минимум по документации | Рекомендуем |
|---|---|---|
| CPU | 2 ядра | 2–4 vCPU |
| RAM | 2 ГБ | 4 ГБ, если собираете образы на этом же сервере |
| Диск | 10 ГБ свободно | 30 ГБ и больше: образы, тома и бэкапы растут |
| ОС | Ubuntu LTS 20.04, 22.04, 24.04, Debian и другие Linux | Чистая Ubuntu 24.04 |
Сборка приложений съедает много памяти. Если RAM мало, добавьте swap. Как выбрать тариф: выбор тарифа.
Ставьте Coolify на чистый сервер. Coolify запускает собственный прокси (по умолчанию Traefik, можно переключить на Caddy) и занимает порты 80 и 443. Если на сервере уже работает Nginx или Apache, они будут конфликтовать за эти порты. Либо выделите под Coolify отдельный VPS, либо перенесите существующие сайты внутрь Coolify.
Установка
Заголовок раздела «Установка»Подключитесь к серверу по SSH под root и запустите официальный скрипт:
curl -fsSL https://cdn.coollabs.io/coolify/install.sh | bashСкрипт сам поставит Docker Engine, если его нет. Docker из snap не поддерживается: если вы ставили Docker через snap, удалите его до установки.
В конце скрипт выведет адрес панели: http://IP_СЕРВЕРА:8000.
Первый вход
Заголовок раздела «Первый вход»Откройте http://IP_СЕРВЕРА:8000 и сразу создайте аккаунт администратора. Первый, кто откроет страницу регистрации, станет администратором с root-доступом к серверу.
Регистрация первого аккаунта открыта только 10 минут после запуска. Если вы увидели «Setup window closed», выполните:
docker restart coolifyи обновите страницу.
Затем закройте регистрацию: Settings → Advanced → Access → Registration → Registration disabled.
Сохраните ключ APP_KEY из /data/coolify/source/.env в менеджер паролей. Без него не получится восстановить Coolify из бэкапа:
grep '^APP_KEY=' /data/coolify/source/.envПорты и домен для панели
Заголовок раздела «Порты и домен для панели»Coolify использует такие порты:
| Порт | Назначение | Можно закрыть после настройки домена |
|---|---|---|
| 22/tcp | SSH, через него Coolify управляет сервером | Нет |
| 80/tcp | HTTP и выпуск сертификатов | Нет |
| 443/tcp | HTTPS через прокси Coolify | Нет |
| 8000/tcp | Панель по IP | Да |
| 6001/tcp | Обновления панели в реальном времени по IP | Да |
| 6002/tcp | Веб-терминал по IP | Да |
Привяжите панель к домену:
- Создайте A-запись, например
coolify.example.com, на IP сервера (DNS). - В Coolify откройте Settings → General, в поле URL укажите
https://coolify.example.comи нажмите Save changes. - Проверьте, что панель открывается по
https://coolify.example.com.
Теперь панель, realtime и терминал идут через 80 и 443, и порты 8000, 6001, 6002 можно закрыть. Учтите: Docker пишет свои правила iptables, и правила UFW не блокируют порты, опубликованные контейнерами. Документация Coolify советует закрывать такие порты фаерволом хостинга или утилитой ufw-docker. Подробнее о фаерволе: настройка фаервола.
Не используйте для панели домен, который уже занят приложением, и не указывайте путь вида example.com/coolify: это не поддерживается.
Деплой приложения из Git
Заголовок раздела «Деплой приложения из Git»- Создайте проект в разделе Projects и откройте его окружение.
- Нажмите + New и выберите Public Repository.
- Выберите сервер, то есть сам VPS с Coolify.
- Вставьте ссылку на репозиторий и нажмите Check Repository.
- Выберите способ сборки:
- Nixpacks или Railpack: Coolify сам определит язык и соберёт образ;
- Dockerfile: если в репозитории есть свой
Dockerfile; - Docker Compose: для проекта из нескольких сервисов;
- Static: для статического сайта.
- В разделе Network укажите в Ports Exposes порт, который слушает приложение внутри контейнера, например
3000. - Добавьте домен (ниже) и запустите деплой. Ход сборки виден в Deployment Logs.
Для приватных репозиториев подключите GitHub App: Sources → New source → GitHub App, затем + New → Private Repository (with GitHub App). Через GitHub App Coolify получает вебхуки и пересобирает приложение после push. Для этого панель должна быть доступна из интернета по домену.
Не используйте Port Mappings без нужды: проброшенный порт идёт мимо прокси и доменов.
База данных
Заголовок раздела «База данных»- В проекте нажмите + New и выберите базу: PostgreSQL, MySQL, MariaDB, MongoDB, Redis, KeyDB, Dragonfly, ClickHouse.
- Выберите сервер, проверьте сгенерированные логин и пароль в General и нажмите Start.
- В приложении используйте Internal URL со страницы базы. Он работает внутри Docker-сети Coolify.
По умолчанию база не доступна снаружи, и так лучше оставить. Если внешний доступ всё же нужен, включите его в Public access и ограничьте порт по IP.
Домены и HTTPS
Заголовок раздела «Домены и HTTPS»В настройках приложения откройте раздел доменов и добавьте домен с протоколом https://, например https://app.example.com. Coolify настроит маршрут в прокси, а прокси сам выпустит и продлит сертификат Let’s Encrypt.
Условия:
- A-запись домена указывает на IP сервера;
- порты 80 и 443 открыты и доходят до прокси Coolify.
Если домен не задан, Coolify может выдать временный адрес на sslip.io. Он работает только по http://, используйте его только для теста.
Есть два вида бэкапов, нужны оба.
Базы данных. Откройте базу → Backups → + Add, укажите расписание (daily или cron-выражение) и нажмите Add schedule. Файлы ложатся в /data/coolify/backups. Добавьте S3-хранилище (S3 storage), чтобы копии уходили с сервера. Проверьте бэкап кнопкой Back up now.
Сам Coolify. Settings → Backup → Configure backup. Это бэкап внутренней базы Coolify: проекты, настройки, история деплоев. Данные ваших приложений и томов он не включает. APP_KEY тоже храните отдельно.
Не держите единственную копию на том же сервере: бэкапы.
Обновление
Заголовок раздела «Обновление»Проще всего обновляться из панели: Settings → Updates → Upgrade now. Перед обновлением настройте бэкап Coolify: по умолчанию он запускается автоматически перед апдейтом. Дождитесь, пока закончатся текущие деплои.
Вручную, с указанием версии без буквы v:
curl -fsSL https://cdn.coollabs.io/coolify/upgrade.sh | bash -s 4.3.23Замените 4.3.23 на нужную версию. Не запускайте для обновления install.sh: на работающем сервере он сбросит права на /data/coolify.
Coolify или Dokploy
Заголовок раздела «Coolify или Dokploy»Dokploy (dokploy.com) решает ту же задачу: деплой из Git, базы, домены. Он тоже использует Traefik на портах 80 и 443, а приложения запускает через Docker Swarm. Панель Dokploy открывается на порту 3000, документация просит минимум 2 ГБ RAM и 30 ГБ диска. Установка:
curl -sSL https://dokploy.com/install.sh | shПосле установки откройте http://IP_СЕРВЕРА:3000. Ставить Coolify и Dokploy на один сервер нельзя: оба займут порты 80 и 443.
Частые проблемы
Заголовок раздела «Частые проблемы»| Симптом | Причина и решение |
|---|---|
| «Setup window closed» при первом входе | Прошло больше 10 минут после запуска. docker restart coolify и обновите страницу |
| Прокси не запускается, ошибка про порт 80 или 443 | Порт занят Nginx или Apache. ss -tlnp | grep -E ':80 |:443 ', остановите или удалите старый веб-сервер |
| Сертификат не выпускается | A-запись не указывает на сервер или закрыты 80 и 443. Проверьте DNS и порты |
| Приложение собралось, но отдаёт 502 | Неверный Ports Exposes или приложение слушает 127.0.0.1. Слушайте 0.0.0.0 и укажите верный порт |
| Сборка падает или сервер зависает | Не хватает памяти. Добавьте swap или увеличьте тариф |
| Push в GitHub не запускает деплой | GitHub не достучался до вебхука. Панель должна открываться по публичному домену |
| Порт 8000 открыт, хотя закрыт в UFW | Docker обходит UFW. Закройте порт фаерволом хостинга или через ufw-docker |
| Закончилось место на диске | Старые образы и бэкапы. Настройте ретеншн бэкапов и проверьте docker system df |
Общие ошибки Docker: ошибки Docker. Сравнение прокси: Traefik и Caddy.