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

MAATRIX

BrainyCP удобен и бесплатен, но при установке и настройке всплывают повторяющиеся проблемы: панель не ставится на Ubuntu, веб-интерфейс не открывается, не выпускается SSL, почта уходит в спам, потерян пароль или сервер тормозит из-за нехватки памяти. Практически все частые ошибки BrainyCP объясняются несколькими типовыми причинами — неподходящая ОС, закрытый порт, DNS, права и ресурсы — и решаются понятными действиями. Разберём их по порядку, начиная с самой распространённой ошибки на этапе установки. Прежде чем чинить конкретный симптом, полезно знать, где искать причины. Логи веб-сервера лежат в стандартных путях /var/log/nginx/ и /var/log/httpd/, почтовые — в /var/log/maillog, база — в /var/log/mariadb/, системные события — в /var/log/messages. Сама панель также ведёт журнал работы. Правильная привычка — сначала открыть нужный лог и прочитать конкретное сообщение об ошибке, а уже потом искать решение по этому тексту, а не гадать по общему симптому. Это экономит массу времени и уберегает от бессмысленных действий наугад.

Панель не ставится (частая ошибка — Ubuntu)

Самая распространённая причина неудачной установки BrainyCP — попытка поставить её на неподдерживаемую систему. Панель работает только на RHEL-совместимых дистрибутивах: AlmaLinux 8/9, Rocky Linux, CentOS-семейство. На Debian и Ubuntu установщик не заработает. Если вы заказали VPS с Ubuntu, решение одно — переустановить ОС на AlmaLinux или Rocky Linux начисто.

Вторая причина сбоя — грязная система с уже установленным Apache, Nginx, MySQL или другой панелью: возникает конфликт пакетов. Здесь тоже помогает чистая переналивка ОС. И третья причина — обрыв SSH во время установки, которая идёт 15–30 минут. Всегда запускайте установщик в screen:

dnf -y install screen
screen -S brainycp

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

Панель не открывается в браузере

Установка прошла, но веб-интерфейс не грузится. Самая частая причина — закрытый порт панели в фаерволе. Уточните порт из вывода установщика и проверьте, слушает ли его панель:

ss -tlnp | grep LISTEN

Найдите в списке порт панели. Если сервис слушает, но снаружи недоступен, значит порт закрыт фаерволом на сервере или у провайдера. Откройте его через firewalld:

firewall-cmd --permanent --add-port=НОМЕР/tcp
firewall-cmd --reload

Если же порт не слушается вовсе, значит служба панели не запущена. Проверьте её статус и перезапустите через systemctl (имя сервиса подскажет документация панели). И убедитесь, что заходите по правильному протоколу и порту — ошибка в адресе часто выглядит как «панель не работает» на ровном месте.

Забыт пароль администратора

Пароль администратора выдаётся один раз при установке и легко теряется. Восстановить доступ можно из консоли сервера по SSH — панель предоставляет служебные средства сброса пароля администратора. Точную команду смотрите в документации BrainyCP для вашей версии; общий принцип тот же, что у других панелей: через SSH всегда есть путь восстановления.

Отсюда важное правило эксплуатации: всегда сохраняйте SSH-доступ к серверу как запасной вход. Если вы потеряете и пароль от панели, и SSH-доступ, останется только консоль провайдера (VNC/KVM) или полная переустановка. Поэтому сразу после установки настройте вход по SSH-ключу и сохраните ключ в надёжном месте — это ваша страховка от блокировки доступа.

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

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

dig +short vashdomen.ru

Адрес должен совпадать с IP сервера. Если домен недавно перенаправили, дайте DNS разойтись — это занимает от минут до нескольких часов. Второе условие: порт 80 открыт, домен доступен снаружи по HTTP, и нет редиректа, ломающего проверку каталога .well-known/acme-challenge/. Третье: вы не упёрлись в лимит Let's Encrypt после серии неудачных попыток — тогда просто подождите час и повторите. После исправления DNS выпуск обычно проходит со второй попытки.

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

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

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

Нет соединения — порт закрыт, наружу почта не уйдёт, нужен либо релей, либо открытие порта. На VPS MAATRIX 25-й порт доступен. Вторая беда — отсутствие DNS-записей аутентификации: если письма уходят, но попадают в спам, настройте SPF (v=spf1 a mx ~all), сгенерируйте DKIM в настройках почтового домена и добавьте его значение TXT-записью, пропишите DMARC и добейтесь корректной PTR-записи. Без этих записей крупные почтовые системы обоснованно считают отправителя ненадёжным и режут доставку.

Нехватка памяти и высокая нагрузка

Сервер тормозит, панель открывается медленно, сайты отваливаются — почти всегда виновата нехватка RAM. Полный стек панели (веб-сервер, PHP, база, почта, антиспам) на 1 ГБ памяти под реальной нагрузкой начинает свопить, а ядро убивает процессы. Посмотрите потребление и факты убийства процессов:

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

Проверьте также свободное место — переполнение диска мгновенно роняет базы в режим только для чтения, ломает выпуск SSL и запись логов, из-за чего «внезапно ломается всё сразу»:

df -h

Если диск забит, почистите старые бэкапы, ротацию логов и временные файлы. Частый пожиратель места — накопившиеся резервные копии, лежащие на том же сервере: перенастройте бэкап на выгрузку в удалённое хранилище, чтобы копии не забивали системный диск. Если же убийства процессов ядром регулярны, честный вывод — памяти мало. Практический минимум для боевого сервера с почтой — 2 ГБ и выше. На VPS MAATRIX память наращивается без переустановки панели, так что рост проекта не потребует всё переналивать.

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