Установка RoundCube 0.7 для ISPConfig 3 на Debian

Версия: 1.0
Автор: Mattias Nurmi (перевод и адаптация)
Последнее редактирование: 19.12.2011

Введение

Это руководство описывает установку стабильной версии RoundCube (0.7) и интеграцию с ISPConfig 3 на Debian Squeeze (Debian 6.0). Инструкция собрана из нескольких источников и адаптирована для удобства эксплуатации. Оно подходит для большинства похожих дистрибутивов, но некоторые команды или пути могут отличаться.

Важно: нет гарантии, что инструкция сработает в вашей среде — всегда тестируйте на стенде и делайте резервные копии.

Кому это надо и предварительные требования

Кому полезно: системным администраторам и инженерам, управляющим почтовыми серверами с ISPConfig.
Коротко о требованиях:

Рабочая система Debian Squeeze (или совместимая).
Установлены Apache, PHP, MySQL/MariaDB и почтовый сервер (Postfix/Dovecot и т. п.).
Права root или sudo.

Определения в одну строку:

RoundCube — веб-клиент для электронной почты на PHP.
ISPConfig — панель управления хостингом и почтой.

Содержание (основные шаги)

Удаление Squirrelmail (опционально)
Загрузка и распаковка RoundCube
Подготовка базы данных
Конфигурация через веб-инсталлятор
Добавление алиасов Apache
Финальные настройки и твики
Безопасность, отладка и чек-листы

1 Удаление Squirrelmail (опционально)

Если ранее был установлен Squirrelmail и вы хотите освободить /webmail, удалите его:

apt-get remove squirrelmail

Затем удалите конфигурацию Apache (если она есть):

rm /etc/apache2/conf.d/squirrelmail.conf

Примечание: если вы используете пакеты из репозиториев, убедитесь, что удаление не затронет другие зависимости.

2 Загрузка и распаковка RoundCube

Создаём папку для вебмаил и переходим в неё:

mkdir /var/www/webmail/
cd /var/www/

Скачиваем архив RoundCube 0.7 и распаковываем:

wget http://sourceforge.net/projects/roundcubemail/files/roundcubemail/0.7/roundcubemail-0.7.tar.gz
tar xfz roundcubemail-0.7.tar.gz
mv roundcubemail-0.7/* webmail
rm roundcubemail-0.7.tar.gz
rm -rf roundcubemail-0.7

Задаём владельца для временных директорий:

cd webmail
chown -R www-data:www-data temp/ logs/

Совет: если ваш веб-сервер работает от другой учётной записи (например, apache), замените www-data на неё.

3 Подготовка базы данных

Создаём базу данных и пользователя в MySQL/MariaDB (выполнить из клиентской программы mysql с привилегиями root):

CREATE DATABASE roundcubemail;
GRANT ALL PRIVILEGES ON roundcubemail.* TO roundcubeuser@localhost IDENTIFIED BY 'password';
FLUSH PRIVILEGES;

Замените roundcubemail, roundcubeuser и ‘password’ на свои имена и надёжный пароль.

Безопасность: используйте сложный пароль и по возможности ограничьте доступ по хосту.

4 Конфигурация RoundCube через веб-инсталлятор

Откройте в браузере:

http://адрес-вашего-сервера/webmail/installer/

Инсталлятор покажет проверку окружения. Если видите красные NOT OK — устраните указанные зависимости или включите нужные модули PHP (например, php-mysql, mbstring и др.).

Когда все проверки пройдены, нажмите НАЧАТЬ УСТАНОВКУ (START INSTALLATION). Затем переходите далее и в разделе Database Setup укажите параметры, которые вы создали на предыдущем шаге.

После заполнения формы нажмите СОЗДАТЬ КОНФИГ (CREATE CONFIG). Инсталлятор выдаст содержимое main.inc.php и db.inc.php — скопируйте их в /config:

# Пример: сохраните полученные тексты как файлы
vi /var/www/webmail/config/main.inc.php
vi /var/www/webmail/config/db.inc.php

Далее нажмите CONTINUE и на последнем шаге инициализируйте базу данных — «Initialize database» для создания таблиц.

Важно: после успешной установки обязательно удалите каталог инсталлятора:

rm -rf /var/www/webmail/installer

Если оставить installer — конфигурация и пароли могут быть скомпрометированы.

5 Добавление алиасов Apache

Чтобы пользователи могли открывать веб-почту по /webmail, отредактируйте (или создайте) файл:

vi /etc/apache2/conf.d/roundcube.conf

Пример содержимого (сохраните как есть; изменения ниже объяснены):

# RoundCube alias and redirect functions
Alias /webmail /var/www/webmail

  Options +FollowSymLinks
  # This is needed to parse /var/www/webmail/.htaccess. See its
  # content before setting AllowOverride to None.
  AllowOverride All
  order allow,deny
  allow from all

# Protecting basic directories:

        Options -FollowSymLinks
        AllowOverride None


        Options -FollowSymLinks
        AllowOverride None
        Order allow,deny
        Deny from all


        Options -FollowSymLinks
        AllowOverride None
        Order allow,deny
        Deny from all


  
    
      RewriteEngine on
      RewriteCond %{HTTPS} !^on$ [NC]
      RewriteRule . https://www.yourdomain.com:8080/webmail/  [L]

Пояснения:

Alias обеспечивает доступ по /webmail.
Защитные правила запрещают доступ к config, temp и logs.
Блок mod_rewrite принудительно перенаправляет на HTTPS/порт — замените https://www.yourdomain.com:8080 на свой домен и порт.

Если вы хотите доступ с любого домена без SSL, закомментируйте секцию mod_rewrite, но это снижает безопасность.

6 Финальные правки конфигурации

Откройте main.inc.php и измените рекомендованные параметры:

vi /var/www/webmail/config/main.inc.php

Найдите и измените (пример):

$rcmail_config['message_cache_lifetime'] = '30m';
$rcmail_config['default_host'] = 'localhost';
$rcmail_config['smtp_server'] = '%h';
$rcmail_config['session_lifetime'] = 30;
$rcmail_config['create_default_folders'] = TRUE;

Пояснения:

message_cache_lifetime = ‘30m’ — кэш писем 30 минут.
default_host = ‘localhost’ — подключение к локальному IMAP-серверу.
smtp_server = ‘%h’ — SMTP-сервер зависит от хоста пользователя.
session_lifetime = 30 — время жизни сессии в минутах.
create_default_folders = TRUE — создавать стандартные папки при первом входе.

После этого веб-интерфейс доступен по:

http://www.yourdomain.com/webmail

Замените адрес на ваш домен.

7 Безопасность и рекомендации по эксплуатации

Важно соблюдать базовые меры безопасности:

Удаляйте каталог installer сразу после установки.
Ограничьте доступ к каталогу config, logs и temp (уже настроено в конфиге Apache).
Работайте через HTTPS — используйте certbot/Let’s Encrypt для сертификата.
Регулярно обновляйте систему и PHP-модули; обновление RoundCube из официальных релизов.
Проверяйте права на файлы: webroot должен принадлежать процессу веб-сервера, но приватные файлы — с минимальными правами (600/640).

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

Частые проблемы и решения:

Ошибка подключения к БД — проверьте db.inc.php, пользователя и FLUSH PRIVILEGES; проверьте, что MySQL слушает на localhost.
Красные NOT OK в инсталляторе — установите отсутствующие модули PHP (php5-mysql, php5-mbstring и т. п.).
403 Forbidden при доступе к /webmail — проверьте директивы Allow/Order в конфигурации Apache и права на файлы.
Не отправляются письма — проверьте smtp_server, порт (25/587/465), а также настройки аутентификации и файервола.
После обновления PHP появляются ошибки — проверьте совместимость RoundCube 0.7 с версией PHP; при необходимости рассмотрите обновление RoundCube.

Логи для диагностики:

/var/log/apache2/error.log
/var/log/mail.log (или лог вашего MTA)
Каталог /var/www/webmail/logs

Альтернативные подходы и когда это не подходит

Альтернативы:

Установка RoundCube через пакетный менеджер (apt) — быстрее, но пакет может быть старее и без некоторых плагинов.
Использовать современную версию RoundCube (рекомендуется для новых систем) — API/конфиги отличаются.
Рассмотреть другие веб-клиенты (SOGo, RainLoop) если нужны расширенные фичи.

Когда инструкция не подойдёт:

Вы используете современный Debian/Ubuntu с другим набором пакетов — пути и пакеты могут отличаться.
Требуется поддержка крупных инсталляций и кластеров — нужен другой подход к хранению сессий и масштабированию.

Чек-лист для администратора (Role-based checklist)

Перед установкой:

Есть рабочая резервная копия сервера.
Установлены Apache, PHP, MySQL, MTA и IMAP-сервер.

После установки:

Installer удалён.
Конфигурационные файлы защищены (правильные права).
HTTPS настроен и действителен.
Тестовая отправка/приём писем успешна.
Мониторинг логов настроен.

Критерии приёмки

Система считается готовой, если:

Пользователь входит в веб-интерфейс по адресу /webmail.
Можно отправить и получить письмо (IMAP/SMTP работают корректно).
Нет сообщений об ошибке в инсталляторе и логах.
Каталог installer удалён и директории config/logs/temp недоступны через веб.

Контрольный список команд (шпаргалка)

Создать директорию и скачать:

mkdir /var/www/webmail/
cd /var/www/
wget http://sourceforge.net/projects/roundcubemail/files/roundcubemail/0.7/roundcubemail-0.7.tar.gz

Распаковать и установить права:

tar xfz roundcubemail-0.7.tar.gz
mv roundcubemail-0.7/* webmail
rm roundcubemail-0.7.tar.gz
rm -rf roundcubemail-0.7
cd webmail
chown -R www-data:www-data temp/ logs/

Удалить инсталлятор после настройки:

rm -rf /var/www/webmail/installer

Короткая методология обновления

Сделайте резервную копию webmail и БД.
Подготовьте тестовую среду с такой же версией PHP и компонентами.
Установите обновление на тесте, проверьте работу.
Выполните обновление на проде в окне технического обслуживания.

Подсказки по локализации и совместимости

RoundCube 0.7 — устаревшая версия; для современных дистрибутивов рекомендуется использовать более новую ветку.
Если сервер использует UTF-8, убедитесь, что БД и конфигурация соединения используют utf8_general_ci/utf8mb4 для корректного отображения символов.

Полезные ссылки

Официальный сайт RoundCube: http://www.roundcube.net/
HowToForge и Falko (The Perfect Server) — полезные руководства для Debian Squeeze и ISPConfig 3.

Заключение

Это руководство даёт пошаговую инструкцию для установки RoundCube 0.7 с интеграцией в ISPConfig 3 на Debian Squeeze. Оно включает основные команды, рекомендации по безопасности, чек-листы и разделы для устранения неполадок. Тестируйте изменения на стенде и регулярно обновляйте компоненты.

Короткая памятка: удалите installer, настройте HTTPS, защитите config/logs/temp и проверьте отправку/приём почты.

Специальная благодарность: Falko, Till, команде HowtoForge и всем, кто вносил вклад в оригинальные руководства.

Как установить RoundCube 0.7 для ISPConfig 3 на Debian Squeeze