Установка · 2 min read · Oct 04, 2025

Установка ISPConfig 3 - плагины Roundcube на Debian 10

Плагины ispconfig3_roundcube интегрируют настройки вашей учетной записи электронной почты ISPConfig в Roundcube. В этом руководстве я проведу вас через процесс их установки.

Предварительные требования

  • Roundcube должен быть установлен с помощью apt. Если нет, вам может потребоваться изменить пути к файлам, используемым в этом руководстве.
  • Убедитесь, что ваша установка ISPConfig и Roundcube обновлена.

Добавление удаленного пользователя

Плагины ISPConfig 3 используют API для подключения к вашей системе. Поэтому нам нужно создать удаленного пользователя в панели управления.

Войдите в свою панель, перейдите в Система -> Удаленные пользователи и нажмите “Добавить нового удаленного пользователя”. В форме дайте вашему новому пользователю имя и пароль. Я буду использовать rc-example с паролем examplepass. Не используйте те же учетные данные, а создайте свои собственные. Моя панель будет находиться по адресу https://panel.example.com:8080 с действительным SSL сертификатом.

Включите следующую функцию для вашего удаленного пользователя:

  • Функции плагинов Roundcube

И включите удаленный доступ для IPv4 и IPv6 адреса вашего сервера веб-почты.

Загрузка плагинов

Выполните следующие команды:

cd /tmp  
wget https://github.com/w2c/ispconfig3_roundcube/archive/master.zip  
unzip master.zip  
cd ./ispconfig3_roundcube-master  
cp -r ./ispconfig3_* /usr/share/roundcube/plugins  
ln -s /usr/share/roundcube/plugins/ispconfig* /var/lib/roundcube/plugins/

Плагины теперь находятся в правильной папке, с символической ссылкой из /var/lib/roundcube/plugins. Следующий шаг - настроить их для использования нашего удаленного пользователя. Выполните это, чтобы скопировать пример конфигурации и отредактировать его:

cp /usr/share/roundcube/plugins/ispconfig3_account/config/config.inc.php.dist /usr/share/roundcube/plugins/ispconfig3_account/config/config.inc.php
nano /usr/share/roundcube/plugins/ispconfig3_account/config/config.inc.php

Вы увидите этот файл конфигурации:

$config['identity_limit'] = false;
$config['remote_soap_user'] = '{REMOTE USERNAME}';
$config['remote_soap_pass'] = '{REMOTE PASSWORD}';
$config['soap_url'] = 'https://{YOUR SERVER}:8080/remote/';
$config['soap_validate_cert'] = true;

Я изменю это на:

$config['identity_limit'] = false;
$config['remote_soap_user'] = 'rc-example';
$config['remote_soap_pass'] = 'examplepass';
$config['soap_url'] = 'https://panel.example.com:8080/remote/';
$config['soap_validate_cert'] = true;

Убедитесь, что вы заменили текст, подчеркнутый красным, на свои собственные учетные данные и адрес панели. Измените soap_validate_cert на false, если вы используете https, но не имеете установленного доверенного SSL сертификата.

Включение плагинов

Чтобы включить плагины, откройте конфигурацию roundcube:

nano /etc/roundcube/config.inc.php

И найдите эти строки:

// Список активных плагинов (в каталоге plugins/) $config['plugins'] = array();

Чтобы включить плагины, добавьте это между скобками:

"jqueryui", "ispconfig3_account", "ispconfig3_autoreply", "ispconfig3_pass", "ispconfig3_spam", "ispconfig3_fetchmail", "ispconfig3_filter", "ispconfig3_forward", "ispconfig3_wblist"

Строка будет выглядеть так:

// Список активных плагинов (в каталоге plugins/) $config['plugins'] = array("jqueryui", "ispconfig3_account", "ispconfig3_autoreply", "ispconfig3_pass", "ispconfig3_spam", "ispconfig3_fetchmail", "ispconfig3_filter", "ispconfig3_forward", "ispconfig3_wblist");

Несколько замечаний по этому поводу:

  • Плагин jqueryui должен быть размещен перед другими плагинами.
  • Если вы не хотите использовать плагин, например, плагин fetchmail, исключите ispconfig3_fetchmail.
  • Если вы используете более одного почтового сервера, добавьте ispconfig3_autoselect в список и оставьте $config['default_host'] пустым. ispconfig3_autoselect автоматически выберет правильный сервер для пользователя, который входит в систему. Вы можете отредактировать его собственный файл конфигурации, чтобы включить tls/ssl соединения между Roundcube и внешним почтовым сервером в ispconfig3_autoselect/config/config.inc.php.dist.

После сохранения файла конфигурации новая вкладка “Учетная запись” появится в настройках веб-почты:

Новая вкладка настроек

Мы закончили!

Если у вас возникли какие-либо проблемы, посмотрите раздел часто задаваемых вопросов по устранению неполадок на https://github.com/w2c/ispconfig3_roundcube/wiki/Troubleshooting—FAQ

Если у вас есть какие-либо вопросы или комментарии, вы можете оставить их в ответах или создать сообщение на форуме.

Share: X/Twitter LinkedIn

Get new posts in your inbox

No spam. Unsubscribe anytime.