Coolify: деплой успешен, но сайт возвращает 502 Bad Gateway

Coolify завершил деплой, контейнер запущен, рядом с приложением стоит Healthy, но по домену открывается 502 Bad Gateway. Повторный деплой ничего не меняет.

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

Ниже — порядок диагностики, который помогает найти место сбоя: в приложении, настройках Coolify, сети Docker или соединении с Cloudflare.

Почему Healthy не гарантирует, что сайт работает

Запрос пользователя обычно проходит такой путь:

Браузер → Cloudflare, если используется → прокси Coolify → контейнер приложения

HTTP-проверка, настроенная в Coolify, выполняется внутри контейнера приложения. Она может успешно получить ответ от http://localhost:3000/health, пока внешний запрос упирается в неверный порт или недоступный сетевой адрес.

Поэтому Healthy означает, что проходит конкретная проверка. Этот статус сам по себе не подтверждает работу DNS, HTTPS, прокси и всех страниц сайта.

С чего начать: посмотрите, когда появляется 502

Симптом Что проверить первым
Один сайт постоянно возвращает 502 после деплоя Фактический порт приложения, адрес прослушивания и маршрут к контейнеру.
Одновременно перестали открываться несколько приложений Общий прокси, состояние VPS и внешнюю сеть.
502 появляется при запуске, затем исчезает Время подготовки приложения и проверку его готовности принимать запросы.
Ошибка возникает под нагрузкой или во время сборки Память, перезапуски контейнеров и ошибки приложения в тот же момент.

Это направления проверки, а не готовый диагноз. Сначала сохраните логи и время ошибки: после перезапуска часть полезных данных может потеряться.

1. Откройте логи работающего приложения

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

Если проверяете через SSH, подключайтесь к серверу, на котором запущено приложение. Панель Coolify может находиться на другом VPS.

docker ps -a --format 'table {{.Names}}\t{{.Status}}\t{{.Ports}}'

Найдите контейнер нужного приложения. Во всех следующих командах замените APP_CONTAINER его настоящим именем:

docker logs --timestamps --since 10m --tail 150 APP_CONTAINER

Ищите фактический адрес и порт запуска, ошибки подключения к зависимостям, завершение процесса и повторяющиеся попытки старта. Состояния Restarting и Exited означают, что сначала нужно разобраться с самим приложением.

Для стандартного встроенного прокси Coolify проверьте также:

docker logs --timestamps --since 10m --tail 150 coolify-proxy

Сообщение connection refused указывает, что соединение с выбранным адресом и портом отклонено. Сверьте их с настройками приложения. Тайм-аут требует проверки доступности контейнера и его нагрузки. Отсутствие ошибок в выводе ещё не доказывает исправность маршрута: подробность журналирования зависит от настроек прокси.

2. Сверьте внутренний порт приложения с настройками Coolify

Допустим, приложение слушает порт 3000 внутри контейнера. Именно на него должен направлять запросы прокси.

Проверьте:

  • Какой порт указан в команде запуска и виден в логах.
  • Какой порт задан в Ports Exposes у обычного приложения.
  • Не переопределён ли целевой порт в настройках домена.
  • Для Docker Compose — к какому сервису привязан домен и какой порт слушает этот сервис.

В актуальном интерфейсе Coolify у домена есть отдельное поле Port. В версиях с единым полем Domains внутренний порт может задаваться записью вида https://app.example.com:3000. Это настройка маршрута Coolify: посетитель по-прежнему открывает https://app.example.com через стандартный HTTPS-порт 443.

Если в Compose указано 8080:3000, число 8080 обозначает порт сервера, а 3000 — порт контейнера. Для обычного маршрута через Docker-сеть прокси нужен внутренний порт 3000.

Инструкция EXPOSE 3000 в Dockerfile сама по себе не запускает веб-сервер и не заставляет приложение слушать этот порт. Проверяйте фактический процесс, затем сохраняйте настройки и выполняйте деплой изменённого приложения.

3. Проверьте, не слушает ли приложение только localhost

В стандартной контейнерной сети адрес 127.0.0.1 относится к самому контейнеру. Если приложение слушает только 127.0.0.1:3000, внутренняя проверка может проходить, но соседний контейнер прокси к нему не подключится.

Посмотрите слушающие TCP-порты:

docker exec APP_CONTAINER ss -lnt

Если в образе нет ss, используйте netstat -lnt, если он установлен, либо проверьте настройки и журнал запуска. Ошибка «команда не найдена» говорит об отсутствии диагностической утилиты, а не о неисправности приложения.

  • 127.0.0.1:3000 — приложение принимает соединения только внутри своего контейнера.
  • 0.0.0.0:3000 — приложение слушает все IPv4-интерфейсы контейнера.

Если обнаружена привязка только к localhost, задайте 0.0.0.0 способом, который поддерживает ваш сервер приложения. Простое добавление переменной HOST не поможет, если программа её не читает.

Например, для проекта Next.js, который запускается через next start, команда в настройках запуска может выглядеть так:

next start --hostname 0.0.0.0 --port 3000

Она предполагает, что production-сборка уже выполнена. Для standalone-образа или другого фреймворка сохраните соответствующий ему способ запуска. Изменение должно попасть в конфигурацию проекта и следующий деплой.

4. Проверьте общую сеть прокси и приложения

Правильного порта недостаточно: прокси должен иметь сетевой доступ к контейнеру.

docker inspect --format '{{json .NetworkSettings.Networks}}' APP_CONTAINER
docker inspect --format '{{json .NetworkSettings.Networks}}' coolify-proxy

В стандартной схеме Coolify у контейнера приложения и прокси должна быть общая Docker-сеть. Найдите совпадающее имя сети и адрес приложения в ней — поле IPAddress.

Для дополнительной проверки выполните с самого VPS запрос на этот адрес. Замените APP_IP, домен и порт своими значениями:

curl -sS --max-time 10 -D - -o /dev/null \
  -H 'Host: app.example.com' http://APP_IP:3000/

Команда подходит, если приложение принимает обычный HTTP внутри контейнера. HTTPS на публичном домене не означает, что между прокси и приложением тоже обязательно используется HTTPS.

  • Получен ожидаемый ответ приложения. Оно доступно с VPS. Дальше проверяйте выбранную прокси сеть, адрес, порт и протокол. Этот запрос ещё не проверяет соединение именно из контейнера прокси.
  • Соединение отклонено. Вернитесь к фактическому порту, адресу прослушивания и состоянию процесса.
  • Сам контейнер отвечает 502. Ошибку возвращает уже сервис внутри него. Если там работает ещё один прокси, проверяйте его соединение со следующим сервисом.

Для Docker Compose отдельная сеть проекта — нормальное поведение. Не нужно автоматически подключать все сервисы к сети coolify. В обычном режиме Coolify создаёт нужные подключения и маршруты; в режиме Raw Compose сетями и метками прокси управляете вы.

Если общей сети нет, проверьте конфигурацию Compose и режим развёртывания. Исправление сохраните в конфигурации: ручное подключение контейнера к сети может потеряться при его пересоздании. IP контейнера также не стоит закреплять в настройках — после деплоя он может измениться.

5. Убедитесь, что health check проверяет готовность сайта

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

Для HTTP-проверки используйте лёгкий служебный адрес, например /health, который возвращает успешный ответ после подготовки приложения. Он не должен требовать авторизации или изменять данные. Если приложение не может обслуживать запросы без базы данных, учитывайте доступность этой зависимости при проверке готовности.

Проверьте внутренний порт, путь и наличие curl либо wget в конечном образе. Для Compose проверка задаётся в описании сервиса или Dockerfile. В обычном Dockerfile-приложении уже существующий HEALTHCHECK может иметь приоритет перед настройками панели.

Если запуск занимает время, настройте подходящий start_period. Он даёт приложению время подготовиться, но не исправляет падение процесса. Отключение проверки тоже не восстанавливает доступность сайта.

6. Если используется Cloudflare, сравните два маршрута

Страница ошибки с логотипом Cloudflare не доказывает, что сломался именно Cloudflare: он может передавать ошибку вашего сервера.

С компьютера вне VPS проверьте обычное обращение к домену:

curl -sS --max-time 15 -D - -o /dev/null \
  https://app.example.com/

Затем обратитесь напрямую к публичному IP сервера, сохранив домен для HTTP-запроса и TLS. Замените 203.0.113.10 настоящим IP вашего VPS:

curl -sS --max-time 15 \
  --resolve app.example.com:443:203.0.113.10 \
  -D - -o /dev/null https://app.example.com/

Проверяйте один и тот же проблемный путь. Если ломается /api/orders, запрос к одной главной странице может не показать неисправность.

  • Напрямую получен ожидаемый ответ, через Cloudflare — 502. Проверяйте маршрут Cloudflare к серверу: адрес origin, правила, TLS и разрешённые источники соединений.
  • В обоих случаях 502. Продолжайте диагностику прокси и приложения на VPS.
  • Прямой запрос завершился ошибкой сертификата или тайм-аутом. Это не равнозначно HTTP 502. Сервер может принимать подключения только от Cloudflare или использовать Origin CA, которому обычный curl не доверяет.

Проверка рассчитана на схему с доступным origin по IP. При Cloudflare Tunnel маршрут другой: нужно проверять соединение cloudflared с приложением.

Также сверяйте DNS-записи A и AAAA. При отключённом CDN они должны вести на адреса нужного сервера. При включённом проксировании публичный DNS обычно показывает адреса Cloudflare.

7. Если ошибка возникает периодически, проверьте ресурсы

Когда 502 совпадает со сборкой, всплеском нагрузки или перезапуском приложения, проверьте, не завершается ли контейнер из-за нехватки памяти:

docker inspect --format 'OOMKilled={{.State.OOMKilled}} ExitCode={{.State.ExitCode}} Restarts={{.RestartCount}}' APP_CONTAINER
docker stats --no-stream
free -h
df -h

OOMKilled=true — признак завершения из-за нехватки доступной контейнеру памяти. Причиной может быть как заполненная память VPS, так и слишком низкий лимит самого контейнера. Один код завершения 137 без дополнительных данных ещё не доказывает OOM.

Сверяйте показатели со временем ошибки. Разовый вывод docker stats после сбоя не покажет уже прошедший пик. После пересоздания контейнера его прежняя статистика также может быть недоступна.

Если заполнен диск, сначала определите, что занимает место. Не запускайте очистку Docker с удалением volumes наугад: в них могут находиться базы данных и файлы пользователей.

В документации Coolify для самостоятельной установки указана базовая конфигурация: 2 ядра CPU, 2 ГБ RAM и 10 ГБ свободного места. Ресурсы приложений, базы данных, сборок и накопленных образов нужно учитывать дополнительно.

При подтверждённой нехватке ресурсов можно уменьшить потребление, пересмотреть лимиты контейнеров, вынести сборку или подобрать VPS мощнее. Для размещения проекта в Xhost24 доступны KVM VPS на NVMe. Выбирайте конфигурацию по составу сервисов и пиковому потреблению памяти. Увеличение RAM не исправляет ошибочный порт или привязку к localhost.

Как убедиться, что проблема устранена

  1. После исправления выполните деплой изменённого приложения и дождитесь завершения запуска.
  2. Откройте публичный HTTPS-домен и именно тот адрес, который возвращал 502.
  3. Проверьте обычное действие пользователя: загрузку страницы, вход или чтение данных через API.
  4. Сопоставьте результат с новыми логами приложения и прокси.
  5. Если ошибка возникала под нагрузкой, наблюдайте сервис в сопоставимых условиях. Одного успешного открытия страницы недостаточно.

Что приложить к обращению за помощью

Чтобы администратор мог начать диагностику, подготовьте:

  • Домен, проблемный URL и время ошибки с часовым поясом.
  • Версию Coolify, выбранный прокси и способ запуска: Dockerfile, Compose или другой.
  • Внутренний порт приложения и его настройки домена.
  • Логи приложения и прокси за время сбоя.
  • Результат прямого запроса к VPS и информацию об использовании Cloudflare.

Перед отправкой удалите из журналов пароли, токены и другие секреты. Полный файл .env для первого обращения не нужен.

Если нужна помощь с настройкой, в Xhost24 можно согласовать разовую задачу по администрированию. Опишите, что уже проверено и какой результат требуется: например, восстановить доступ к приложению по HTTPS-домену. Объём работ и стоимость согласуются до начала.

Частые вопросы

Почему по IP и порту сайт работает, а по домену — 502?

Прямое подключение может обходить прокси Coolify. Проверьте целевой порт домена и доступ прокси к контейнеру. Работа по опубликованному порту сервера не подтверждает исправность маршрута через прокси.

Нужно ли открывать порт 3000 в firewall?

Для обычного сайта за прокси Coolify посетители подключаются к портам 80 и 443. Прокси обращается к внутреннему порту приложения через Docker-сеть. Публиковать 3000 в интернет только ради исправления 502 обычно не требуется.

Поможет ли перезапуск всего VPS?

Он может временно убрать симптом, но одновременно прервёт работу остальных сервисов. Сначала сохраните логи и определите причину. Если изменились настройки одного приложения, применяйте изменения к нему.

502 и No available server — одна проблема?

Это разные симптомы. При использовании Traefik контейнеры с неуспешной проверкой состояния могут исключаться из маршрутизации. Если доступных контейнеров не осталось, появляется No available server или другой ответ. Проверять health check нужно, но приравнивать любой такой случай к 502 нельзя.

  • 0 Korisnici koji smatraju članak korisnim
Je li Vam ovaj odgovor pomogao?

Vezani članci

Установка PHP и MySQL на Debian

Типовая ситуация: вы взяли VPS, поставили Debian, но проект стоит, потому что непонятно с чего...

Установка wg-easy на VPS: WireGuard VPN с веб-панелью

wg-easy это самый быстрый способ поднять WireGuard VPN и управлять пользователями через...

Debian 12 to 13: апгрейд без сюрпризов

Debian 12 живёт годами, но в какой-то момент ты упираешься в банальные вещи: нужен свежее стек,...

ssh-keygen RSA на практике

Пароль для SSH это вечная лотерея. Его можно подобрать, украсть, забыть, слить в логах или...

Установка Docker на Ubuntu 24.04

Docker на Ubuntu 24.04 ставят по двум причинам. Первая — быстро поднять сервисы без ручной...