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

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

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

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

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

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

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
Пароль административного пользователя базы данных: <– yourrootsqlpassword (пароль пользователя root MySQL)
Пароль приложения MySQL для roundcube: <– roundcubesqlpassword
Подтверждение пароля: <– roundcubesqlpassword

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

Далее перейдите на ваш сайт в ISPConfig. На вкладке Опции вы увидите поле Директивы nginx:

Заполните следующие директивы и нажмите Сохранить (не имеет значения, включен ли у вас PHP для этого vhost или нет, потому что этот фрагмент кода использует стандартный PHP системы, который работает под пользователем и группой www-data, что важно, потому что RoundCube установлен вне корня документа vhost - в /var/lib/roundcube):

| client_max_body_size 100M; location /roundcube { root /var/lib/; index index.php index.html index.htm; location ~ (.+\.php)$ { try_files $uri =404; include /etc/nginx/fastcgi_params; # Для доступа к SquirrelMail должен использоваться пользователь по умолчанию (например, www-data на Debian/Ubuntu) #fastcgi_pass 127.0.0.1:9000; fastcgi_pass unix:/var/run/php5-fpm.sock; fastcgi_index index.php; fastcgi_intercept_errors on; fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; fastcgi_buffer_size 128k; fastcgi_buffers 256 4k; fastcgi_busy_buffers_size 256k; fastcgi_temp_file_write_size 256k; } location ~* /.svn/ { deny all; } location ~* /README|INSTALL|LICENSE|SQL|bin|CHANGELOG$ { deny all; } } location /webmail { rewrite ^ /roundcube last; } |

С этой конфигурацией RoundCube будет доступен по URL-адресам http://www.example.com/webmail и http://www.example.com/roundcube.

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_* /usr/share/roundcube/  
cd /usr/share/roundcube/  
mv ispconfig3_account/config/config.inc.php.dist ispconfig3_account/config/config.inc.php  
ln -s /usr/share/roundcube/ispconfig3_* /var/lib/roundcube/plugins/

Откройте 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: