VIRTUAL(8)                                                          VIRTUAL(8)



名前
       virtual - Postfix バーチャルドメインメール配送エージェント

書式
       virtual [generic Postfix daemon options]

解説
       virtual(8) 配送エージェントはバーチャルメールホスティングサービスのため
       に設計されました。元々は Postfix local(8) 配送エージェントに基づいて い
       ま す が 、このエージェントはアドレスのローカル部分をハードコードされた
       unix パスワードファイル検索する代わりに、完全な受信者アドレスのマップ検
       索で受信者を検索します。

       こ の配送エージェントはメールだけを配送します。メールの転送や移転通知な
       どは virtual_alias マップや同様の検索メカニズムを使って設定されなければ
       いけません。

メールボックスの場所
       mailbox  の場所は virtual_mailbox_base および virtual_mailbox_maps 設定
       パラメータにより制御されます (以下参照)。 virtual_mailbox_maps テーブル
       は 以下の「テーブル検索順序」に記述されるように、受信者アドレスによりイ
       ンデックス化されます。

       mailbox パス名は次のように構成されます:

         $virtual_mailbox_base/$virtual_mailbox_maps(recipient)

       ここで recipient は完全な受信者アドレスです。

UNIX MAILBOX 形式
       mailbox の場所が / で終わっていなければ、メッセージは UNIX mailbox 形式
       で 配送されます。この形式は複数のメッセージを一つのテキストファイルに保
       存します。

       virtual(8) 配送エージェントは "From sender time_stamp" エンベロープヘッ
       ダ、 エ ンベロープ受信者アドレスを持つ Delivered-To: メッセージヘッダ、
       Postfixに渡された受信者アドレスを持つ X-Original-To: ヘッダ、エンベロー
       プ 送 信 者アドレスを持つ Return-Path: メッセージヘッダをそれぞれのメッ
       セージの前に付け、> 文字を "From " 行の頭に加え、空行を付加します。

       mailboxは配送中は排他的アクセスのためにロックされます。問題が起こると、
       mailboxは元の長さに切り詰めようと試みます。

QMAIL MAILDIR 形式
       mailbox  の場所が / で終わっていると、メッセージは qmail maildir 形式で
       配送されます。この形式はファイルごとに一つのメッセージを保管します。

       virtual(8) 配送エージェントデーモンはエンベロープ受信者アドレスを 持 つ
       Delivered-To:  メッセージヘッダ、Postfix に渡された受信者アドレスを持つ
       X-Original-To: ヘッダおよびエンベロープ送信者アドレス を 持 つ  Return-
       Path: メッセージヘッダを前に加えます。

       定 義上、maildir 形式はメール配送や検索時にアプリケーションレベルのロッ
       クを必要としません。

MAILBOX の所有者
       Mailbox の所有者は virtual_uid_maps および virtual_gid_maps 検索テー ブ
       ル によって制御され、これらは完全な受信者アドレスでインデックス化されま
       す。それぞれのテーブルは数字のユーザおよびグループIDという文字列を提 供
       します。

       virtual_minimum_uid パラメータは virtual_uid_maps に指定できるユーザ ID
       の数値の下限を指定します。

テーブル検索順序
       通常、検索テーブルは postmap(1) コマンドの入力として与えられるテキス ト
       ファイルを指定します。その結果、すなわち dbm または db 形式でインデック
       ス化されたファイルが、高速に検索するために使われます。

       検索順序は以下の通りです。最初に検索に成功した時点で検索を止めます。

       o      受信者にオプションの拡張アドレスが付いていると、まず user+exten-
              sion@domain.tld アドレスが検索されます。

              Postfix  バージョン 2.1 以前では、オプションの拡張アドレスは常に
              無視されます。

       o      次に拡張アドレスのない user@domain.tld アドレスが検索されます。

       o      最後に、受信者の @domain が検索されます。

       テーブルが NIS や LDAP、SQL のような他の方法で提供されていても、通常 の
       インデックス化されたファイルと同様に検索されます。

       代 わりに、テーブルをパターンが正規表現で与えられた正規表現マップとして
       提供することもできます。その場合、完全な受信者アドレスだけが正規表現 マ
       ップに与えられます。

セキュリティ
       virtual(8) 配送エージェントはセキュリティに注意を払う必要はなく、それに
       より受信者ユーザ/グループ ID 情報を持つ検索テーブルは十分に保護さ れ ま
       す。このプログラムは chroot されて動くようには設計されていません。

       セキュリティホールを開いてしまうことになりかねないため、virtual(8) 配送
       エー ジェ ン トは正規表現検索テーブルで $1 などの正規表現置換を許しませ
       ん。

       virtual(8) 配送エージェントは proxymap(8) を使えという要求は静かに無 視
       します。その代わりテーブルを直接オープンします。 Postfixバージョン2.2よ
       り前では、virtual 配送エージェントは致命的エラーで終了します。

標準
       RFC 822 (ARPA インターネットテキストメッセージ)

診断
       受 信者のメールボックスがなかったり、受信者がディスククォータを越えてい
       ると、メールをバウンスします。それ以外の場合は全て、存在する受信者宛 の
       メールは遅延され、警告がログに記録されます。

       問 題と処理は syslogd(8) に記録されます。壊れたメッセージファイルは後で
       キューマネージャが corrupt キューに移動できるようにマークされます。

       notify_classes パラメータの設定により、postmaster はバウンスやその他 の
       トラブルの通知を受けます。

バグ
       この配送エージェントはEメールアドレスおよび検索テーブルのキーで拡張アド
       レスをサポートしますが、テーブル検索の結果には情報を展開しません。

       Postfix は複数の属性結果を返すことが可能な検索テーブルを持つべきです。3
       つのテーブルを維持する不便さを避けるためには、 LDAP や MYSQL データベー
       スを使ってください。

設定パラメータ
       virtual(8) プロセスは限られた短時間しか動かないため、main.cf への変更は
       自 動的に拾われます。この変更を早くしたければ "postfix reload" コマンド
       を使ってください。

       以下の文章はパラメータの概要のみを提供します。例を含 む 詳 細 は  post-
       conf(5) を参照してください。

メールボックス配送の制御
       virtual_mailbox_base (empty)
              virtual(8) 配送エージェントが $virtual_mailbox_maps テーブル検索
              からの結果の全てのパス名前に付けるプレフィックス。

       virtual_mailbox_maps (empty)
              $virtual_mailbox_domains にマッチするドメインの全ての有効なア ド
              レスを持つ、オプションの検索テーブル。

       virtual_minimum_uid (100)
              virtual(8) 配送エージェントが $virtual_uid_maps テーブル検索から
              の結果として受け付ける最小のユーザ ID の値。

       virtual_uid_maps (empty)
              virtual(8) 配送エージェントが受信者のメールボックスへの書き込 み
              に使用する受信者ごとのユーザ ID を持つ検索テーブル。

       virtual_gid_maps (empty)
              virtual(8)  メールボックス配送に使う受信者ごとのグループ ID を持
              つ検索テーブル。

       Postfix バージョン 2.0 以降で使えます:

       virtual_mailbox_domains ($virtual_mailbox_maps)
              Postfix は指定されたドメインのリストの最終配送先になります; メー
              ルは $virtual_transport メール配送transportで配送されます。

       virtual_transport (virtual)
              $virtual_mailbox_domains  パラメータ値にマッチするドメイン宛の、
              デフォルトのメール配送 transport。

ロックの制御
       virtual_mailbox_lock (see 'postconf -d' output)
              配送を試行する前に UNIX 形式の virtual(8) メールボックスをロック
              する方法。

       deliver_lock_attempts (20)
              メ ールボックスファイルや bounce(8) ログファイルの排他的ロックを
              獲得しようとする最大回数。

       deliver_lock_delay (1s)
              メールボックスファイルや bounce(8) ログファイルの排他的ロック を
              獲得しようとする時間間隔。

       stale_lock_time (500s)
              古いメールボックスの排他的ロックファイルが取り除かれるまでの時間
              。

リソースおよび速度の制御
       virtual_destination_concurrency_limit     ($default_destination_concur-
       rency_limit)
              virtual メッセージ配送 transport を使った同じ配送先への、最大 の
              並列配送数。

       virtual_destination_recipient_limit       ($default_destination_recipi-
       ent_limit)
              virtual  メッセージ配送 transport を使った配送ごとの、最大の受信
              者数。

       virtual_mailbox_limit (51200000)
              個々のメールボックスまたは maildir ファイルの、バイト単位の最 大
              サイズ、またはゼロ (制限なし)。

その他の制御
       config_directory ('postconf -d' の出力を参照)
              Postfix  main.cf および master.cf 設定ファイルのデフォルトの場所
              。

       daemon_timeout (18000s)
              ビルトイン監視タイマーによって終了するまでの、Postfix デーモンプ
              ロセスが要求を扱うことができる時間。

       ipc_timeout (3600s)
              内部通信チャネルを使った情報の送受信の時間制限。

       max_idle (100s)
              Postfix デーモンプロセスが終了するまでに次のサービス要求を待つ最
              大時間。

       max_use (100)
              Postfix デーモンプロセスが終了するまでの接続要求の最大数。

       process_id (read-only)
              Postfix コマンドまたはデーモンプロセスのプロセス ID。

       process_name (read-only)
              Postfix コマンドまたはデーモンプロセスのプロセス名。

       queue_directory ('postconf -d' の出力を参照)
              Postfix トップレベルキューディレクトリの場所。

       syslog_facility (mail)
              Postfix ロギングの syslog facility 名。

       syslog_name (postfix)
              例えば "smtpd" が "postfix/smtpd" となるようにするために  syslog
              レコードのプロセス名の前に付けられるメールシステムの名前。

関連項目
       qmgr(8), キューマネージャ
       bounce(8), 配送状態レポート
       postconf(5), 設定パラメータ
       syslogd(8), システムロギング

README ファイル
       VIRTUAL_README, ドメインホスティング howto

ライセンス
       The  Secure Mailer license はこのソフトウェアと一緒に配布されなければい
       けません。

歴史
       この配送エージェントはもともと Postfix local 配送エージェントに基づいて
       い ます。修正は主に適用できなかったりこの状況で安全でないものを取り除く
       ことからなっています: aliases, ~user/.forward ファイル、 "|command"  や
       /file/name への配送。

       Delivered-To: メッセージヘッダは Daniel Bernstein による qmail システム
       で現れました。

       maildir 構造は Daniel Bernstein による qmail システムで現れました。

作者
       Wietse Venema
       IBM T.J. Watson Research
       P.O. Box 704
       Yorktown Heights, NY 10598, USA

       Andrew McNamara
       andrewm@connect.com.au
       connect.com.au Pty. Ltd.
       Level 3, 213 Miller St
       North Sydney 2060, NSW, Australia



                                                                    VIRTUAL(8)