Типичные ошибки aaPanel/BaoTa: панель не открывается, 502/504, диск заполнен, забыт пароль

Самые частые проблемы aaPanel/BaoTa — панель не открывается, ошибки 502/504 на PHP-сайтах, заполненный диск и забытый пароль панели. В статье собраны команды для диагностики каждой из них в aaPanel/BaoTa Linux на Debian/Ubuntu и CentOS/Rocky/AlmaLinux. Почти всё выполняется по SSH; как подключиться, описано в инструкции «Вход по SSH».

Шаг 1: aaPanel не открывается — узнать правильный адрес панели

Новые версии панели при установке создают случайный порт и путь «входа безопасности» (security entry), поэтому адрес IP:8888 часто не работает. Подключитесь по SSH и выполните bt default или откройте меню командой bt и выберите 14 (информация о панели по умолчанию) — вы увидите полный URL, порт и учётную запись. Если служба панели не запущена, перезапустите её: bt restart.

# Show panel URL (with security entry), port and default account
bt default
# or open the menu and choose 14 (view panel default info)
bt

# Restart the panel service
bt restart

Шаг 2: Проверить порт панели, брандмауэр ОС и политики безопасности

Если адрес верный, но панель недоступна, чаще всего заблокирован порт. Узнайте, какой порт слушает панель, и откройте его в брандмауэре ОС (в примере 8888 — замените своим). Если перед сервером работает дополнительная сетевая защита или политика безопасности, разрешите порт и там. Также проверьте, не блокирует ли нестандартные порты ваша локальная сеть — попробуйте через мобильную точку доступа.

# Which port is the panel listening on?
cat /www/server/panel/data/port.pl
ss -lntp | grep -E "BT-Panel|python"

# Debian / Ubuntu (ufw)
ufw allow 8888/tcp && ufw status
# CentOS / Rocky / AlmaLinux (firewalld)
firewall-cmd --permanent --add-port=8888/tcp && firewall-cmd --reload

Шаг 3: Забыт пароль или логин aaPanel/BaoTa

Подключитесь по SSH, выполните bt и введите 5, чтобы сменить пароль панели, или 6 — чтобы сменить имя пользователя. Изменения вступают в силу сразу. Если забыт и нестандартный порт, пункт 8 позволяет задать новый порт панели (не забудьте открыть его в брандмауэре).

bt
# 5  -> change panel password
# 6  -> change panel username
# 8  -> change panel port

Шаг 4: Ошибка 502 Bad Gateway на PHP-сайте

502 означает, что Nginx не получил ответ от PHP-FPM: процесс упал, не запущен или исчерпаны рабочие процессы. Проверьте процессы и файл сокета, перезапустите нужную версию PHP и изучите журнал ошибок сайта и журнал PHP-FPM. Если часто встречается «server reached pm.max_children», увеличьте число процессов в настройках производительности PHP в панели, учитывая объём памяти.

# Is PHP-FPM running? (74 = PHP 7.4, adjust to your version)
ps aux | grep php-fpm | head
ls -l /tmp/php-cgi-74.sock
/etc/init.d/php-fpm-74 restart

# Read the logs
tail -n 50 /www/wwwlogs/example.com.error.log
tail -n 50 /www/server/php/74/var/log/php-fpm.log
tail -n 50 /www/server/php/74/var/log/slow.log

Шаг 5: Ошибка 504 Gateway Timeout на PHP-сайте

504 означает, что PHP-скрипт выполнялся дольше, чем Nginx готов ждать: большие импорты, парсеры, медленные SQL-запросы. Сначала найдите медленный код через slow.log и журнал медленных запросов MySQL. Если долгое выполнение действительно нужно, увеличьте таймауты FastCGI в конфигурации Nginx сайта и параметр max_execution_time в php.ini.

# Inside the site's Nginx config (location ~ \.php$ or server block)
fastcgi_connect_timeout 60s;
fastcgi_send_timeout    300s;
fastcgi_read_timeout    300s;

Шаг 6: Проверка конфигурации командой nginx -t

Если после правки конфигурации сайта, правил rewrite или SSL Nginx не запускается или все сайты недоступны, сначала проверьте синтаксис. nginx -t покажет файл и строку с ошибкой; исправьте её и выполните reload. Если порт 80/443 занят, найдите процесс через ss.

/www/server/nginx/sbin/nginx -t
/etc/init.d/nginx reload

# Debian / Ubuntu / CentOS: see what holds port 80/443
ss -lntp | grep -E ":80 |:443 "

Шаг 7: Диск заполнен — панель и сайты работают со сбоями

Заполненный диск вызывает цепочку сбоев: не входит в панель, останавливается MySQL, сайты выдают ошибки. Найдите самые большие каталоги командами ниже; обычно это журналы /www/wwwlogs, локальные бэкапы /www/backup и бинарные журналы MySQL. Открытые журналы очищайте через truncate, а не удаляйте. Проверьте и inode командой df -i (много мелких файлов или файлов сессий). Больше советов — в инструкции «Нехватка места на диске».

df -h
df -i
du -h --max-depth=1 /www 2>/dev/null | sort -h | tail -n 15
du -sh /www/wwwlogs /www/backup /www/server/data 2>/dev/null

# Empty (not delete) a huge log that is still open
truncate -s 0 /www/wwwlogs/example.com.log

# Purge old MySQL binary logs (run in mysql -uroot -p)
PURGE BINARY LOGS BEFORE NOW() - INTERVAL 3 DAY;

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

Команда bt выдаёт «command not found».

Используйте /etc/init.d/bt default или /etc/init.d/bt restart. Если и этого файла нет, файлы панели повреждены: сделайте резервную копию данных и восстановите или переустановите панель официальным скриптом.

После перезапуска PHP ошибка 502 быстро возвращается.

Скорее всего, не хватает памяти или задано слишком много процессов, и ядро их завершает. Проверьте free -m и записи OOM в dmesg, уменьшите число процессов или добавьте swap (см. инструкцию «Swap в Linux»), при необходимости увеличьте тариф.

Панель открывается, но пишет, что IP или домен не авторизованы.

Ранее были заданы разрешённые IP или привязка к домену. Выберите в меню bt пункт снятия ограничения по IP или привязки домена.

Если проблема не решена, создайте тикет — техподдержка IMIDC работает 24/7. Укажите IP сервера, версию ОС, выполненные команды и приложите скриншот ошибки, чтобы мы быстрее нашли причину.