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

MAATRIX

CyberPanel быстрый и удобный, но у него есть свой набор типичных граблей: установщик падает на неподходящей системе, панель не открывается на порту 8090, LiteSpeed отдаёт 500-ю ошибку, не выпускается SSL или почта уходит в спам. Почти все частые ошибки CyberPanel сводятся к нескольким причинам — неподходящая ОС, закрытый порт, DNS, права и нехватка памяти — и решаются понятными шагами. Разберём их по порядку, начиная с самого частого. Где искать причины: главный лог панели — /home/cyberpanel/error-logs.txt, логи веб-сервера OpenLiteSpeed — в /usr/local/lsws/logs/, там error.log и stderr.log, почта — в /var/log/maillog, база — в /var/log/mariadb/. Первым делом при любой проблеме открывайте соответствующий лог: OpenLiteSpeed и панель обычно пишут внятную причину сбоя, и решение находится по конкретному тексту, а не по общему симптому. Ещё одна общая рекомендация касается специфики CyberPanel: панель тесно завязана на OpenLiteSpeed, и многие привычные по Apache приёмы здесь работают иначе. Виртуальные хосты описываются в конфигурации LiteSpeed, а не в файлах sites-available, поэтому чинить сайт правкой конфига Apache бесполезно — его тут попросту нет. Держите это в голове: если гайд из интернета предлагает решение для Apache или Nginx, для CyberPanel его нужно переносить на язык OpenLiteSpeed, иначе вы будете править несуществующие файлы и удивляться отсутствию эффекта.

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

Чаще всего установщик CyberPanel останавливается по двум причинам. Первая — неподходящая или грязная система. CyberPanel официально работает на AlmaLinux 8/9, RockyLinux, CentOS-совместимых и Ubuntu 20.04/22.04, причём на чистой, без предустановленного веб-стека. Установка на неподдерживаемую версию ОС или поверх существующего Apache/Nginx обречена. Решение — переналить поддерживаемую ОС начисто.

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

dnf -y install screen
screen -S cyberpanel
sh <(curl https://cyberpanel.net/install.sh)

При разрыве соединения вернётесь через screen -r cyberpanel. Если установка оборвалась и повторный запуск ведёт себя странно, чище переустановить ОС и начать заново — долечивание частичной установки обычно занимает больше времени.

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

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

ss -tlnp | grep 8090

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

systemctl status lscpd
systemctl restart lscpd

Также убедитесь, что заходите по https://, а не по http. Ещё одна нередкая причина — конфликт с другим сервисом на 8090 или упавший после нехватки памяти процесс панели: проверьте free -m и логи OOM-killer.

Ошибка 500 или 503 от LiteSpeed

Сайт на CyberPanel отдаёт 500 Internal Server Error или 503 Service Unavailable. Причины у них разные. 503 обычно означает, что PHP-процесс (LSAPI) не смог запуститься или упал — смотрите /usr/local/lsws/logs/error.log, там будет причина: неверная версия PHP для сайта, нехватка памяти или ошибка в коде. Перезапуск веб-сервера часто снимает временный сбой:

systemctl restart lsws

Ошибка 500 чаще связана с правами доступа или .htaccess. Учтите, что OpenLiteSpeed поддерживает .htaccess ограниченно (полная поддержка — в платном LiteSpeed Enterprise), поэтому некоторые правила из Apache могут не работать и давать 500. Проверьте права: файлы 644, каталоги 755, владелец — пользователь сайта, а не root. Битые права после ручной загрузки файлов — частая причина отказа.

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

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

dig +short vashdomen.ru

Если адрес не совпадает с IP сервера или домен только что перенаправили — дайте DNS разойтись и повторите. Точную причину отказа ищите в логе панели:

tail -30 /home/cyberpanel/error-logs.txt

Частые формулировки: домен не резолвится на сервер, превышен лимит Let's Encrypt (после нескольких неудач — пауза на час), проверка .well-known не прошла из-за редиректа. После исправления DNS выпуск обычно проходит со второй попытки.

Почта не отправляется или в спаме

Как и на других панелях, две беды. Первая — закрытый исходящий порт 25:

telnet gmail-smtp-in.l.google.com 25

Нет соединения — порт закрыт, наружу почта не уйдёт. На VPS MAATRIX 25-й порт доступен. Вторая беда — отсутствие записей аутентификации. Если письма уходят, но попадают в спам, настройте SPF, сгенерируйте DKIM в разделе Email → DKIM Manager и добавьте его значение TXT-записью, пропишите DMARC и добейтесь корректной PTR-записи. Логи доставки смотрите так:

grep получатель@domen.ru /var/log/maillog

Если DKIM Manager не генерирует ключ или почта вообще не создаётся, проверьте, что при установке был включён Postfix — без него почтовый функционал недоступен, и его придётся доустанавливать.

Высокая нагрузка, MariaDB падает, «нет места»

Три частых симптома перегруза. Проверьте свободное место в первую очередь — переполнение диска роняет и базу, и выпуск SSL, и логи:

df -h

Если раздел забит, почистите старые бэкапы в /home/backup/ и логи LiteSpeed. Падение MariaDB после аварийного выключения лечится через её лог в /var/log/mariadb/; при повреждении InnoDB используют аварийный режим innodb_force_recovery для снятия дампа. Общая нехватка памяти проявляется тормозами и убийством процессов:

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

CyberPanel со всем стеком (LiteSpeed, MariaDB, PowerDNS, Redis, почта) на 1 ГБ RAM работает на пределе. Если OOM-killer срабатывает регулярно, вывод один — мало памяти. Практический минимум для боевого сервера — 2 ГБ и выше. На VPS MAATRIX память увеличивается без переустановки панели.

Отдельно стоит сказать про Redis и watchdog, которые CyberPanel предлагает включить при установке. Они полезны, но добавляют потребление памяти, поэтому на маленьком сервере оцените, нужны ли они вам. Если сайт один и трафик небольшой, часть тяжёлых сервисов можно отключить и высвободить ресурсы. Но универсальный совет прежний: не экономьте на памяти там, где от неё зависит стабильность боевого сайта — простой из-за нехватки RAM обходится дороже, чем чуть более старший тариф.

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