CloudPanel на сервере: частые ошибки и решения

MAATRIX

CloudPanel стабилен и быстр, но при установке и эксплуатации всплывают типовые проблемы: установщик падает на неподходящей системе, панель не открывается на порту 8443, Nginx отдаёт 502, не выпускается SSL или сайт видит IP Cloudflare вместо реальных посетителей. Большинство частых ошибок CloudPanel объясняются несколькими причинами — грязная или неподдерживаемая ОС, закрытый порт, упавший PHP-FPM, DNS — и решаются понятными действиями. Разберём их по порядку, начиная с самых частых. Где искать причины. Логи Nginx лежат в /home/имя-сайта/logs/ и в /var/log/nginx/, логи PHP-FPM — в /var/log/php/, журнал установки CloudPanel остаётся в выводе скрипта, системные события — в /var/log/syslog. CloudPanel построен на Nginx + PHP-FPM, поэтому большинство проблем сайтов диагностируются через эти два сервиса. Первый шаг при любой ошибке — открыть соответствующий лог и прочитать конкретное сообщение, а не гадать по внешнему симптому. Полезно держать в голове архитектуру CloudPanel: запрос посетителя приходит на Nginx, тот отдаёт статику сам, а динамику (PHP) передаёт нужной версии PHP-FPM, которая, в свою очередь, обращается к базе данных. Почти любая ошибка сайта укладывается в эту цепочку: проблема либо на уровне Nginx (конфиг, SSL, проксирование), либо на уровне PHP-FPM (упал пул, не та версия PHP, нехватка памяти), либо на уровне базы (недоступна, переполнен диск). Определив, на каком звене рвётся цепочка, вы сразу сужаете круг поиска и не тратите время на проверку исправных компонентов.

Установка падает или не запускается

Первая причина — неподходящая или грязная система. CloudPanel официально поддерживает Debian 11/12 и Ubuntu 22.04/24.04, причём чистые, без предустановленного веб-стека и другой панели. Попытка установить на неподдерживаемую версию ОС или поверх существующего Apache/Nginx приводит к остановке установщика. Решение — переналить поддерживаемую ОС начисто.

Вторая причина — обрыв SSH во время установки. Запускайте установщик в screen, чтобы разрыв соединения не прервал процесс:

apt -y install screen
screen -S cloudpanel

Внутри screen запустите скрипт установки. Если установка уже оборвалась и повторный запуск ведёт себя непредсказуемо, самый надёжный путь — переустановить ОС и начать заново. И обязательно сверяйте контрольную сумму скачанного установочного скрипта перед запуском — это защищает от подмены при загрузке из сети.

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

Установка прошла, но https://IP:8443 не открывается. Самая частая причина — закрытый порт 8443 в фаерволе. Проверьте, слушает ли панель порт:

ss -tlnp | grep 8443

Если сервис слушает, но снаружи недоступен, откройте порт. CloudPanel управляет UFW из интерфейса, но при закрытом доступе правило придётся добавить из консоли:

ufw allow 8443/tcp

Если сервис не слушает порт вовсе, значит служба панели не запущена. CloudPanel работает через Nginx, обслуживающий и панель; проверьте статус и перезапустите:

systemctl status nginx
systemctl restart nginx

И помните про два момента: заходить нужно строго по https:// и именно на порт 8443 (не 8080). Ошибка в порту — частая причина «панель не открывается» на пустом месте.

Сайт отдаёт 502 Bad Gateway

Ошибка 502 в связке CloudPanel означает, что Nginx не смог достучаться до PHP-FPM. Причин несколько. Первая — упал или не запущен процесс PHP-FPM нужной версии. CloudPanel держит несколько версий PHP, и у каждого сайта своя; проверьте статус нужной версии:

systemctl status php8.3-fpm

Если сервис упал — перезапустите и загляните в его лог, там будет причина падения (часто нехватка памяти или фатальная ошибка в коде). Вторая причина — сайту назначена версия PHP, чей FPM-пул не сконфигурирован или отключён; проверьте настройку версии PHP в карточке сайта. Третья, коварная причина 502 после роста трафика — нехватка памяти, и PHP-FPM убивает OOM-killer:

free -m
grep -i 'killed process' /var/log/syslog

Если убийства процессов регулярны, добавьте RAM — на VPS MAATRIX это делается без переустановки.

Не выпускается SSL Let's Encrypt

Ошибка выпуска сертификата. Let's Encrypt проверяет домен по HTTP, поэтому нужны условия: A-запись указывает на этот сервер, порт 80 открыт, нет мешающего редиректа. Проверьте резолвинг:

dig +short vashdomen.ru

Если адрес не совпадает с IP сервера или домен недавно перенаправили — дайте DNS разойтись и повторите. Частая специфическая для CloudPanel причина — сайт стоит за Cloudflare в режиме прокси (оранжевое облако), и валидация Let's Encrypt не проходит напрямую. На время выпуска сертификата переведите запись Cloudflare в режим DNS-only (серое облако), выпустите сертификат, затем при желании верните прокси. Либо используйте Cloudflare Origin-сертификат.

Сайт видит IP Cloudflare вместо посетителей

Частый вопрос: в логах и в приложении вместо реальных IP посетителей отображаются адреса Cloudflare. Это не ошибка, а следствие проксирования: запросы идут через серверы Cloudflare. Чтобы восстановить реальные IP, нужно настроить Nginx на доверие заголовку CF-Connecting-IP. В CloudPanel в настройках сайта есть опция для работы за реверс-прокси/CDN — включите её, и панель добавит нужную конфигурацию real_ip в Nginx. После этого и логи, и приложение (например, защита от брутфорса в WordPress) снова увидят настоящие адреса.

Без этой настройки все посетители выглядят как небольшой набор IP Cloudflare, что ломает геолокацию, аналитику и блокировки по адресу. Поэтому при работе за любым CDN или прокси обязательно включайте передачу реального IP.

База данных и нехватка ресурсов

Ошибка подключения к базе или отказ MariaDB чаще всего связаны с переполненным диском или упавшим сервисом. Первым делом проверьте место — переполнение раздела мгновенно роняет базу в режим только для чтения:

df -h
systemctl status mariadb

Если диск забит, почистите старые бэкапы и логи. Падение MariaDB после аварийного выключения диагностируется через её лог; при повреждении InnoDB применяют аварийный режим innodb_force_recovery для снятия дампа с последующим восстановлением базы. Общая нехватка памяти проявляется тормозами панели и сайтов. CloudPanel экономен, но база и трафик со временем упираются в ресурсы — тогда честный вывод прежний: нужен тариф повыше. На VPS MAATRIX память и CPU увеличиваются без переустановки панели.

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