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

MAATRIX

Webmail Roundcube на сервере обычно работает без проблем, но при неверной настройке даёт узнаваемые сбои: не подключается к IMAP при входе, ошибка соединения с базой, белый экран вместо интерфейса, письма не уходят через SMTP, установщик ругается на права. Ниже — разбор этих частых проблем с готовыми решениями. Для каждой сначала решение, потом причина — чтобы быстро вернуть веб-почту в строй. Большинство ошибок Roundcube — в подключении к почтовому серверу, PHP-модулях или правах на каталоги.

Не подключается к IMAP при входе

Roundcube открывается, но при попытке войти выдаёт Connection to storage server failed или Login failed. Пароль верный, а войти не получается — Roundcube не может достучаться до IMAP вашего почтового сервера. Проверьте несколько вещей. Первое — работает ли IMAP-сервер (обычно Dovecot):

sudo systemctl status dovecot
sudo ss -ltnp | grep -E '143|993'

Второе — верны ли параметры imap_host в конфиге Roundcube (config/config.inc.php). Если Roundcube и почта на одном сервере, хостом должен быть localhost. Частая ошибка — указать шифрование, которое сервер не поддерживает: для незашифрованного порта 143 хост localhost:143, для TLS — ssl://localhost:993. Несоответствие протокола и порта даёт отказ подключения. Третье — если IMAP работает, но логин отклоняется, проверьте сами учётные данные напрямую на почтовом сервере: возможно, проблема в аутентификации Dovecot, а не в Roundcube.

Ошибка соединения с базой данных

При открытии Roundcube или в установщике — Database connection failed или ошибка PDO. Roundcube не может подключиться к своей базе настроек. Проверьте параметры базы в конфиге и доступность самой базы. Убедитесь, что база создана, пользователь существует и пароль совпадает с тем, что указан в config.inc.php:

mysql -u roundcube -p roundcube

Если вход в базу этой командой не проходит, проблема в учётных данных или правах — пересоздайте пользователя и выдайте права на базу roundcube. Ещё частая причина — не установлен PHP-драйвер базы: для MariaDB нужен php-mysql, для PostgreSQL — php-pgsql. Без драйвера PHP не умеет работать с базой, и Roundcube падает. Проверьте установку модуля и перезапустите PHP-FPM. Также убедитесь, что схема базы загружена — если база пустая, примените SQL-файл из каталога SQL комплекта Roundcube.

Белый экран вместо интерфейса

Roundcube отдаёт пустую белую страницу без ошибок. Классический признак фатальной ошибки PHP, скрытой от вывода. Первым делом посмотрите лог ошибок PHP и nginx:

sudo tail -n 30 /var/log/php*-fpm.log
sudo tail -n 30 /var/log/nginx/error.log

Самые частые причины белого экрана — отсутствующий обязательный PHP-модуль (mbstring, intl, xml, zip) или нехватка прав на каталоги temp и logs. Установите недостающие модули и перезапустите PHP-FPM. Проверьте версию PHP: слишком старая или, наоборот, слишком новая относительно версии Roundcube может вызывать несовместимость — сверьтесь с требованиями вашей версии Roundcube. Ещё вариант — исчерпан лимит памяти PHP (memory_limit) на большой почте: поднимите его в конфиге PHP. Лог всегда называет конкретную причину, поэтому начинайте с него, а не с гадания.

Письма не отправляются через SMTP

Почта читается, но при отправке письма Roundcube выдаёт SMTP Error или письмо не уходит. Проблема в подключении Roundcube к SMTP почтового сервера. Проверьте параметр smtp_host в конфиге. Если почта на localhost, обычно это localhost:587 с STARTTLS или tls://localhost:587. Убедитесь, что Postfix слушает порт отправки (submission, 587) и принимает аутентификацию:

sudo ss -ltnp | grep -E '587|465'

Если порт 587 не слушается, включите submission в конфигурации Postfix (master.cf). Частая причина отказа — Roundcube пытается авторизоваться в SMTP, а Postfix не настроен на приём аутентифицированной отправки на этом порту. Настройте SASL-аутентификацию для submission. Ещё вариант — несоответствие шифрования: сервер ждёт STARTTLS, а Roundcube шлёт по обычному соединению или наоборот. Приведите протокол в конфиге Roundcube в соответствие с настройкой Postfix.

Установщик ругается на права temp и logs

При установке Roundcube мастер показывает предупреждения о том, что каталоги temp или logs недоступны на запись. Roundcube хранит там временные файлы и логи, и без прав на запись он работает некорректно — от белого экрана до потери настроек. Выдайте веб-серверу права на эти каталоги:

sudo chown -R www-data:www-data /var/www/roundcube/temp /var/www/roundcube/logs

Владельцем должен быть пользователь, под которым работает PHP-FPM (обычно www-data). Не раздавайте права 777 всему каталогу Roundcube ради «простоты» — это дыра в безопасности; достаточно дать запись только temp и logs нужному пользователю. После исправления прав перезагрузите страницу установщика — предупреждения исчезнут.

Не забыли удалить installer

Отдельно про безопасность, потому что это критично. После установки каталог installer необходимо удалить: оставленный доступным, он раскрывает посторонним параметры вашего сервера, настройки базы и подключения к почте. Это не «ошибка», которая себя проявит, — это уязвимость, которой воспользуются без предупреждения. Удалите каталог сразу после настройки:

sudo rm -rf /var/www/roundcube/installer

Заодно держите Roundcube и PHP обновлёнными: webmail — популярная цель атак, и уязвимости в устаревших версиях эксплуатируют массово. Общий подход к диагностике Roundcube прост и надёжен: почти всегда причина видна в одном из трёх логов. Лог PHP-FPM показывает фатальные ошибки приложения (белый экран, отсутствующие модули). Собственный лог Roundcube в каталоге logs пишет ошибки подключения к IMAP и SMTP с деталями. Лог nginx фиксирует проблемы уровня веб-сервера и прав доступа. Приучитесь при любом сбое сначала открыть нужный лог, а не перебирать настройки наугад — конкретное сообщение об ошибке экономит часы и сразу указывает, где именно порвалась цепочка от браузера до почтового сервера. Чтобы веб-почта работала стабильно, нужен надёжный сервер под ней. В MAATRIX можно арендовать VPS под почтовый сервер с webmail в России, США или Великобритании и оплатить картой РФ, по СБП, криптой или токеном MAAT — иностранная карта не требуется.

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