Установка · 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
Если у вас есть какие-либо вопросы или комментарии, вы можете оставить их в ответах или создать сообщение на форуме.
Get new posts in your inbox
No spam. Unsubscribe anytime.