モジュール ngx_mail_proxy_module

ディレクティブ
     proxy_buffer
     proxy_pass_error_message
     proxy_protocol
     proxy_smtp_auth
     proxy_timeout
     xclient

ディレクティブ

構文 proxy_buffer サイズ;
既定値
proxy_buffer 4k|8k;
コンテキスト mailserver

プロキシに使用されるバッファのサイズを設定します。既定では、バッファサイズは 1 つのメモリページに等しくなります。プラットフォームによっては、4K または 8K になります。

構文 proxy_pass_error_message オン | オフ;
既定値
proxy_pass_error_message off;
コンテキスト mailserver

バックエンドの認証中に取得したエラーメッセージをクライアントに渡すかどうかを示します。

通常、nginx での認証が成功した場合、バックエンドはエラーを返すことができません。それでもエラーが返される場合、何らかの内部エラーが発生したことを意味します。このような場合、バックエンドメッセージには、クライアントに表示されるべきではない情報が含まれる場合があります。ただし、正しいパスワードに対するエラーで応答することは、一部の POP3 サーバーの通常の動作です。たとえば、CommuniGatePro は、メールボックスのオーバーフロー やその他のイベントについてユーザーに通知するために、定期的に 認証エラー を出力します。この場合は、ディレクティブを有効にする必要があります。

構文 proxy_protocol オン | オフ;
既定値
proxy_protocol off;
コンテキスト mailserver

このディレクティブは、バージョン 1.19.8 で導入されました。

バックエンドへの接続に対して PROXY プロトコル を有効にします。

構文 proxy_smtp_auth オン | オフ;
既定値
proxy_smtp_auth off;
コンテキスト mailserver

このディレクティブは、バージョン 1.19.4 で導入されました。

AUTH コマンドを使用して、SMTP バックエンドでのユーザー認証を有効または無効にします。

XCLIENT も有効になっている場合は、XCLIENT コマンドは LOGIN パラメータを送信しません。

構文 proxy_timeout タイムアウト;
既定値
proxy_timeout 24h;
コンテキスト mailserver

クライアントまたはプロキシされたサーバー接続における 2 つの連続した読み取りまたは書き込み操作間の タイムアウト を設定します。この時間内にデータが送信されない場合、接続は閉じられます。

構文 xclient オン | オフ;
既定値
xclient on;
コンテキスト mailserver

SMTP バックエンドに接続するときにパラメータを含む XCLIENT コマンドを渡すことを有効または無効にします。

XCLIENT を使用すると、MTA はクライアント情報をログに書き込み、このデータに基づいてさまざまな制限を適用できます。

XCLIENT が有効になっている場合、nginx はバックエンドに接続するときに次のコマンドを渡します

クライアントの IP アドレスによって 検出された 名前が同じアドレスを指している場合、その名前は XCLIENT コマンドの NAME パラメータで渡されます。名前が検出できなかった、別のアドレスを指している、または レゾルバー が指定されていない場合、[UNAVAILABLE]NAME パラメータで渡されます。解決プロセスでエラーが発生した場合は、値 [TEMPUNAVAIL] が使用されます。

XCLIENT が無効になっている場合、nginx はクライアントが EHLO を渡した場合はバックエンドに接続するときに サーバー名 を含む EHLO を通し、それ以外の場合はサーバー名を HELO で渡します。