<!-- review: finished -->

<a id="mail-pop3"></a>

# POP3

该模块启用 POP3 邮件协议支持,允许服务器从邮件服务器下载消息。它连接到 POP3 服务器,检索消息头和内容,提供安全认证,并管理消息状态,如已下载或已删除。

<a id="directives-59"></a>

## 指令

<a id="index-0"></a>

<a id="m-pop3-auth"></a>

### pop3_auth

| [语法](https://cn.angie.software//angie/docs/configuration/configfile.md#configfile)   | `pop3_auth` method ...;   |
|--------------------------------------------------------------------------------------|---------------------------|
| 默认                                                                                   | `pop3_auth plain;`        |
| [上下文](https://cn.angie.software//angie/docs/configuration/configfile.md#configfile)  | mail, server              |

设置允许的 POP3 客户端身份验证方法。支持的方法有:

| `plain`       | [USER/PASS](https://datatracker.ietf.org/doc/html/rfc1939)、[AUTH PLAIN](https://datatracker.ietf.org/doc/html/rfc4616)、[AUTH LOGIN](https://datatracker.ietf.org/doc/html/draft-murchison-sasl-login-00)   |
|---------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `apop`        | [APOP](https://datatracker.ietf.org/doc/html/rfc1939)。为了使此方法生效,密码必须以未加密形式存储。                                                                                                                               |
| `cram-md5`    | [AUTH=CRAM-MD5](https://datatracker.ietf.org/doc/html/rfc2195)。为了使此方法生效,密码必须以未加密形式存储。                                                                                                                      |
| `external`    | [AUTH=EXTERNAL](https://datatracker.ietf.org/doc/html/rfc4422)                                                                                                                                             |
| `xoauth2`     | [AUTH=XOAUTH2](https://developers.google.com/gmail/imap/xoauth2-protocol)                                                                                                                                  |
| `oauthbearer` | [AUTH=OAUTHBEARER](https://datatracker.ietf.org/doc/html/rfc7628)                                                                                                                                          |

明文身份验证方法(`USER/PASS`、`AUTH PLAIN` 和 `AUTH LOGIN`)始终启用,尽管如果没有指定 `plain` 方法,:samp:AUTH PLAIN 和 `AUTH LOGIN` 将不会自动包含在 [pop3_capabilities](#m-pop3-capabilities) 中。

<a id="index-1"></a>

<a id="m-pop3-capabilities"></a>

### pop3_capabilities

| [语法](https://cn.angie.software//angie/docs/configuration/configfile.md#configfile)   | `pop3_capabilities` extension ...;   |
|--------------------------------------------------------------------------------------|--------------------------------------|
| 默认                                                                                   | `pop3_capabilities TOP USER UIDL;`   |
| [上下文](https://cn.angie.software//angie/docs/configuration/configfile.md#configfile)  | mail, server                         |

设置在响应 CAPA 命令时传递给客户端的 [POP3 协议](https://datatracker.ietf.org/doc/html/rfc2449) 扩展列表。根据 [starttls](https://cn.angie.software//angie/docs/configuration/modules/mail/mail_ssl.md#m-starttls) 指令的值,:ref:m_pop3_auth 指令中指定的身份验证方法([SASL](https://datatracker.ietf.org/doc/html/rfc2449) 扩展)和 [STLS](https://datatracker.ietf.org/doc/html/rfc2595) 会自动添加到此列表中。

指定 POP3 后端支持的扩展是有意义的,这些后端是客户端代理的目标(如果这些扩展与身份验证后使用的命令相关,当 Angie 透明地将客户端连接代理到后端时)。