Использование RoundCube Webmail с ISPConfig 3 на Debian Wheezy (Apache2)

Этот гид объясняет, как установить приложение RoundCube webmail на сервере Debian Wheezy с ISPConfig и Apache2, а также как включить плагины ISPConfig 3 для RoundCube, чтобы пользователи могли выполнять действия, такие как изменение паролей электронной почты из RoundCube. Roundcube webmail — это многопользовательский IMAP-клиент на основе браузера с интерфейсом, похожим на приложение; он включает функции, такие как поддержка MIME, адресная книга, манипуляции с папками, поиск сообщений и проверка орфографии.

Я не даю никаких гарантий, что это сработает для вас!

1 Предварительная заметка

Этот учебник предполагает, что вы используете Apache2 в качестве веб-сервера на вашем сервере ISPConfig 3; этот учебник не будет работать для nginx. Я собираюсь установить RoundCube из репозиториев Debian Wheezy — это относительно новая версия (0.7.2.9 против 0.9.1 (текущая стабильная версия)).

RoundCube будет настроен таким образом, чтобы к нему можно было получить доступ из каждого vhost по алиасу /webmail (например, http://www.example.com/webmail).

Если вы уже используете другое веб-приложение для почты, такое как SquirrelMail, убедитесь, что вы полностью отключили его или хотя бы алиас /webmail. Если вы установили SquirrelMail как пакет Debian, вы можете найти алиас в /etc/apache2/conf.d/squirrelmail.conf; либо закомментируйте алиас, чтобы просто отключить алиас /webmail, либо закомментируйте весь файл, чтобы полностью отключить SquirrelMail. Не забудьте перезапустить Apache после этого.

2 Создание удаленного пользователя в ISPConfig

Плагины ISPConfig 3 для RoundCube работают через удаленный API ISPConfig. Чтобы использовать этот API, нам нужен удаленный пользователь. Чтобы создать такого пользователя, перейдите в Система > Управление пользователями > Удаленные пользователи и нажмите кнопку Добавить нового пользователя:

Укажите имя пользователя и пароль для пользователя…

… и включите следующие функции:

Функции сервера
Функции клиента
Функции пользователя почты
Функции алиасов почты
Функции пользователя фильтра спама почты
Функции политики фильтра спама почты
Функции fetchmail почты
Функции белого списка фильтра спама почты
Функции черного списка фильтра спама почты
Функции фильтра пользователя почты

Затем нажмите Сохранить.

3 Установка RoundCube

Мы можем установить RoundCube следующим образом:

apt-get install roundcube roundcube-plugins roundcube-plugins-extra

Вы увидите следующие вопросы:

Настроить базу данных для roundcube с dbconfig-common? <– Да
Тип базы данных, который будет использоваться roundcube: <– mysql
Пароль административного пользователя базы данных: <– вашпарольrootmysql (пароль пользователя root MySQL)
Пароль приложения MySQL для roundcube: <– roundcubesqlpassword
Подтверждение пароля: <– roundcubesqlpassword

Это создаст базу данных MySQL с именем roundcube с пользователем MySQL roundcube и паролем roundcubesqlpassword.

Далее откройте /etc/apache2/conf.d/roundcube…

vi /etc/apache2/conf.d/roundcube

… и добавьте строку Alias /webmail /var/lib/roundcube. В дополнение к этому добавьте конфигурацию PHP в раздел (я выделил изменения):

| # Эти алиасы не работают должным образом с несколькими хостами на вашем сервере apache # Раскомментируйте их, чтобы использовать, или адаптируйте их к вашей конфигурации Alias /roundcube/program/js/tiny_mce/ /usr/share/tinymce/www/ Alias /roundcube /var/lib/roundcube Alias /webmail /var/lib/roundcube # Доступ к файлам tinymce Options Indexes MultiViews FollowSymLinks AllowOverride None Order allow,deny allow from all Options +FollowSymLinks DirectoryIndex index.php AddType application/x-httpd-php .php php_flag magic_quotes_gpc Off php_flag track_vars On php_flag register_globals Off php_value include_path .:/usr/share/php # Это необходимо для разбора /var/lib/roundcube/.htaccess. Смотрите его # содержимое перед установкой AllowOverride в None. AllowOverride All order allow,deny allow from all # Защита основных директорий: Options -FollowSymLinks AllowOverride None Options -FollowSymLinks AllowOverride None Order allow,deny Deny from all Options -FollowSymLinks AllowOverride None Order allow,deny Deny from all |

Перезапустите Apache после этого:

/etc/init.d/apache2 restart

4 Настройка RoundCube

Откройте /etc/roundcube/main.inc.php…

vi /etc/roundcube/main.inc.php

… и установите $rcmail_config[‘default_host’] = ‘localhost’; (или имя хоста или IP-адрес вашего почтового сервера, если он находится на удаленной машине):

| [...] $rcmail_config['default_host'] = 'localhost'; [...] |

В противном случае RoundCube будет запрашивать имя хоста перед каждым входом, что может перегрузить ваших пользователей — мы хотим сделать использование как можно проще.

Далее установите плагины ISPConfig 3 для RoundCube:

cd /tmp  
git clone https://github.com/w2c/ispconfig3_roundcube.git  
cd /tmp/ispconfig3_roundcube/  
mv ispconfig3_* /var/lib/roundcube/plugins  
cd /var/lib/roundcube/plugins  
mv ispconfig3_account/config/config.inc.php.dist ispconfig3_account/config/config.inc.php

Откройте ispconfig3_account/config/config.inc.php…

vi ispconfig3_account/config/config.inc.php

… и заполните данные для входа вашего удаленного пользователя ISPConfig и URL удаленного API — моя установка ISPConfig работает на https://192.168.0.100:8080, поэтому URL удаленного API — https://192.168.0.100:8080/remote/:

| |

Наконец, снова откройте /etc/roundcube/main.inc.php…

vi /etc/roundcube/main.inc.php

… и включите плагин jquerui плюс плагины ISPConfig 3…

| [...] // ---------------------------------- // ПЛАГИНЫ // ---------------------------------- // Список активных плагинов (в каталоге plugins/) //$rcmail_config['plugins'] = array(); $rcmail_config['plugins'] = array("jqueryui", "ispconfig3_account", "ispconfig3_autoreply", "ispconfig3_pass", "ispconfig3_spam", "ispconfig3_fetchmail", "ispconfig3_filter"); [...] |

… и измените тему с default на classic (в противном случае плагины ISPConfig 3 не будут работать):

| [...] // имя темы: папка из skins/ $rcmail_config['skin'] = 'classic'; [...] |

Вот и все; теперь вы можете получить доступ к RoundCube по алиасу /webmail (например, www.example.com/webmail). Войдите с адресом электронной почты и паролем учетной записи электронной почты, созданной через ISPConfig: