Перейти к содержимому

Статья 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 Да

Привяжите панель к домену:

  1. Создайте A-запись, например coolify.example.com, на IP сервера (DNS).
  2. В Coolify откройте Settings → General, в поле URL укажите https://coolify.example.com и нажмите Save changes.
  3. Проверьте, что панель открывается по https://coolify.example.com.

Теперь панель, realtime и терминал идут через 80 и 443, и порты 8000, 6001, 6002 можно закрыть. Учтите: Docker пишет свои правила iptables, и правила UFW не блокируют порты, опубликованные контейнерами. Документация Coolify советует закрывать такие порты фаерволом хостинга или утилитой ufw-docker. Подробнее о фаерволе: настройка фаервола.

Не используйте для панели домен, который уже занят приложением, и не указывайте путь вида example.com/coolify: это не поддерживается.

  1. Создайте проект в разделе Projects и откройте его окружение.
  2. Нажмите + New и выберите Public Repository.
  3. Выберите сервер, то есть сам VPS с Coolify.
  4. Вставьте ссылку на репозиторий и нажмите Check Repository.
  5. Выберите способ сборки:
    • Nixpacks или Railpack: Coolify сам определит язык и соберёт образ;
    • Dockerfile: если в репозитории есть свой Dockerfile;
    • Docker Compose: для проекта из нескольких сервисов;
    • Static: для статического сайта.
  6. В разделе Network укажите в Ports Exposes порт, который слушает приложение внутри контейнера, например 3000.
  7. Добавьте домен (ниже) и запустите деплой. Ход сборки виден в Deployment Logs.

Для приватных репозиториев подключите GitHub App: Sources → New source → GitHub App, затем + New → Private Repository (with GitHub App). Через GitHub App Coolify получает вебхуки и пересобирает приложение после push. Для этого панель должна быть доступна из интернета по домену.

Не используйте Port Mappings без нужды: проброшенный порт идёт мимо прокси и доменов.

  1. В проекте нажмите + New и выберите базу: PostgreSQL, MySQL, MariaDB, MongoDB, Redis, KeyDB, Dragonfly, ClickHouse.
  2. Выберите сервер, проверьте сгенерированные логин и пароль в General и нажмите Start.
  3. В приложении используйте Internal URL со страницы базы. Он работает внутри Docker-сети Coolify.

По умолчанию база не доступна снаружи, и так лучше оставить. Если внешний доступ всё же нужен, включите его в Public access и ограничьте порт по IP.

В настройках приложения откройте раздел доменов и добавьте домен с протоколом 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.

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.