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 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 protocol

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

此指令出现在 1.19.4 版本中。

使用 AUTH 命令启用或禁用 SMTP 后端的用户认证。

如果 XCLIENT 也被启用,则 XCLIENT 命令将不发送 LOGIN 参数。

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

设置客户端或代理服务器连接上连续两次读或写操作之间的超时时间。如果在此时间内没有数据传输,连接将被关闭。

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

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

启用 XCLIENT 后,MTA 能够将客户端信息写入日志并基于这些数据应用各种限制。

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

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

如果禁用 XCLIENT,则 nginx 在连接到后端时,如果客户端传递了 EHLO,则传递带有 服务器名称EHLO 命令;否则,传递带有服务器名称的 HELO 命令。