RU

Приложения

Установка Coolify и развёртывание первого приложения

Установите Coolify на Debian или Ubuntu, не открывая панель управления в Интернет, защитите экземпляр, разверните приложение с HTTPS, затем управляйте обновлениями и резервными копиями.

11 мин чтения, обновлено 18 ноября 2026 г.

На этой странице

Ваши значения

Укажите их один раз, и команды в руководстве обновятся.

Coolify — это самостоятельно размещаемая платформа, которая развёртывает ваши приложения, базы данных и службы на ваших собственных серверах. Она опирается на Docker и обратный прокси, который управляет доменами и HTTPS-сертификатами.

К концу этого руководства панель управления будет отвечать по адресу https://coolify.ваш-домен.com, её прямые порты не будут доступны из Интернета, учётная запись администратора будет защищена, а первое приложение заработает по адресу https://app.ваш-домен.com.

Заказать сервер

Это руководство подходит для серверов, которыми вы управляете самостоятельно:

Предварительные требования

  • Желательно сервер, выделенный под Coolify, под управлением Debian 12 или 13 либо Ubuntu 22.04 или 24.04
  • Минимум 2 ядра, 2 ГБ ОЗУ и 10 ГБ свободного места; увеличивайте эти значения в зависимости от ваших приложений и сборок
  • Доступ по SSH под root или пользователем с правами sudo
  • Docker Engine 24 или новее, установленный по руководству Установка Docker Engine и Docker Compose. Если его нет, установщик Coolify попытается установить его сам, но версию из snap он не принимает
  • Доменное имя, DNS-зоной которого вы управляете
  • Отсутствие служб, занимающих порты 80 и 443, например Nginx, Apache или Caddy

В этом руководстве используется версия 4.7.5 — стабильная версия на момент написания. Последнюю версию можно проверить в файле версий Coolify.

Используемые порты

Порт Назначение Доступность в этом руководстве
22/tcp SSH, включая подключение Coolify к серверу Открыт
80/tcp HTTP и проверка сертификатов Публичный, через прокси
443/tcp HTTPS Публичный, через прокси
443/udp HTTP/3 Публичный, через прокси
8000/tcp Прямой доступ к панели управления Только 127.0.0.1
6001/tcp Обновления в реальном времени Только 127.0.0.1
6002/tcp Веб-терминал Только 127.0.0.1
8080/tcp Порт, публикуемый конфигурацией Traefik по умолчанию Удаляется на шаге 7

Если вы используете UFW, оставьте SSH открытым командой sudo ufw allow 22/tcp, без правила limit: оно может обрывать повторяющиеся подключения Coolify.

Шаг 1: подготовьте DNS

Создайте две записи A, указывающие на IP_ВАШЕГО_СЕРВЕРА:

Имя Назначение
coolify.ваш-домен.com Панель управления
app.ваш-домен.com Первое приложение

Если ваш домен обслуживается в HostMyServers, следуйте руководству Указать на IP. Затем проверьте:

Терминал
dig +short A coolify.ваш-домен.com
dig +short A app.ваш-домен.com
dig +short AAAA coolify.ваш-домен.com

Первые две команды должны вернуть адрес сервера. Если последняя возвращает адрес IPv6, он тоже должен вести на этот сервер, иначе выпуск сертификата может завершиться ошибкой.

Шаг 2: разрешите SSH-подключение Coolify

Coolify подключается к серверу по SSH под учётной записью root с отдельным ключом. Проверьте действующую настройку:

Терминал
sudo sshd -T | grep -i '^permitrootlogin'

Подходят значения prohibit-password, without-password и yes. Если вы получили no, разрешите вход для root только по ключу:

Терминал
echo 'PermitRootLogin prohibit-password' | sudo tee /etc/ssh/sshd_config.d/00-coolify.conf
sudo sshd -t
sudo systemctl reload ssh

Не закрывайте текущий сеанс и проверьте новое подключение, прежде чем его завершать.

Если вы следовали руководству Защитите ваш сервер, SSH слушает порт 2222. Замените 22 на 2222 в правилах UFW из этого руководства, а после установки Coolify укажите этот порт в Servers > localhost > General.

Шаг 3: привяжите порты к локальному адресу

Без этой меры панель управления была бы опубликована по HTTP на порту 8000, и первый посетитель смог бы создать на ней учётную запись администратора. Поэтому создайте файл настройки до установки. Coolify сохраняет его при обновлениях.

Перейдите в root:

Терминал
sudo -i
mkdir -p /data/coolify/source
nano /data/coolify/source/docker-compose.custom.yml

Вставьте это содержимое:

YAML
services:
  coolify:
    ports: !override
      - "127.0.0.1:${APP_PORT:-8000}:8080"
      - "127.0.0.1:${SOKETI_PORT:-6001}:6001"
      - "127.0.0.1:6002:6002"

Шаг 4: установите Coolify

Оставаясь под root, загрузите официальный скрипт, просмотрите его и запустите с выбранной версией:

Терминал
curl -fsSL https://cdn.coollabs.io/coolify/install.sh -o /root/coolify-install.sh
less /root/coolify-install.sh
bash /root/coolify-install.sh 4.7.5

Скрипт устанавливает необходимые пакеты, адаптирует конфигурацию Docker, создаёт /data/coolify, генерирует SSH-ключ Coolify и запускает его контейнеры. Он может перезапустить Docker: это ещё один повод начинать с нового сервера.

В конце он выводит адрес вида http://...:8000. Из Интернета он отвечать не будет, и именно этого мы добиваемся. Проверьте порты:

Терминал
docker ps --format 'table {{.Names}}\t{{.Status}}\t{{.Ports}}'

В строке coolify должно быть указано healthy, а порты должны начинаться с 127.0.0.1:.

Шаг 5: откройте SSH-туннель

В терминале на вашем компьютере откройте туннель к трём портам:

Терминал
ssh -N -L 8000:127.0.0.1:8000 -L 6001:127.0.0.1:6001 -L 6002:127.0.0.1:6002 ВАШ_ПОЛЬЗОВАТЕЛЬ@IP_ВАШЕГО_СЕРВЕРА

Команда остаётся активной и ничего не выводит. Не закрывайте этот терминал во время настройки. Трафик между вашим компьютером и сервером шифруется SSH.

Шаг 6: создайте учётную запись администратора

Откройте http://localhost:8000 и сразу создайте учётную запись, задав длинный уникальный пароль. Coolify принимает первую учётную запись только в течение 10 минут после запуска.

Затем следуйте указаниям мастера и выберите использование этого сервера (localhost). В Servers > localhost подключение должно быть подтверждено. Если это не так, обратитесь к разделу об устранении неполадок.

Сразу скопируйте ключ шифрования экземпляра в менеджер паролей:

Терминал
grep '^APP_KEY=' /data/coolify/source/.env

Шаг 7: запустите прокси

Откройте Servers > localhost > Proxy. Traefik — прокси по умолчанию.

В разделе Configuration удалите следующую строку, ненужную для этой схемы, и сохраните:

YAML
      - '8080:8080'

Затем нажмите Start Proxy или перезапустите прокси, если он уже работает. На сервере убедитесь, что он слушает порты:

Терминал
docker ps --filter name=coolify-proxy --format '{{.Names}} {{.Status}} {{.Ports}}'

Порты 80 и 443 должны отображаться на 0.0.0.0, а 8080 больше не должно быть в списке.

Шаг 8: опубликуйте панель управления по HTTPS

Откройте Settings > General. В поле URL введите:

Текст
https://coolify.ваш-домен.com

Оставьте Redirect HTTP to HTTPS включённым, затем нажмите Save changes. Через несколько мгновений откройте https://coolify.ваш-домен.com и проверьте сертификат:

Терминал
curl -I https://coolify.ваш-домен.com

Убедитесь, что данные обновляются в реальном времени и, если вы им пользуетесь, что работает веб-терминал. После этого можно закрыть туннель сочетанием Ctrl+C. Он остаётся вашим резервным способом доступа, если домен перестанет отвечать.

Шаг 9: защитите экземпляр

Настройка Расположение Рекомендуемое значение
Регистрация Settings > Advanced > Registration Registration disabled
Двухфакторная аутентификация Profile > Two-factor Authentication > Configure 2FA Включена, резервные коды хранятся отдельно
API Settings > Advanced > API access Disabled, если вы его не используете
Сервер MCP Settings > Advanced Отключён, если нет конкретной необходимости
Разрешённые адреса Settings > Advanced > Allowed IPs Ваши адреса, если вы включаете API
Команда Team Минимальная роль для каждого участника

С другого компьютера, без туннеля, проверьте, что доступно:

Терминал
nmap -Pn -p 22,80,443,6001,6002,8000,8080 IP_ВАШЕГО_СЕРВЕРА

Как open должны отображаться только 22, 80 и 443.

Шаг 10: разверните первое приложение

В этом примере используется готовый образ: не нужны ни репозиторий Git, ни сборка.

  1. Откройте Projects, создайте проект с именем demo и откройте его.
  2. Нажмите + New (или Create New Resource), затем выберите Docker Image.
  3. Введите образ nginx:1.30-alpine и продолжите.
  4. В поле Ports Exposes укажите 80.
  5. В разделе Domains нажмите Add domain, выберите https и введите app.ваш-домен.com.
  6. Нажмите Deploy и следите за журналами развёртывания.

Затем проверьте результат:

Терминал
curl -I https://app.ваш-домен.com

Ответ должен содержать код 200, а браузер должен показать приветственную страницу Nginx с действительным сертификатом.

Развёртывание из публичного репозитория Git

В проекте нажмите + New, выберите Public Repository, вставьте HTTPS-адрес репозитория и нажмите Check repository. Затем выберите Build pack, порт приложения и его домен и запустите Deploy.

По умолчанию сборка выполняется на этом сервере и может потреблять много ресурсов процессора и памяти.

Обновление Coolify

Обновление Coolify не затрагивает ни ваши приложения, ни систему, ни Docker. Перед запуском прочитайте примечания к выпуску, дождитесь завершения текущих развёртываний и создайте резервную копию.

Из панели управления

Откройте Settings > Updates, оставьте канал Stable и нажмите Upgrade now, когда появится новая версия. Настройка Automatic updates определяет, будет ли Coolify устанавливать новые версии самостоятельно. Отключите её, если предпочитаете сами контролировать сроки.

Из терминала

Выполните под root, указав нужную версию без v:

Терминал
curl -fsSL https://cdn.coollabs.io/coolify/upgrade.sh | bash -s 4.7.5

Не используйте install.sh для обычного обновления: он сбрасывает владельцев и права в /data/coolify. Файл docker-compose.custom.yml по-прежнему учитывается. Затем проверьте версию, отображаемую в панели управления, и при необходимости журналы /data/coolify/source/upgrade-*.log.

Резервное копирование и восстановление

Храните эти элементы за пределами сервера:

Элемент Расположение Зачем
База данных Coolify Резервная копия .dmp Проекты, настройки и зашифрованные секреты
Ключ APP_KEY и файл .env /data/coolify/source/.env Без этого ключа восстановленные секреты нечитаемы
SSH-ключи /data/coolify/ssh/keys/ Подключение к управляемым серверам
Настройка портов /data/coolify/source/docker-compose.custom.yml Сохраняет защиту портов
Данные приложений Тома и базы данных Не входят в резервную копию Coolify

Из панели управления

Откройте Settings > Backup, нажмите Configure backup, затем Back up now. Проверьте результат в разделе Executions и используйте Download, чтобы получить копию. Можно также добавить хранилище S3. Оставьте Backup before update включённым, чтобы получать резервную копию перед каждым обновлением, запущенным из интерфейса.

Из терминала

Под root:

Терминал
mkdir -p /data/backups
docker exec coolify-db pg_dump --format=custom --no-acl --no-owner --username=coolify coolify > "/data/backups/coolify-db-$(date +%F).dmp"
test -s "/data/backups/coolify-db-$(date +%F).dmp" && echo OK
tar czf "/data/backups/coolify-files-$(date +%F).tar.gz" -C /data/coolify source/.env source/docker-compose.custom.yml ssh/keys
chmod 600 /data/backups/*

Эти файлы содержат секреты: скопируйте их в зашифрованное хранилище.

Восстановление на том же сервере

Замените ГГГГ-ММ-ДД датой резервной копии. Текущая база данных будет заменена. Сначала убедитесь, что APP_KEY в /data/coolify/source/.env совпадает с сохранённым ключом, затем выполните под root:

Терминал
docker stop coolify coolify-redis
docker exec -i coolify-db pg_restore --clean --if-exists --exit-on-error --no-acl --no-owner --username=coolify --dbname=coolify < /data/backups/coolify-db-ГГГГ-ММ-ДД.dmp
curl -fsSL https://cdn.coollabs.io/coolify/install.sh -o /root/coolify-install.sh
bash /root/coolify-install.sh 4.7.5

Укажите версию, установленную на момент создания резервной копии. На новом сервере следуйте официальной процедуре восстановления, которая также охватывает SSH-ключи.

Если что-то пошло не так

Setup window closed

Истёк 10-минутный срок. Перезапустите Coolify и обновите страницу:

Терминал
docker restart coolify

Адрес с :8000 не отвечает

Из Интернета это нормально. Используйте туннель из шага 5 и откройте http://localhost:8000. Если туннель не работает, проверьте состояние контейнеров командой docker ps.

Данные в панели управления не обновляются

Соединение реального времени не устанавливается. При работе через туннель убедитесь, что в нём есть порты 6001 и 6002. При работе через домен убедитесь, что прокси запущен и никакой другой прокси не блокирует WebSocket.

Permission denied (publickey) при проверке сервера

Для root отсутствует ключ Coolify, либо root не может подключиться. Проверьте шаг 2. Установщик не сохраняет открытый ключ на диске: под root вычислите его заново из закрытого ключа и добавьте:

Терминал
ssh-keygen -y -f /data/coolify/ssh/keys/id.root@host.docker.internal | sed 's/$/ coolify/' >> /root/.ssh/authorized_keys

Если такого файла нет, выведите содержимое каталога командой ls /data/coolify/ssh/keys/ и используйте находящийся там ключ.

Сервер localhost недоступен или работает нестабильно

Coolify обращается к серверу из своей сети Docker. Его может блокировать правило ufw limit 22/tcp или ограничение SSH только вашим адресом. Замените ограничение командой sudo ufw allow 22/tcp или разрешите сеть Coolify:

Терминал
docker network inspect coolify --format '{{(index .IPAM.Config 0).Subnet}}'
sudo ufw allow from ПОДСЕТЬ to any port 22 proto tcp

Замените ПОДСЕТЬ выведенным значением.

Прокси не запускается: address already in use

Другая служба использует порт 80 или 443:

Терминал
sudo ss -ltnp | grep -E ':(80|443) '

Остановите и отключите эту службу, затем снова запустите прокси.

Прокси доступен только локально

Убедитесь, что /etc/docker/daemon.json не содержит "ip": "127.0.0.1" или host_binding_ipv4. Удалите эти ключи, перезапустите Docker, затем прокси.

Сертификат недействителен (TRAEFIK DEFAULT CERT)

Let's Encrypt не удалось проверить домен. Проверьте записи A и AAAA, а затем доступность порта 80 извне. Если домен работает через прокси Cloudflare, отключите его на время проверки или используйте проверку DNS. Если порт остаётся недоступным, хотя на сервере всё настроено верно, обратитесь в поддержку из вашего личного кабинета.

Ошибка 502 Bad Gateway

Прокси подключается к контейнеру, но не к приложению. Убедитесь, что Ports Exposes соответствует реальному порту приложения и что оно слушает 0.0.0.0, а не 127.0.0.1.

no available server

Traefik не находит ни одного работоспособного контейнера для этого домена. Проверьте состояние развёртывания, проверку работоспособности приложения и написание домена в Domains.

Порт 8000 остаётся доступным из Интернета

Файл настройки не применён. Проверьте его расположение и синтаксис, затем примените его под root:

Терминал
cd /data/coolify/source
docker compose --env-file .env -f docker-compose.yml -f docker-compose.prod.yml -f docker-compose.custom.yml config --quiet
docker compose --env-file .env -f docker-compose.yml -f docker-compose.prod.yml -f docker-compose.custom.yml up -d --remove-orphans

Сервер сильно замедляется во время развёртывания

Сборка потребляет ресурсы сервера. Разверните готовый образ, выполняйте сборку в другом месте (например, в вашей CI) или увеличьте ресурсы.

Invalid MAC после восстановления

Ключ APP_KEY не совпадает с ключом из резервной копии. Верните сохранённый ключ в /data/coolify/source/.env, затем снова запустите установщик с той же версией.

Ссылки