模块 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 协议。
语法 |
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
,则在客户端传递 EHLO
时,nginx 在连接到后端时会使用带有 服务器名称 的 EHLO
命令,否则使用带有服务器名称的 HELO
。