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 |
设置用于代理的缓冲区大小。默认情况下,缓冲区大小等于一个内存页的大小。根据平台不同,可能是 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 protocol。
语法 |
proxy_smtp_auth |
---|---|
默认值 |
proxy_smtp_auth off; |
上下文 |
mail , server |
此指令出现在 1.19.4 版本中。
使用 AUTH
命令启用或禁用 SMTP 后端的用户认证。
如果 XCLIENT 也被启用,则 XCLIENT
命令将不发送 LOGIN
参数。
语法 |
proxy_timeout |
---|---|
默认值 |
proxy_timeout 24h; |
上下文 |
mail , server |
设置客户端或代理服务器连接上连续两次读或写操作之间的超时时间
。如果在此时间内没有数据传输,连接将被关闭。
语法 |
xclient |
---|---|
默认值 |
xclient on; |
上下文 |
mail , server |
连接到 SMTP 后端时,启用或禁用使用客户端参数传递 XCLIENT 命令。
启用 XCLIENT
后,MTA 能够将客户端信息写入日志并基于这些数据应用各种限制。
如果启用 XCLIENT
,则 nginx 在连接到后端时会传递以下命令:
-
带有 服务器名称 的
EHLO
-
XCLIENT
-
由客户端传递的
EHLO
或HELO
如果根据客户端 IP 地址找到的名称指向同一地址,则将其作为 XCLIENT
命令的 NAME
参数传递。如果找不到名称、名称指向不同地址或未指定解析器,则在 NAME
参数中传递 [UNAVAILABLE]
。如果在解析过程中发生错误,则使用 [TEMPUNAVAIL]
值。
如果禁用 XCLIENT
,则 nginx 在连接到后端时,如果客户端传递了 EHLO
,则传递带有 服务器名称 的 EHLO
命令;否则,传递带有服务器名称的 HELO
命令。