Nginx官方文档(四十四)【ngx_mail_imap_module|ngx_mail_pop3_module|ngx_mail_smtp_module】

ngx_mail_imap_module

• 示例配置
• 指令
  • imap_auth
  • imap_capabilities
  • imap_client_buffer

指令

imap_auth

-	说明
语法	imap_auth method ...;
默认	imap_auth plain;
上下文	mail、server

为 IMAP 客户端设置允许的认证方法。支持的方法有：

• login

  AUTH=LOGIN

• plain

  AUTH=PLAIN

• cram-md5

  AUTH=CRAM-MD5。为了使此方法正常工作，密码不能加密存储。

• external

  AUTH EXTERNAL（1.11.6）。

imap_capabilities

-	说明
语法	imap_capabilities extension ...;
默认	imap_capabilities IMAP4 IMAP4rev1 UIDPLUS;
上下文	mail、server

设置响应 CAPABILITY 命令传递给客户端的 IMAP 协议 扩展列表。根据 starttls 指令值，imap_auth 指令和 STARTTLS 中指定的认证方法将自动添加到此列表中。

指定被代理客户端的 IMAP 后端支持的扩展（当 nginx 透明地代理到后端的客户端连接，如果这些扩展与认证后使用的命令相关），则是有意义的。

目前的标准扩展名单已发布在 www.iana.org。

imap_client_buffer

-	说明
语法	imap_client_buffer size;
默认	imap_client_buffer 4k|8k;
上下文	mail、server

设置 IMAP 命令读取缓冲区大小。默认情况下，缓冲区大小等于一个内存页面。4K 或 8K，取决于平台。

原文档

http://nginx.org/en/docs/mail/ngx_mail_imap_module.html

---

ngx_mail_pop3_module

• 示例配置
• 指令
  • pop3_auth
  • pop3_capabilities

指令

pop3_auth

-	说明
语法	pop3_auth method ...;
默认	pop3_auth plain;
上下文	mail、server

为 POP3 客户端设置允许的认证方法。支持的方法有：

• plain

  USER/PASS、AUTH PLAIN、AUTH LOGIN。不可能禁用这些方法。

• apop

  APOP。为了使此方法正常工作，密码不能加密存储。

• cram-md5

  AUTH CRAM-MD5。为了使此方法正常工作，密码不能加密存储。

• external

  AUTH EXTERNAL（1.11.6）。

pop3_capabilities

-	说明
语法	pop3_capabilities extension ...;
默认	pop3_capabilities TOP USER UIDL;
上下文	mail、server

设置响应 CAPA 命令传送给客户端的 POP3 协议 扩展列表。根据 starttls 指令值，pop3_auth 指令（SASL 扩展）和 STLS 中指定的认证方法将自动添加到此列表。

指定客户端代理的 POP3 后端支持的扩展（当 nginx 透明地代理到后端的客户端连接，如果这些扩展与认证后使用的命令相关），则是有意义的。

原文档

http://nginx.org/en/docs/mail/ngx_mail_pop3_module.html

---

ngx_mail_smtp_module

• 示例配置
• 指令
  • ngx_mail_smtp_module
  • smtp_capabilities

指令

smtp_auth

-	说明
语法	smtp_auth method ...;
默认	smtp_auth login plain;
上下文	mail、server

为 SMTP 客户端设置 SASL 认证 的允许方法。支持的方法有：

• login

  AUTH LOGIN

• plain

  AUTH PLAIN

• cram-md5

  AUTH CRAM-MD5。为了使此方法正常工作，密码不加密存储。

• external

  AUTH EXTERNAL（1.11.6）。

• none

  不需要验证

smtp_capabilities

-	说明
语法	smtp_capabilities extension ...;
默认	——
上下文	mail、server

设置传送给客户端响应 EHLO 命令的 SMTP 协议扩展列表。根据 starttls 指令值，smtp_auth 指令和 STARTTLS 中指定的认证方法将自动添加到此列表中。

指定被代理客户端的 MTA 支持扩展是有意义的（当 nginx 透明地将客户端连接代理到后端，如果这些扩展与认证后使用的命令相关）。

目前的标准扩展名单已发布在 www.iana.org。

原文档

http://nginx.org/en/docs/mail/ngx_mail_smtp_module.html