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

MAATRIX

FastPanel работает стабильно, но на этапе установки и первой настройки нередко всплывают типовые ошибки: скрипт падает на середине, панель не открывается по адресу с портом 8888, не выпускается сертификат Let's Encrypt или не уходит почта. Практически все частые ошибки FastPanel сводятся к нескольким причинам — грязная система, закрытый порт, DNS или права — и лечатся набором понятных действий. Разберём их по порядку, начиная с самых распространённых. Перед разбором конкретных симптомов запомните, где искать причины. Логи установки и работы панели лежат в /var/log/, журнал самого FastPanel — в /var/log/fastpanel2/, ошибки веб-сервера — в /var/log/nginx/error.log и /var/log/apache2/error.log, почта — в /var/log/mail.log. Первый шаг при любой проблеме — заглянуть в соответствующий лог, а не гадать по симптому.

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

Самая частая причина сбоя установки — не чистая система. Если на сервере уже стоит Apache, Nginx, MySQL или другая панель, установщик FastPanel остановится из-за конфликта пакетов. Правильное решение — переустановить ОС начисто, без предустановленного веб-стека, и запустить скрипт заново. На VPS при заказе выбирайте голый образ Debian или Ubuntu без LAMP.

Вторая причина — обрыв SSH во время установки. Скрипт идёт несколько минут, и если соединение отвалится, процесс прервётся в неопределённом состоянии. Поэтому всегда запускайте установку в screen:

apt -y install screen
screen -S fastpanel
wget http://repo.fastpanel.direct/install_fastpanel.sh -O - | bash

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

Панель не открывается по адресу :8888

Вы поставили FastPanel, но https://IP:8888 не грузится. В 90% случаев виноват фаервол — порт 8888 закрыт. Проверьте, слушает ли панель порт и открыт ли он:

ss -tlnp | grep 8888

Если сервис слушает, но снаружи недоступен — дело в фаерволе на сервере или на стороне провайдера. Откройте порт во встроенном брандмауэре или через ufw:

ufw allow 8888/tcp

Если сервис вообще не слушает порт, панель не запущена. Проверьте и перезапустите её службу:

systemctl status fpanel
systemctl restart fpanel

Ещё одна причина — вы пытаетесь открыть по http:// вместо https://. Панель работает только по HTTPS, и в адресе обязателен https:// с портом 8888.

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

Пароль fastuser показывается один раз при установке, и его часто теряют. Ничего страшного — сбросить пароль администратора можно из консоли сервера по SSH служебной командой панели:

fastpanel users reset-password fastuser

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

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

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

dig +short vashdomen.ru

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

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

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

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

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

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

Убедитесь также, что PTR-запись (обратная запись IP на имя хоста) настроена — без неё крупные почтовые системы режут отправку.

Сайт отдаёт 502 или 504 Bad Gateway

Связка Nginx + Apache в FastPanel иногда выдаёт 502/504 Bad Gateway. Это значит, что фронтенд Nginx не смог достучаться до бэкенда (Apache или PHP-FPM). Частые причины: бэкенд-сервис упал, кончилась память, или PHP-скрипт выполняется дольше таймаута. Сначала проверьте, живы ли службы:

systemctl status apache2
systemctl status php*-fpm

Если сервис упал — перезапустите и загляните в его лог, там будет причина падения. Частая первопричина 502 после роста трафика — нехватка RAM: бэкенд убивает OOM-killer. Проверьте:

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

Ошибка 504 обычно означает превышение времени выполнения тяжёлого скрипта — увеличьте max_execution_time в настройках PHP сайта и таймауты проксирования. Но если убийства процессов регулярны, честнее добавить память: на VPS MAATRIX это делается без переустановки панели.

База данных недоступна и сайт не грузится

Ошибка «Error establishing a database connection» или отказ MariaDB чаще всего связаны с переполненным диском или упавшей службой БД. Первым делом проверьте свободное место — переполнение раздела / мгновенно роняет базы в режим только для чтения:

df -h
systemctl status mariadb

Если диск забит, почистите старые бэкапы и логи. Если MariaDB не стартует после аварийного выключения из-за повреждённых таблиц, посмотрите её лог в /var/log/mysql/ и при повреждении InnoDB используйте аварийный режим innodb_force_recovery для снятия дампа, после чего восстановите базу начисто. Регулярные повреждения баз — признак нестабильного диска или частых внезапных отключений, что на надёжном VPS редкость.

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