imap_capabilities
`imap_capabilities` 指令用于配置 NGINX Mail 模块中 IMAP 服务器的功能。 — NGINX Mail Core
imap_capabilities
mailmail server
语法imap_capabilities capability1 [capability2 ...];
默认值none
上下文mail, mail server
模块NGINX Mail Core
参数1+
说明
在 `mail` 上下文中使用 `imap_capabilities` 指令来指定 IMAP 服务器可以向邮件客户端提供的一组能力。该列表至关重要,因为它向客户端告知 IMAP 服务器支持的功能,例如 `IMAP4rev1`、`UIDPLUS` 或 `IDLE`,使客户端能够据此决定如何与服务器交互。 每个能力以字符串参数的形式定义,可重复指定;每次后续的条目都会附加到服务器公告的能力列表中。这样在连接过程中进行能力协商的客户端就能识别并使用 IMAP 服务器提供的这些功能。因此,在填写该指令时应仔细选择准确的能力,以确保客户端与服务器之间的通信和功能正常。 使用 `imap_capabilities` 时,建议包含常见的 IMAP 功能,以提高与更广泛邮件客户端的兼容性。此外,任何格式错误的条目都可能在握手过程中导致问题,因此严格遵循 IMAP 标准非常重要。
配置示例
mail {
imap_capabilities IMAP4rev1 UIDPLUS IDLE;
}⚠
确保 capabilities 的拼写正确且符合 IMAP 标准,以避免与客户端握手失败。
⚠
定义冲突的 capabilities 可能导致意外行为或使某些功能失效。
⚠
请记住,并非所有客户端都支持所有声明的 capabilities,因此只包含对你的用例至关重要的那些。