モジュール ngx_mail_proxy_module
| ディレクティブ proxy_buffer proxy_pass_error_message proxy_protocol proxy_smtp_auth proxy_timeout xclient |
ディレクティブ
| 構文 |
proxy_buffer |
|---|---|
| 既定値 |
proxy_buffer 4k|8k; |
| コンテキスト |
mail、server |
プロキシに使用されるバッファのサイズを設定します。既定では、バッファサイズは 1 つのメモリページに等しくなります。プラットフォームによっては、4K または 8K になります。
| 構文 |
proxy_pass_error_message |
|---|---|
| 既定値 |
proxy_pass_error_message off; |
| コンテキスト |
mail、server |
バックエンドの認証中に取得したエラーメッセージをクライアントに渡すかどうかを示します。
通常、nginx での認証が成功した場合、バックエンドはエラーを返すことができません。それでもエラーが返される場合、何らかの内部エラーが発生したことを意味します。このような場合、バックエンドメッセージには、クライアントに表示されるべきではない情報が含まれる場合があります。ただし、正しいパスワードに対するエラーで応答することは、一部の POP3 サーバーの通常の動作です。たとえば、CommuniGatePro は、メールボックスのオーバーフロー やその他のイベントについてユーザーに通知するために、定期的に 認証エラー を出力します。この場合は、ディレクティブを有効にする必要があります。
| 構文 |
proxy_protocol |
|---|---|
| 既定値 |
proxy_protocol off; |
| コンテキスト |
mail、server |
このディレクティブは、バージョン 1.19.8 で導入されました。
バックエンドへの接続に対して PROXY プロトコル を有効にします。
| 構文 |
proxy_smtp_auth |
|---|---|
| 既定値 |
proxy_smtp_auth off; |
| コンテキスト |
mail、server |
このディレクティブは、バージョン 1.19.4 で導入されました。
AUTH コマンドを使用して、SMTP バックエンドでのユーザー認証を有効または無効にします。
XCLIENT も有効になっている場合は、XCLIENT コマンドは LOGIN パラメータを送信しません。
| 構文 |
proxy_timeout |
|---|---|
| 既定値 |
proxy_timeout 24h; |
| コンテキスト |
mail、server |
クライアントまたはプロキシされたサーバー接続における 2 つの連続した読み取りまたは書き込み操作間の タイムアウト を設定します。この時間内にデータが送信されない場合、接続は閉じられます。
| 構文 |
xclient |
|---|---|
| 既定値 |
xclient on; |
| コンテキスト |
mail、server |
SMTP バックエンドに接続するときにパラメータを含む XCLIENT コマンドを渡すことを有効または無効にします。
XCLIENT を使用すると、MTA はクライアント情報をログに書き込み、このデータに基づいてさまざまな制限を適用できます。
XCLIENT が有効になっている場合、nginx はバックエンドに接続するときに次のコマンドを渡します
-
サーバー名 を含む
EHLO -
XCLIENT -
クライアントが渡した
EHLOまたはHELO
クライアントの IP アドレスによって 検出された 名前が同じアドレスを指している場合、その名前は XCLIENT コマンドの NAME パラメータで渡されます。名前が検出できなかった、別のアドレスを指している、または レゾルバー が指定されていない場合、[UNAVAILABLE] が NAME パラメータで渡されます。解決プロセスでエラーが発生した場合は、値 [TEMPUNAVAIL] が使用されます。
XCLIENT が無効になっている場合、nginx はクライアントが EHLO を渡した場合はバックエンドに接続するときに サーバー名 を含む EHLO を通し、それ以外の場合はサーバー名を HELO で渡します。