インストールガイド · 1 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プラグイン機能

そして、Webメールサーバーの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;

赤い下線のテキストを自分の資格情報とパネルアドレスに置き換えてください。信頼できるSSL証明書がインストールされていない場合は、httpsを使用しているがsoap_validate_certをfalseに変更してください。

プラグインの有効化

プラグインを有効にするには、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は、ログインするユーザーに適したサーバーを自動的に選択します。Roundcubeと外部メールサーバー間のtls/ssl接続を有効にするために、ispconfig3_autoselect/config/config.inc.php.distの独自の設定ファイルを編集できます。

設定ファイルを保存した後、Webメール設定に「アカウント」という新しいタブが表示されます:

新しい設定タブ

これで完了です!

問題が発生した場合は、https://github.com/w2c/ispconfig3_roundcube/wiki/Troubleshooting—FAQのトラブルシューティングFAQを確認してください。

質問やコメントがある場合は、返信に残すか、フォーラム投稿を作成できます。

Share: X/Twitter LinkedIn

新しい投稿を受信箱で受け取る

スパムはありません。いつでも購読を解除できます。