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)