ISPConfig 3 Roundcube プラグインの Debian 9 (Stretch) でのインストール

オペレーティングシステムバージョン: Debian 9.4 および 9.5 Stretch
Roundcube バージョン: 1.2.3+dfsg.1-4+deb9u1 および u2
ISPConfig 3 バージョン: 3.1.11 および 3.1.13

このハウツーは、マニュアルの ISPConfig3_roundcube インストール手順に基づいています。

前提条件

Debian 9 に付属する Roundcube バージョンを使用し、Perfect Server Guide for Debian Stretch の指示に従ってインストールします。

現在の ISPConfig を使用し、最新バージョンは 3.1.13 です。

ISPConfig リモートユーザーの追加

Roundcube 用の ISPConfig リモートユーザーを追加します。適切な名前を選択してください。私は rcmail-remote を使用します。良いパスワードを選択してください。私は通常 apg でパスワードを生成しますので、最初に apt-get install apg を実行します。

apg -m 12 -l M NCL

ISPConfig パネルでリモートユーザーを作成します。タブ System の下のユーザー管理に「Remote Users」があります。「Add new user」ボタンをクリックします。

私は Remote Access: にチェックを入れませんでした。私の設定では、メールファイルと Roundcube および Dovecot がインストールされた別のメールサーバーがあります。したがって、これは「リモートユーザー」ですが、私のケースではリモートアクセスは必要ありません。

このユーザーには次のものを選択します:

- サーバー機能
- クライアント機能
- メールユーザー機能
- メールエイリアス機能
- メールスパムフィルタユーザー機能
- メールスパムフィルタポリシー機能
- メールフェッチメール機能
- メールスパムフィルタホワイトリスト機能
- メールスパムフィルタブラックリスト機能
- メールユーザーフィルタ機能

そのリストは ISPConfig パネルに表示される項目の順序です。

ISPConfig RoundCube プラグインのインストール

Github から ISPConfig3-plugins を取得します。私は RoundCube 1.2.3 用の最新バージョンを使用しました。プラグインの著者はマニュアルで、Subversion から直接 RoundCube ルートディレクトリにチェックアウトするように書いています。私はシステムディレクトリを混乱させないために、他の場所にチェックアウトすることを好みます。

/usr/share/doc/roundcube の Readme.Debian では、「/var/lib/roundcube/plugins にプラグインを追加してください。」とアドバイスしています。私は svn から /root/ISPConfig3_plugins にチェックアウトし、そこから /var/lib/roundcube/plugins にコピーします。Debian パッケージからのプラグインは /usr/share/roundcube にインストールされており、そこから /var/lib/roundcube/plugins にシンボリックリンクがあります。コマンド svn を取得するには Subversion をインストールします。（apt-get install subversion）。

cd /root  
mkdir ISPConfig3_plugins  
cd ISPConfig3_plugins  
svn co https://github.com/w2c/ispconfig3_roundcube/trunk/ .

cd ispconfig3_account/config  
cp config.inc.php.dist config.inc.php

プラグインの設定

前のコマンド行の最後のコマンドでコピーしたファイルを編集します。ステップ 2 で作成したリモートユーザー情報を入力します。

cd /root/ISPConfig3_plugins

editor ispconfig3_account/config/config.inc.php

元のファイルは次のようになります:

remote_soap_user、remote_soap_pass（ステップ 2 で作成したユーザーとパスワード）および soap_url を変更します。ISPConfig パネルで https:// を使用している場合は、soap_url でも同じものを使用します。soap_url には IP アドレスまたはホスト名とドメインを使用できます。ポート番号は ISPConfig パネルと同じです。

プラグインの有効化

Roundcube 設定を編集し、ファイル /etc/roundcube/config.inc.php で「アクティブなプラグインのリスト」を検索します。Debian Stretch では、デフォルトでプラグインが有効になっていないため、リストは空です。リストが空である場合、つまり次のように見える場合:

// アクティブなプラグインのリスト (plugins/ ディレクトリ内) // Debian: まず roundcube-plugins をインストールして、何かを持つ $config['plugins'] = array( );

これを次のように置き換えます:

$config['plugins'] = array(
"jqueryui","ispconfig3_account", "ispconfig3_autoreply", 
"ispconfig3_autoselect", "ispconfig3_pass", "ispconfig3_spam", 
"ispconfig3_fetchmail", "ispconfig3_filter", 
"ispconfig3_forward", "ispconfig3_wblist"
);

プラグインの順序は重要です！何をしているかわからない限り、順序を変更しないでください。

もし非空であった場合、既存のプラグインの後に ISPConfig3 プラグインを追加します。不要なプラグインがある場合は、リストから削除すると、それはもはや有効ではありません。

もし一つのメールホストのみを使用している場合は、ispconfig3_autoselect プラグインを削除してください。なぜなら、その場合は必要なく、正しく設定しないと問題を引き起こすからです。

私は ispconfig3_forward を削除しました。なぜなら、/var/log/roundcube/errors のファイル ispconfig3_forward/ispconfig3_forward.php の 135 行目でエラーを見つけたからです。

プラグインをシステムの場所にコピー

今、チェックアウトディレクトリから /var/lib/roundcube にプラグインをコピーする必要があります。例えば、次のようにします:

cd /root/ISPConfig3_plugins  
for f in ispconfig3_* ; do echo $f ; cp --recursive $f /var/lib/roundcube/plugins/ ; done

テスト

新しいプラグインが設定に表示されますが、クリックすると「Soap Error: Not Found」または「Soap Error: Bad Request」というエラーメッセージが表示される場合は、soap_url 設定を確認してください。もしかしたら、末尾にスラッシュ文字「/」が欠けているかもしれません。

テストして楽しんでください。これらのプラグインによって作成された設定メニューに 5 番目の項目があります。

RoundCube アカウント

エラーが発生した場合は、https://github.com/w2c/ispconfig3_roundcube/wiki/Troubleshooting—FAQ の ISPConfig3 プラグイン著者によるトラブルシューティング FAQ をお読みください。それでも解決しない場合は、/var/log/roundcube/errors のログを確認してください。それでも問題が解決しない場合は、/var/log および /var/log/apache2 ディレクトリの他のログを確認してください。何も役に立たない場合は、Perfect Server Guide に従ってサーバーをインストールしたことを確認してください。VM イメージには php-soap がインストールされていないと聞いており、スクリプトによってインストールされた ISPConfig もこの PHP パッケージが不足しています。