Документация / Устранение неполадок

Устранение неполадок

Большинство проблем при настройке сводятся к DNS, облачному файрволу или блокировке исходящего порта 25. Вот как распознать и исправить каждую.

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

  • http://server-IP/ работает, а домен нет — DNS ещё не резолвится. Проверьте panel.yourdomain.com на dnschecker.org (тип A). Если пусто, значит, ваши DNS-записи или nameserver не заданы — см. Направьте свой домен.
  • У домена вообще нет nameserver — делегирование регистратора не опубликовано, или вы задали записи на DNS-хостинге, который не авторитетен. Проверьте NS на dnschecker.org (тип NS); если пусто или неверно, исправьте nameserver у регистратора или перейдите на Cloudflare.
  • Nameserver куда-то указывают, но всё равно не резолвится («REFUSED») — DNS-хостинг на деле не обслуживает зону. Активируйте там управление DNS или перенесите домен на Cloudflare (он всегда обслуживает зону после добавления).

HTTPS не активен (нет замочка)

HTTPS включается автоматически в течение ~5 минут, как только panel.yourdomain.com укажет на сервер. Если этого не произошло:

  • Убедитесь, что A-запись резолвится на правильный IP (dnschecker.org).
  • Убедитесь, что порты 80 и 443 открыты в вашем облачном файрволе.
  • Если вы используете Cloudflare, задайте запись panel как DNS only (серое облако), не проксированной.
  • Чтобы включить сейчас принудительно: подключитесь по SSH под root и выполните sudo nimbopanel-enable-https.

Клиенты не могут отправлять почту / исходящая почта отбивается или уходит в таймаут

Откройте System → Outgoing mail, прежде чем что-либо предполагать. Карточка измеряет, может ли этот сервер достучаться до интернета по порту 25, и говорит об этом прямо. Если она сообщает, что порт заблокирован, настройте релей из формы на той же карточке — см. Доставляемость и отправка почты. Работающий релей показывает status=sent в почтовом журнале.

Если карточка говорит, что порт 25 открыт, блокировка не ваша проблема, и причина в другом: проверьте сообщение об отбое у получателя и проверьте SPF/DKIM/DMARC ниже.

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

Сообщение не полностью аутентифицировано. Проверьте, что все три опубликованы и проходят для отправляющего домена:

  • SPF включает ваш релей (например, include:spf.brevo.com).
  • DKIM — домен верифицирован в вашем релее, и его записи DKIM есть в вашем DNS.
  • DMARC — существует запись v=DMARC1; p=none; … (Nimbopanel добавляет по одной на домен).

Входящая почта никогда не приходит

  • Убедитесь, что MX-запись домена указывает на mail.yourdomain.com и что mail.yourdomain.com резолвится на ваш сервер.
  • Убедитесь, что входящий порт 25 открыт в вашем облачном файрволе (входящий 25 почти никогда не блокируется — блокируется только исходящий).

Страница инструмента (веб-почта, phpMyAdmin) показывает ошибку или не загружается

  • phpMyAdmin возвращает 401 без сессии панели — это ожидаемо; откройте его изнутри панели (единый вход).
  • Ни одна плитка не появляется в панели клиента — они только для Debian/Ubuntu. На AlmaLinux, Rocky и RHEL панель скрывает обе, а не отправляет клиента на страницу, которой нет. Это по замыслу, а не сбой.
  • Веб-почта / сайт возвращает 502 — служба PHP могла перезапуститься. Проверьте службы через systemctl status. Если это сохраняется через мгновение, перезапустите апдейтер (sudo nimbopanel update), чтобы заново применить управляемую конфигурацию.

Проблемы с сайтом клиента

  • Правило в .htaccess ничего не делает. Сайт в переведённом режиме. Либо нажмите Translate now в Домены → Apache / .htaccess, либо включите полную поддержку .htaccess. Таблица на той странице перечисляет ровно то, какие директивы пропускаются. См. .htaccess — два режима.
  • Каждая страница возвращает 500 сразу после переключения на полную поддержку .htaccess. У Apache отсутствует модуль, нужный файлу — mod_rewrite обычный такой случай, и он выключен по умолчанию на Debian и Ubuntu. Перезапустите установщик (sudo nimbopanel update), который включает нужные модули; тем временем переключите аккаунт обратно.
  • Каждая страница возвращает 502 на аккаунте в полном режиме .htaccess, при этом другие сайты в порядке. Apache не запущен: systemctl status apache2 (Debian/Ubuntu) или httpd (семейство RHEL).
  • Сайт отдаёт 404 или показывает пустой каталог после смены корня документов. Папка публикуется в точности как введена и создаётся, если её нет, так что опечатка порождает пустую папку, а не ошибку. Прочитайте значение в строке домена и исправьте его. См. Публикация из папки, отличной от public_html.
  • Файл .env или конфигурации сайта можно скачать. Корень документов выше него. Переместите корень документов в папку public приложения; curl -sI https://domain/.env должен ответить 403.

Все сайты упали разом

Если все сайты остановились в один и тот же момент, обычно не запущен php-fpm. Проверьте через systemctl status php*-fpm. Если он отказывается запускаться с Address already in use, а ни одного живого процесса php-fpm нет, то устаревший файл сокета был оставлен процессом, который резко умер — текущие релизы Nimbopanel очищают их сами перед запуском.

Куда смотреть

  • Журналы панели + служб живут в journald systemd: journalctl -u nimbopanel -n 50.
  • Результаты доставки почты: journalctl -t postfix/smtp --since -10min (ищите status=sent / status=bounced).
  • Журнал установки находится в /var/log/nimbopanel-install.log.

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