> For the complete documentation index, see [llms.txt](https://docshome.gitbook.io/nginx-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docshome.gitbook.io/nginx-docs/he-xin-gong-neng/mail/ngx_mail_pop3_module.md).

# ngx\_mail\_pop3\_module

* [示例配置](/nginx-docs/he-xin-gong-neng/mail/ngx_mail_pop3_module.md#example_configuration)
* [指令](/nginx-docs/he-xin-gong-neng/mail/ngx_mail_pop3_module.md#directives)
  * [pop3\_auth](/nginx-docs/he-xin-gong-neng/mail/ngx_mail_pop3_module.md#pop3_auth)
  * [pop3\_capabilities](/nginx-docs/he-xin-gong-neng/mail/ngx_mail_pop3_module.md#pop3_capabilities)

## 指令 <a href="#directives" id="directives"></a>

### pop3\_auth

|       - | 说明                           |
| ------: | ---------------------------- |
|  **语法** | **pop3\_auth** `method ...`; |
|  **默认** | pop3\_auth plain;            |
| **上下文** | mail、server                  |

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

* `plain`

  [USER/PASS](https://tools.ietf.org/html/rfc1939)、[AUTH PLAIN](https://tools.ietf.org/html/rfc4616)、[AUTH LOGIN](https://tools.ietf.org/html/draft-murchison-sasl-login-00)。不可能禁用这些方法。
* `apop`

  [APOP](https://tools.ietf.org/html/rfc1939)。为了使此方法正常工作，密码不能加密存储。
* `cram-md5`

  [AUTH CRAM-MD5](https://tools.ietf.org/html/rfc2195)。为了使此方法正常工作，密码不能加密存储。
* `external`

  [AUTH EXTERNAL](https://tools.ietf.org/html/rfc4422)（1.11.6）。

### pop3\_capabilities

|       - | 说明                                      |
| ------: | --------------------------------------- |
|  **语法** | **pop3\_capabilities** `extension ...`; |
|  **默认** | pop3\_capabilities TOP USER UIDL;       |
| **上下文** | mail、server                             |

设置响应 `CAPA` 命令传送给客户端的 [POP3 协议](https://tools.ietf.org/html/rfc2449) 扩展列表。根据 [starttls](/nginx-docs/he-xin-gong-neng/mail/ngx_mail_ssl_module.md#starttls) 指令值，[pop3\_auth](/nginx-docs/he-xin-gong-neng/mail/ngx_mail_pop3_module.md#pop3_auth) 指令（[SASL](https://tools.ietf.org/html/rfc2449) 扩展）和 [STLS](https://tools.ietf.org/html/rfc2595) 中指定的认证方法将自动添加到此列表。

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

## 原文档

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