smtp_capabilities

smtp_capabilities 指令配置 NGINX 邮件服务器对外宣告的 SMTP 功能。 — NGINX Mail Core

smtp_capabilities
mailmail server
语法smtp_capabilities capability1 capability2 ...;
默认值none
上下文mail, mail server
模块NGINX Mail Core
参数1+

说明

smtp_capabilities 指令在 NGINX 邮件服务器的上下文中使用,用于指定服务器在 SMTP 会话期间向客户端宣布哪些能力。该指令接受一个或多个参数,用以表示受支持的 SMTP 功能,例如 AUTH、EXPN 等。默认情况下,除非专门定义此指令,否则 NGINX 不会宣告任何功能。 在定义 smtp_capabilities 指令时,需要谨慎考虑要启用的功能。所指定的每个能力都会包含在 SMTP 握手期间的 EHLO 响应中,使客户端知道可使用哪些功能。这可以增强与依赖特定 SMTP 功能的各种电子邮件客户端的兼容性。为确保客户端能够有效利用服务器,应指定所有必要的功能。然而,重要的是只宣告服务器配置实际支持的功能,否则可能导致尝试使用不受支持功能的电子邮件客户端产生混淆并带来糟糕的用户体验。 smtp_capabilities 指令的参数必须正确格式化,并应放置在适当的邮件服务器上下文中以生效。应注意遵循正确的语法以避免错误配置。每个功能之间应以空格分隔,并且务必确保输入的空格和可用选项不会引入意外的错误或遗漏。

配置示例

mail {
    server {
        listen 25;
        smtp_capabilities AUTH LOGIN PLAIN; 
    }
}

确保您所宣称的所有功能实际上都被您的 NGINX 配置所支持,因为误传功能可能导致客户端错误。

不要在生产配置中包含不受支持或实验性的功能,以避免兼容性问题。