ngx_mail_proxy_module 模块

指令
     proxy_buffer
     proxy_pass_error_message
     proxy_protocol
     proxy_smtp_auth
     proxy_timeout
     xclient

指令

语法: proxy_buffer size;
默认值:
proxy_buffer 4k|8k;
上下文: mail, server

设置用于代理的缓冲区大小。默认情况下,缓冲区大小等于一个内存页。根据平台的不同,它可以是4K或8K。

语法: proxy_pass_error_message on | off;
默认值:
proxy_pass_error_message off;
上下文: mail, server

指示是否将在后端进行身份验证期间获得的错误消息传递给客户端。

通常情况下,如果nginx中的身份验证成功,后端就无法返回错误。但如果它仍然返回错误,这意味着发生了某种内部错误。在这种情况下,后端消息可能包含不应向客户端显示的信息。但对于某些POP3服务器来说,对于正确的密码返回错误是一种正常行为。例如,CommuniGatePro会定期输出邮箱溢出或其他事件的身份验证错误,向用户提供相关信息。在这种情况下应启用该指令。

语法: proxy_protocol on | off;
默认值:
proxy_protocol off;
上下文: mail, server

该指令出现在版本1.19.8中。

为与后端的连接启用PROXY协议

语法: proxy_smtp_auth on | off;
默认值:
proxy_smtp_auth off;
上下文: mail, server

该指令出现在版本1.19.4中。

启用或禁用SMTP后端上的用户身份验证,使用AUTH命令。

如果还启用了XCLIENT,那么XCLIENT命令将不会发送LOGIN参数。

语法: proxy_timeout 超时时间;
默认值:
proxy_timeout 24小时;
上下文: mail, server

设置客户端或代理服务器连接上两次连续读取或写入操作之间的 超时时间。如果在此时间内未传输任何数据,则关闭连接。

语法: xclient on | off;
默认值:
xclient 开启;
上下文: mail, server

启用或禁用连接到 SMTP 后端时传递客户端参数的 XCLIENT 命令。

使用 XCLIENT,MTA 能够将客户端信息写入日志并根据此数据应用各种限制。

如果启用了 XCLIENT,那么 nginx 在连接到后端时传递以下命令:

如果客户端 IP 地址解析出的名称指向同一地址,则将其在 XCLIENT 命令的 NAME 参数中传递。如果找不到名称、指向不同地址,或者未指定 解析器,则在 NAME 参数中传递 [UNAVAILABLE]。如果在解析过程中发生错误,则使用 [TEMPUNAVAIL] 值。

如果禁用了 XCLIENT,那么当连接到后端时,如果客户端已传递 EHLOHELO 带有服务器名称,则 nginx 传递 EHLO 命令和 服务器名称,否则传递 EHLO 命令。