オープンソース

一覧へ

3. RC-AttachFileSeparater運用方法

本章では、RC-AttachFileSeparaterの管理者向けの運用操作について説明します。操作対象は、大きく分けると「管理者用画面上の設定追加・変更」、「設定ファイルの変更」、「テンプレートファイルの変更」の3つです。

具体的な運用操作は次の通りです。
  • 添付ファイル分離を行う宛先を管理する
    • 宛先を追加する
    • 宛先を有効化/無効化する
    • 無効化状態の宛先を削除する
  • 添付ファイル分離処理を除外する宛先を管理する
    • 宛先を追加する
    • 宛先を有効化/無効化する
    • 無効化状態の宛先を削除する
  • 運用中の設定内容を変更する
    • 環境設定ファイルの内容を変更する
    • 共有リンク記載ファイルの内容を変更する
    • パスワード通知メールの内容を変更する

Note

本マニュアル内で使われている以下内容について、実際の運用中の環境とは異なる場合があります。

  • 管理者用画面の表示内容(項目名やヘルプテキストなど)
  • 共有リンク記載ファイル(ファイル名やファイル形式、内容など)
  • パスワード通知メール(件名や本文など)

3.1. 添付ファイル分離を行う宛先を管理する

添付ファイル付きメールを送信した際、該当の添付ファイルを分離したい宛先を設定することができます。Roundcube設定メニュー内の、RC-AttachFileSeparater管理者用画面にて管理します。管理者用画面の上半分が操作対象です。
_images/rcpt_display.png

3.1.1. 宛先を追加する

新たに添付ファイルを分離したい宛先を追加したい場合は、以下の情報を入力し、追加用ボタンをクリックします。
  • ドメインまたはメールアドレス
    • ドメインの場合は、「@」を除いた内容を入力してください。
  • パスワード
    • 以下の日付置換用文字列を利用することもできます。
      • %Y : 送信日の年(2026/03/01の場合、2026)
      • %m : 送信日の月(2026/03/01の場合、03)
      • %d : 送信日の日(2026/03/01の場合、01)
    • 未入力の場合は、ランダムパスワードを使用します。
  • 備考
    • 入力は自由です。
_images/rcpt_add.png

追加に成功した場合、下の登録済み宛先に表示されます。
_images/rcpt_add_success.png

なお、登録した宛先は、「メールアドレス」→「サブドメイン」→「ドメイン」の順に優先的に判定・処理されます。
例として、
と設定した場合、「user01@out.example.com」宛に添付ファイル付きメールを送信した際は、「user01@out.example.com」で設定したルールに沿って処理されます。
また、「user02@out.example.com」宛に添付ファイル付きメールを送信した際は、「out.example.com」で設定したルールに沿って処理されます。

3.1.2. 宛先を有効化/無効化する

登録されている宛先のうち、有効な状態になっているもののみ、判定・処理に使われます。実際に使う宛先については有効な状態にしておき、一時的に使わない宛先については無効な状態にしておくことができます。
なお、宛先を追加する にて追加した宛先は、追加時点ですでに有効な状態になっています。

有効・無効を切り替える場合は、対象の宛先の左にあるボタンをクリックし、その後保存用ボタンをクリックします。青色が有効で、灰色が無効です。
なお、複数の宛先をまとめて同時に有効・無効にすることができます。
_images/rcpt_valid_invalid.png

3.1.3. 無効化状態の宛先を削除する

不要になった宛先を削除したい場合は、宛先を有効化/無効化する に従って無効状態にした後、削除用ボタンをクリックします。一時的に無効にしている宛先も、一度有効な状態にしておかなければ同時に削除されてしまうため、十分に注意してください。
_images/rcpt_delete.png

3.2. 添付ファイル分離処理を除外する宛先を管理する

添付ファイル付きメールを送信した際、該当の添付ファイルを分離させない宛先を設定することができます。Roundcube設定メニュー内の、RC-AttachFileSeparater管理者用画面にて管理します。管理者用画面の下半分が操作対象です。
_images/exclude_display.png

なお、添付ファイル分離を行う宛先を管理する にて同じ宛先が設定されている場合でも、こちらの設定が優先されます。

3.2.1. 宛先を追加する

新たに添付ファイルを分離させない宛先を追加したい場合は、以下の情報を入力し、追加用ボタンをクリックします。
  • ドメインまたはメールアドレス
    • ドメインの場合は、「@」を除いた内容を入力してください。
  • 備考
    • 入力は自由です。
_images/exclude_add.png

追加に成功した場合、下の登録済み宛先に表示されます。
_images/exclude_add_success.png

3.2.2. 宛先を有効化/無効化する

登録されている宛先のうち、有効な状態になっているもののみ、判定・処理に使われます。実際に使う宛先については有効な状態にしておき、一時的に使わない宛先については無効な状態にしておくことができます。
なお、宛先を追加する にて追加した宛先は、追加時点ですでに有効な状態になっています。

有効・無効を切り替える場合は、対象の宛先の左にあるボタンをクリックし、その後保存用ボタンをクリックします。青色が有効で、灰色が無効です。
なお、複数の宛先をまとめて同時に有効・無効にすることができます。
_images/exclude_valid_invalid.png

3.2.3. 無効化状態の宛先を削除する

不要になった宛先を削除したい場合は、宛先を有効化/無効化する に従って無効状態にした後、削除用ボタンをクリックします。一時的に無効にしている宛先も、一度有効な状態にしておかなければ同時に削除されてしまうため、十分に注意してください。
_images/exclude_delete.png

3.3. 運用中の設定内容を変更する

3.3.1. 環境設定ファイルの内容を変更する

RC-AttachFileSeparaterの運用中、ランダムパスワードの長さや、パスワード通知メールの送信先などを変更したくなった場合は、環境設定ファイルの内容を編集します。設定変更できる項目については、環境設定ファイルを配置・編集する を参照してください。

設定変更した場合でも、Roundcube関連サービスの再起動は不要です。設定変更した内容は、次回のメール送信処理時に有効になります。

3.3.2. 共有リンク記載ファイルの内容を変更する

RC-AttachFileSeparaterの運用中、共有リンク記載ファイルの内容を変更したくなった場合は、共有リンク記載ファイル用テンプレートの内容を編集します。変更方法については、テンプレートを配置・編集する を参照してください。

変更した場合でも、Roundcube関連サービスの再起動は不要です。変更した内容は、次回のメール送信処理時に有効になります。

3.3.3. パスワード通知メールの内容を変更する

RC-AttachFileSeparaterの運用中、パスワード通知メールの内容を変更したくなった場合は、パスワード通知メール用テンプレートの内容を編集します。変更方法については、テンプレートを配置・編集する を参照してください。

変更した場合でも、Roundcube関連サービスの再起動は不要です。変更した内容は、次回のメール送信処理時に有効になります。

3.4. 問題発生時の対処法

RC-AttachFileSeparaterを有効にしてRoundcubeを運用している前提で、発生する可能性がある問題と、その対処法について説明します。

3.4.1. 管理者用画面(またはユーザ用画面)での宛先設定に失敗した

管理者用画面(またはユーザ用画面)にて宛先設定をした際、以下のようなエラーメッセージ表示がされ、設定の追加や変更などに失敗する場合があります。
_images/setting_error.png

表示される原因としては以下が考えられますので、表示されたメッセージをもとに原因を特定・解消し、再度設定を行ってください。
  • ドメインまたはメールアドレスの書式不正(形式が間違っている、使えない文字を使っているなど)
  • パスワードの書式不正(使えない文字を使っている、文字数上限を超過など)
  • 備考の文字数上限を超過

上記以外の原因でエラーとなっている場合は、サーバのログに別途メッセージが出力されます。ログの出力先は、環境設定ファイルを配置・編集する を参照のうえ、実際のサーバ設定を確認してください。

3.4.2. 管理者用画面が表示されない

以下のように、Roundcubeの設定メニュー内にRC-AttachFileSeparater用のメニューが表示されず、管理者用画面にアクセスできない場合、以下の原因が考えられます。
  • 環境設定ファイルの読み込みエラーが発生している(設定項目の不足、設定値が不正など)
  • メッセージ設定ファイルの読み込みエラーが発生している(設定項目の不足、設定値が不正など)
  • 共有リンク記載ファイル用テンプレートの読み込みエラーが発生している(指定したファイルが存在しない、ファイルサイズが10MB以上など)
  • パスワード通知メール用テンプレートの読み込みエラーが発生している(指定したファイルが存在しない、ファイルサイズが10MB以上など)
_images/no_display.png

サーバのログに出力されているメッセージをもとに、原因を特定・解消してください。ログの出力先は、環境設定ファイルを配置・編集する を参照のうえ、実際のサーバ設定を確認してください。

3.4.3. 添付ファイル付きメールの送信に失敗した

添付ファイル付きメールを送信した際、以下のようなエラーメッセージ表示がされ、送信に失敗する場合があります。
_images/sendmail_error.png

送信に失敗する原因としては以下が考えられますので、表示されたメッセージと、サーバのログに出力されているメッセージをもとに、原因を特定・解消してください。ログの出力先は、環境設定ファイルを配置・編集する を参照のうえ、実際のサーバ設定を確認してください。
  • 環境設定ファイル内のNextcloud連携設定が間違っている(URLや管理者ユーザ、パスワードなど)
  • 連携先のNextcloudとの疎通に問題があり、タイムアウトしている
  • 連携先のNextcloud上に送信者のアカウントが存在しない、または送信者のアカウントにメールアドレスが登録されていない
  • DBとの接続に失敗している

3.4.4. 添付ファイルを分離する宛先に添付ファイル付きメールを送ったが、分離されずそのまま届いた

原因としては以下が考えられます。
  • 管理者用画面(またはユーザ用画面)にて、該当の宛先を分離対象とする設定がされていない
  • 管理者用画面にて、該当の宛先が、分離しない宛先にも設定されている
  • 該当のメールに、環境設定ファイルにて「分離しないメールと判定するヘッダ情報」に設定しているContent-Typeがついている
設定内容を再度見直してください。
また、サーバのログにメッセージが出力されている場合もありますので、そちらも念のため確認してください。ログの出力先は、環境設定ファイルを配置・編集する を参照のうえ、実際のサーバ設定を確認してください。

3.4.5. 管理者用画面(またはユーザ用画面)で未設定の宛先に送ったメールの添付ファイルが分離されてしまう

原因としては以下が考えられます。
  • 管理者用画面(またはユーザ用画面)にて、該当の宛先を分離対象とする設定がされている
  • 環境設定ファイルにて、デフォルトで全ての宛先を分離対象とする設定が有効になっている
設定内容を再度見直してください。
一覧へ