diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index b48d6b4..4231352 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -15,8 +15,8 @@ $ git remote add source git@github.com:DocsHome/nginx-docs.git
```bash
$ git add .
-$ git commit -a "Fix issue #1: change helo to hello"
-$ git push origin/master
+$ git commit -am "Fix issue #1: change helo to hello"
+$ git push origin master
```
* 在 GitHub 上提交 `pull request`。
diff --git a/README.md b/README.md
index 7688d2b..e9e81e6 100644
--- a/README.md
+++ b/README.md
@@ -1,8 +1,7 @@
-# Nginx 中文文档
-
-[](https://github.com/DocsHome/nginx-docs) [](https://github.com/DocsHome/nginx-docs) [](https://github.com/DocsHome/nginx-docs)
-
-
+
+
+
Nginx 中文文档
+
**resolver** `off`|
+|**默认**|resolver off;|
+|**上下文**|mail、server|
+
+配置用于查找客户端主机名以将其传递给[身份验证服务器](./ngx_mail_auth_http_module.md)的名称服务器，以及代理 SMTP 时的 [XCLIENT](ngx_mail_proxy_module.md#xclient) 命令。 例如：
+
+```nginx
+resolver 127.0.0.1 [::1]:5353;
+```
+
+可以使用可选端口（1.3.1、1.2.2）将地址指定为域名或 IP 地址。如果未指定端口，则使用端口 53。以轮询方式查询名称服务器。
+
+> 在 1.1.7 版本之前，只能配置一个名称服务器。从 1.3.1 和 1.2.2 版本开始，支持使用 IPv6 地址指定名称服务器。
+
+默认情况下，nginx 将在解析时同时查找 IPv4 和 IPv6 地址。如果不需要查找 IPv6 地址，则可以指定 `ipv6=off` 参数。
+
+> 从 1.5.8 版本开始，支持将名称解析为 IPv6 地址。
+
+默认情况下，nginx 使用响应的 TTL 值缓存应答。可选的 `valid` 参数可覆盖它：
+
+```nginx
+resolver 127.0.0.1 [::1]:5353 valid=30s;
+```
+
+> 在1.1.9 版本之前，无法调整缓存时间，nginx 始终将应答缓存 5 分钟。
+
+> 为防止 DNS 欺骗，建议在适当安全的受信任本地网络中配置 DNS 服务器。
+
+可选的 `status_zone` 参数（1.17.1）启用对指定区域中的请求和响应的 DNS 服务器统计信息的[收集]功能(../http/ngx_http_api_module.md#resolvers_)。该参数为我们的[商业订阅](http://nginx.com/products/?_ga=2.151996858.282650095.1578660485-1105498734.1571247330)部分。
+
+特殊值 `off` 禁用解析。
+
+### resolver_timeout
+
+|\-|说明|
+|:------|:------|
+|**语法**|**resolver_timeout** `time`;|
+|**默认**|resolver_timeout 30s;|
+|**上下文**|mail、server|
+
+设置 DNS 操作的超时时间，例如：
+
+```nginx
+resolver_timeout 5s;
+```
+
+### server
+
+|\-|说明|
+|:------|:------|
+|**语法**|**server** `{ ... }`;|
+|**默认**|——|
+|**上下文**|mail|
+
+设置服务器的配置。
+
+### server_name
+
+|\-|说明|
+|:------|:------|
+|**语法**|**server_name** `name`;|
+|**默认**|server_name hostname;|
+|**上下文**|mail、server|
+
+设置服务器名称，在以下场景中使用的：
+
+- 最开始的 POP3/SMTP 服务器问候语中
+- SASL CRAM-MD5 身份验证中的盐值中
+- 如果启用了 [XCLIENT](ngx_mail_proxy_module.md#xclient) 命令的传递，则在连接到 SMTP 后端时，在 `EHLO` 命令中
+
+如果未指定指令，则使用计算机的主机名。
+
+### timeout
+
+|\-|说明|
+|:------|:------|
+|**语法**|**timeout** `time`;|
+|**默认**|timeout 60s;|
+|**上下文**|mail、server|
+
+设置超时时间，在代理到后端开始之前使用。
+
+## 原文档
+
+- [http://nginx.org/en/docs/mail/ngx_mail_core_module.html](http://nginx.org/en/docs/mail/ngx_mail_core_module.html)
diff --git "a/\346\250\241\345\235\227\345\217\202\350\200\203/mail/ngx_mail_imap_module.md" "b/\346\250\241\345\235\227\345\217\202\350\200\203/mail/ngx_mail_imap_module.md"
index 3feb73f..fe95cd1 100644
--- "a/\346\250\241\345\235\227\345\217\202\350\200\203/mail/ngx_mail_imap_module.md"
+++ "b/\346\250\241\345\235\227\345\217\202\350\200\203/mail/ngx_mail_imap_module.md"
@@ -53,7 +53,7 @@
|\-|说明|
|------:|------|
|**语法**|**imap_client_buffer** `size`;|
-|**默认**|imap_client_buffer 4k|8k;|
+|**默认**|imap_client_buffer 4k|8k;|
|**上下文**|mail、server|
设置 IMAP 命令读取缓冲区大小。默认情况下，缓冲区大小等于一个内存页面。4K 或 8K，取决于平台。
diff --git "a/\346\250\241\345\235\227\345\217\202\350\200\203/mail/ngx_mail_proxy_module.md" "b/\346\250\241\345\235\227\345\217\202\350\200\203/mail/ngx_mail_proxy_module.md"
new file mode 100644
index 0000000..d60fd67
--- /dev/null
+++ "b/\346\250\241\345\235\227\345\217\202\350\200\203/mail/ngx_mail_proxy_module.md"
@@ -0,0 +1,69 @@
+# ngx_mail_proxy_module
+
+- [指令](#directives)
+ - [proxy_buffer](#proxy_buffer)
+ - [proxy_pass_error_message](#proxy_pass_error_message)
+ - [proxy_timeout](#proxy_timeout)
+ - [xclient](#xclient)
+
+
+
+## 指令
+
+### proxy_buffer
+
+|\-|说明|
+|:------|:------|
+|**语法**|**proxy_buffer** `size`;|
+|**默认**|proxy_buffer 4k|8k|
+|**上下文**|mail、server|
+
+设置用于代理的缓冲区的大小。默认情况下，缓冲区大小等于一个内存页。根据平台的不同，它可以是 4K 或 8K。
+
+### proxy_pass_error_message
+
+|\-|说明|
+|:------|:------|
+|**语法**|**proxy_pass_error_message** `on` | `off`;|
+|**默认**|proxy_pass_error_message off;|
+|**上下文**|mail、server|
+
+指示是否将后端身份验证期间获得的错误消息传递给客户端。
+
+通常，如果 nginx 中的身份验证成功，则后端无法返回错误。如果仍然返回错误，则表示发生了一些内部错误。在这种情况下，后端消息可能包含不应显示给客户端的信息。但是，对于某些 POP3 服务器，响应一个密码错误信息是正常现象。例如，CommuniGatePro 通过定期输出[身份验证错误](http://www.stalker.com/CommuniGatePro/POP.html#Alerts)来通知用户[邮箱溢出](http://www.stalker.com/CommuniGatePro/Alerts.html#Quota)或其他事件。在这种情况下，应启用该指令。
+
+### proxy_timeout
+
+|\-|说明|
+|:------|:------|
+|**语法**|**proxy_timeout** `timeout`;|
+|**默认**|proxy_timeout 24h;|
+|**上下文**|mail、server|
+
+设置客户端或代理服务器连接上两次连续的读取或写入操作之间的超时（`timeout`）。如果在此时间内没有数据传输，则连接将关闭。
+
+### xclient
+
+|\-|说明|
+|:------|:------|
+|**语法**|**xclient** `on` | `off`;|
+|**默认**|xclient on;|
+|**上下文**|mail、server|
+
+连接到 SMTP 后端时，启用或禁用 [XCLIENT](http://www.postfix.org/XCLIENT_README.html) 命令与客户端参数的传递。
+
+借助 `XCLIENT`，MTA 能够将客户端信息写入日志并基于此数据应用各种限制。
+
+如果启用了 `XCLIENT`，则 nginx 在连接到后端时会传递以下命令：
+
+- 附带[服务器名称](ngx_mail_core_module.md#server_name)的 EHLO
+- `XCLIENT`
+- 由客户传递的 `EHLO` 或 `HELO`
+
+如果客户端 IP 地址[找到](ngx_mail_core_module.md#resolver)的名称指向相同的地址，则会在 `XCLIENT` 命令的 `NAME` 参数中传递该名称。如果找不到名称、指向其他地址或未指定[解析器](ngx_mail_core_module.md#resolver)，则在 `NAME` 参数中传递 `[UNAVAILABLE]`。如果在解析过程中发生错误，则使用 `[TEMPUNAVAIL]` 值。
+
+如果禁用了 `XCLIENT`，则如果客户端已通过 `EHLO`，则 nginx 在连接到后端时将使用[服务器名称](ngx_mail_core_module.md#server_name)传递 EHLO 命令；否则，使用服务器名称传递 `HELO`。
+
+## 原文档
+
+- [http://nginx.org/en/docs/mail/ngx_mail_proxy_module.html](http://nginx.org/en/docs/mail/ngx_mail_proxy_module.html)
diff --git "a/\346\250\241\345\235\227\345\217\202\350\200\203/mail/ngx_mail_ssl_module.md" "b/\346\250\241\345\235\227\345\217\202\350\200\203/mail/ngx_mail_ssl_module.md"
new file mode 100644
index 0000000..906e16f
--- /dev/null
+++ "b/\346\250\241\345\235\227\345\217\202\350\200\203/mail/ngx_mail_ssl_module.md"
@@ -0,0 +1,399 @@
+# ngx_mail_ssl_module
+
+- [示例配置](#example_configuration)
+- [指令](#directives)
+ - [ssl](#ssl)
+ - [ssl_certificate](#ssl_certificate)
+ - [ssl_certificate_key](#ssl_certificate_key)
+ - [ssl_ciphers](#ssl_ciphers)
+ - [ssl_client_certificate](#ssl_client_certificate)
+ - [ssl_crl](#ssl_crl)
+ - [ssl_dhparam](#ssl_dhparam)
+ - [ssl_ecdh_curve](#ssl_ecdh_curve)
+ - [ssl_password_file](#ssl_password_file)
+ - [ssl_prefer_server_ciphers](#ssl_prefer_server_ciphers)
+ - [ssl_protocols](#ssl_protocols)
+ - [ssl_session_cache](#ssl_session_cache)
+ - [ssl_session_ticket_key](#ssl_session_ticket_key)
+ - [ssl_session_tickets](#ssl_session_tickets)
+ - [ssl_session_timeout](#ssl_session_timeout)
+ - [ssl_trusted_certificate](#ssl_trusted_certificate)
+ - [ssl_verify_client](#ssl_verify_client)
+ - [ssl_verify_depth](#ssl_verify_depth)
+ - [starttls](#starttls)
+
+`ngx_mail_ssl_module` 模块可让邮件代理服务器支持 SSL/TLS 协议。
+
+默认情况下不构建此模块，可在构建时使用 `--with-mail_ssl_module` 配置参数启用它。
+
+> 该模块依赖 [OpenSSL](http://www.openssl.org/) 库。
+
+
+
+## 示例配置
+
+为了减轻处理器负载，建议：
+
+- 将 [worker 进程](../核心功能.md#worker_processes)数设置为与处理器数量相等
+- 启用[共享](#ssl_session_cache_shared)会话缓存
+- 禁用[内置](#ssl_session_cache_builtin)的会话缓存
+- 可以延长会话的[生命周期](#ssl_session_timeout)（默认为 5 分钟）
+
+```nginx
+worker_processes auto;
+
+mail {
+
+ ...
+
+ server {
+ listen 993 ssl;
+
+ ssl_protocols TLSv1 TLSv1.1 TLSv1.2;
+ ssl_ciphers AES128-SHA:AES256-SHA:RC4-SHA:DES-CBC3-SHA:RC4-MD5;
+ ssl_certificate /usr/local/nginx/conf/cert.pem;
+ ssl_certificate_key /usr/local/nginx/conf/cert.key;
+ ssl_session_cache shared:SSL:10m;
+ ssl_session_timeout 10m;
+
+ ...
+ }
+```
+
+
+
+## 指令
+
+### ssl
+
+|\-|说明|
+|:------|:------|
+|**语法**|**ssl** `on` | `off`;|
+|**默认**|ssl off;|
+|**上下文**|mail、server|
+
+该指令在 1.15.0 版本中已废弃，请改用 [listen](./ngx_mail_core_module.md#listen) 指令的 `ssl` 参数。
+
+### ssl_certificate
+
+|\-|说明|
+|:------|:------|
+|**语法**|**ssl_certificate** `file`;|
+|**默认**|——|
+|**上下文**|mail、server|
+
+为给定服务器指定一个 PEM 格式的证书文件（`file`）。如果除主证书之外还要指定中间证书，则应在同一文件中按以下顺序指定它们：首先是主证书，然后是中间证书。PEM 格式的密钥可以放在同一文件中。
+
+从 1.11.0 版开始，可以多次声明该指令来加载不同类型的证书，例如 RSA 和 ECDSA：
+
+```nginx
+server {
+ listen 993 ssl;
+
+ ssl_certificate example.com.rsa.crt;
+ ssl_certificate_key example.com.rsa.key;
+
+ ssl_certificate example.com.ecdsa.crt;
+ ssl_certificate_key example.com.ecdsa.key;
+
+ ...
+}
+```
+
+> 仅 OpenSSL 1.0.2 或更高版本支持不同证书的独立证书链。对于较旧的版本，只能使用一个证书链。
+
+可以指定 `data:certificate` 值来代替 `file`（1.15.10），无需使用文件即可加载证书。请注意，错误使用此语法可能会带来安全隐患，例如将密钥数据写入[错误日志](../核心功能.md#error_log)。
+
+### ssl_certificate_key
+
+|\-|说明|
+|:------|:------|
+|**语法**|**ssl_certificate_key** `file`;|
+|**默认**|——|
+|**上下文**|mail、server|
+
+给服务器指定一个 PEM 格式的密钥文件（`file`）。
+
+可以指定 `engine:name:id` 来代替 `file`（1.7.9），Nginx 将从名称为 `name` 的 OpenSSL 引擎中中加载 id 为 `id` 的密钥。
+
+可以指定 `data:key` 值来代替 `file`（1.15.10），无需使用文件就可以加载密钥。请注意，错误使用此语法可能会带来安全隐患，例如将密钥数据写入[错误日志](../核心功能.md#error_log)。
+
+### ssl_ciphers
+
+|\-|说明|
+|:------|:------|
+|**语法**|**ssl_ciphers** `ciphers`|
+|**默认**|ssl_ciphers HIGH:!aNULL:!MD5;|
+|**上下文**|mail、server|
+
+指定启用的加密算法。仅可指定 OpenSSL 库支持的算法，例如：
+
+```
+ssl_ciphers ALL:!aNULL:!EXPORT56:RC4+RSA:+HIGH:+MEDIUM:+LOW:+SSLv2:+EXP;
+```
+
+> 可以使用 `openssl ciphers` 命令查看完整列表。
+
+默认情况下，早期版本的 nginx 使用了[不同](../../介绍/配置HTTPS服务器.md#compatibility)的加密算法。
+
+### ssl_client_certificate
+
+|\-|说明|
+|:------|:------|
+|**语法**|**ssl_client_certificate** `file`;|
+|**默认**|——|
+|**上下文**|mail、server|
+|**提示**|该指令在 1.7.11 版本中出现|
+
+指定一个 PEM 格式的受信任 CA 证书文件，用于[验证](#ssl_verify_client)客户端证书。
+
+证书列表将发送给客户端。如果不希望这样做，则可以使用 [ssl_trusted_certificate ](#ssl_trusted_certificate) 指令配置。
+
+### ssl_crl
+
+|\-|说明|
+|:------|:------|
+|**语法**|**ssl_crl** `file`;|
+|**默认**|——|
+|**上下文**|mail、server|
+|**提示**|该指令在 1.7.11 版本中出现|
+
+指定一个 PEM 格式的吊销证书（CRL）文件，用于[验证](#ssl_verify_client)客户端证书。
+
+### ssl_dhparam
+
+|\-|说明|
+|:------|:------|
+|**语法**|**ssl_dhparam** `file`;|
+|**默认**|——|
+|**上下文**|mail、server|
+|**提示**|该指令在 0.7.2 版本中出现|
+
+指定一个带有 DHE 密码的 DH 参数的文件（`file`）。
+
+默认情况下，不设置任何参数，因此不使用 DHE 密码。
+
+> 在 1.11.0 版之前，默认情况下使用内置参数。
+
+### ssl_ecdh_curve
+
+|\-|说明|
+|:------|:------|
+|**语法**|**ssl_ecdh_curve** `curve`;|
+|**默认**|ssl_ecdh_curve auto;|
+|**上下文**|mail、server|
+|**提示**|该指令在 1.1.0 和 1.0.6 版本中出现|
+
+为 ECDHE 算法指定一个椭圆曲线方案（`curve`）。
+
+使用 OpenSSL 1.0.2 或更高版本时，可以指定多个曲线（1.11.0），例如：
+
+```nginx
+ssl_ecdh_curve prime256v1:secp384r1;
+```
+
+当使用 OpenSSL 1.0.2 或更高版本或带有较旧版本的 `prime256v1` 时，特殊值 `auto`（1.11.0）指示 nginx 使用内置在 OpenSSL 库中的列表。
+
+> 在 1.11.0 版之前，默认使用 `prime256v1` 曲线。
+
+### ssl_password_file
+
+|\-|说明|
+|:------|:------|
+|**语法**|**ssl_password_file** `file`;|
+|**默认**|——|
+|**上下文**|mail、server|
+|**提示**|该指令在 1.7.3 版本中出现|
+
+指定一个保存有[密钥](#ssl_certificate_key)密码的文件，每个密码独占一行。 加载密钥时依次尝试使用这些密码。
+
+例：
+
+```nginx
+mail {
+ ssl_password_file /etc/keys/global.pass;
+ ...
+
+ server {
+ server_name mail1.example.com;
+ ssl_certificate_key /etc/keys/first.key;
+ }
+
+ server {
+ server_name mail2.example.com;
+
+ # named pipe can also be used instead of a file
+ ssl_password_file /etc/keys/fifo;
+ ssl_certificate_key /etc/keys/second.key;
+ }
+}
+```
+
+### ssl_prefer_server_ciphers
+
+|\-|说明|
+|:------|:------|
+|**语法**|**ssl_prefer_server_ciphers** `on` | `off`;|
+|**默认**|ssl_prefer_server_ciphers off;|
+|**上下文**|mail、server|
+
+指定当使用 SSLv3 和 TLS 协议时，服务器加密算法应优先于客户端加密算法。
+
+### ssl_protocols
+
+|\-|说明|
+|:------|:------|
+|**语法**|**ssl** `[SSLv2] [SSLv3] [TLSv1] [TLSv1.1] [TLSv1.2] [TLSv1.3]`;|
+|**默认**|sssl_protocols TLSv1 TLSv1.1 TLSv1.2;|
+|**上下文**|mail、server|
+
+启用指定的协议。
+
+> `TLSv1.1` 和 `TLSv1.2` 参数（1.1.13、1.0.12）仅在使用 OpenSSL 1.0.1 或更高版本时有效。
+
+> `TLSv1.3` 参数（1.13.0）仅在 OpenSSL 1.1.1 构建时使用了 TLSv1.3 支持有效。
+
+
+### ssl_session_cache
+
+|\-|说明|
+|:------|:------|
+|**语法**|**ssl_session_cache** `on` | `none` | `[builtin[:size]] [shared:name:size]`;|
+|**默认**|ssl_session_cache none;|
+|**上下文**|mail、server|
+
+设置存储会话参数的缓存的类型和大小。缓存可以是以下任何类型：
+
+- `off`
+
+ 严格禁止使用会话缓存：nginx 明确告知客户端禁止重复使用会话。
+
+- `none`
+
+ 禁止使用会话缓存：nginx 告诉客户端会话可以重用，但实际上并没有在缓存中存储会话参数。
+
+- `builtin`
+
+ 内置的 OpenSSL 缓存，仅由一个 worker 进程使用。缓存大小在会话中指定。如果未指定大小，则默认为 20480 个会话。使用内置缓存可能导致内存碎片。
+
+- `shared`
+
+ 所有 worker 进程之间共享的缓存。缓存大小以字节为单位，一兆字节可以存储大约 4000 个会话。每个共享缓存都有一个任意的名称。相同名称的缓存可以在多个服务器中使用。
+
+两种缓存类型可以同时使用，例如：
+
+```nginx
+ssl_session_cache builtin:1000 shared:SSL:10m;
+```
+
+但仅使用共享缓存而不使用内置缓存，效率会更高。
+
+### ssl_session_ticket_key
+
+|\-|说明|
+|:------|:------|
+|**语法**|**ssl_session_ticket_key** `file`;|
+|**默认**|——|
+|**上下文**|mail、server|
+|**提示**|该指令在 1.5.7 版本中出现|
+
+设置一个带有用于加密和解密 TLS 会话票证的密钥文件。如果必须在多个服务器之间共享同一密钥，则该指令是必需的。默认情况下，使用随机生成的密钥。
+
+如果指定了多个密钥，仅第一个密钥被用于加密 TLS 会话票证。可配置 key 轮转，例如：
+
+```nginx
+ssl_session_ticket_key current.key;
+ssl_session_ticket_key previous.key;
+```
+
+该文件（`file`）必须包含 80 或 48 个字节的随机数据，可以使用以下命令创建：
+
+```
+openssl rand 80> ticket.key
+```
+
+根据文件大小，使用 AES256（针对 80 字节的 key，1.11.8）或 AES128（针对 48 字节的 key）进行加密。
+
+### ssl_session_tickets
+
+|\-|说明|
+|:------|:------|
+|**语法**|**ssl_session_tickets** `on` | `off`;|
+|**默认**|ssl_session_tickets on;|
+|**上下文**|mail、server|
+|**提示**|该指令在 1.5.9 版本中出现|
+
+通过 [TLS 会话票证](https://tools.ietf.org/html/rfc5077)启用或禁用会话复用。
+
+### ssl_session_timeout
+
+|\-|说明|
+|:------|:------|
+|**语法**|**ssl_session_timeout** `time`;|
+|**默认**|ssl_session_timeout 5m;|
+|**上下文**|mail、server|
+
+指定客户端可以重用会话参数的时间。
+
+### ssl_trusted_certificate
+
+|\-|说明|
+|:------|:------|
+|**语法**|**ssl_trusted_certificate** `file`;|
+|**默认**|——|
+|**上下文**|mail、server|
+|**提示**|该指令在 1.7.11 版本中出现|
+
+指定一个带有用于[验证](#ssl_verify_client)客户端证书的 PEM 格式的受信任 CA 证书文件。
+
+与 [ssl_client_certificate](#ssl_client_certificate) 设置的证书相反，这些证书的列表不会发送给客户端。
+
+### ssl_verify_client
+
+|\-|说明|
+|:------|:------|
+|**语法**|**ssl_verify_client** `on` | `none` | `optional` | `optional_no_ca`;|
+|**默认**|ssl_verify_client off;|
+|**上下文**|mail、server|
+|**提示**|该指令在 1.7.11 版本中出现|
+
+启用客户端证书的验证。验证结果在[身份验证](ngx_mail_auth_http_module.md#auth_http)请求的 **Auth-SSL-Verify** 头中传递。
+
+`optional` 参数请求客户端证书并验证该证书是否存在。
+
+`optional_no_ca` 参数请求客户端证书，但不需要由受信任的 CA 证书对其进行签名，适合在 nginx 外部的服务执行实际证书验证的情况下使用。通过[发送](ngx_mail_auth_http_module.md#auth_http_pass_client_cert)到身份验证服务器的请求可以访问证书的内容。
+
+### ssl_verify_depth
+
+|\-|说明|
+|:------|:------|
+|**语法**|**ssl_verify_depth** `number`;|
+|**默认**|ssl_verify_depth 1;|
+|**上下文**|mail、server|
+|**提示**|该指令在 1.7.11 版本中出现|
+
+设置客户端证书链的验证深度。
+
+### starttls
+
+|\-|说明|
+|:------|:------|
+|**语法**|**starttls** `on` | `off` | `only`;|
+|**默认**|starttls off;|
+|**上下文**|mail、server|
+
+- `on`
+
+ 允许对 POP3 使用 `STLS` 命令，对 IMAP 和 SMTP 使用 `STARTTLS` 命令
+
+- `off`
+
+ 拒绝使用 `STLS` 和 `STARTTLS` 命令
+
+- `only`
+
+ 要求初步的 TLS 转换
+
+## 原文档
+
+- [http://nginx.org/en/docs/mail/ngx_mail_ssl_module.html](http://nginx.org/en/docs/mail/ngx_mail_ssl_module.html)
diff --git "a/\346\250\241\345\235\227\345\217\202\350\200\203/stream/ngx_stream_keyval_module.md" "b/\346\250\241\345\235\227\345\217\202\350\200\203/stream/ngx_stream_keyval_module.md"
new file mode 100644
index 0000000..cfaa327
--- /dev/null
+++ "b/\346\250\241\345\235\227\345\217\202\350\200\203/stream/ngx_stream_keyval_module.md"
@@ -0,0 +1,91 @@
+# ngx_stream_keyval_module
+
+- [示例配置](#example_configuration)
+- [指令](#directives)
+ - [keyval](#keyval)
+ - [keyval_zone](#keyval_zone)
+
+`ngx_stream_keyval_module` 模块（1.13.7）可用于创建变量，变量的值从由 [API](ngx_http_api_module.md#stream_keyvals_) 管理的键值对中获取。
+
+> 此模块为[商业订阅](http://nginx.com/products/?_ga=2.203887064.99786210.1588592638-1615340879.1588592638)部分。
+
+
+
+## 示例配置
+
+```nginx
+http {
+
+ server {
+ ...
+ location /api {
+ api write=on;
+ }
+ }
+}
+
+stream {
+
+ keyval_zone zone=one:32k state=one.keyval;
+ keyval $ssl_server_name $name zone=one;
+
+ server {
+ listen 12345 ssl;
+ proxy_pass $name;
+ ssl_certificate /usr/local/nginx/conf/cert.pem;
+ ssl_certificate_key /usr/local/nginx/conf/cert.key;
+ }
+}
+```
+
+
+
+## 指令
+
+### keyval
+
+|\-|说明|
+|:------|:------|
+|**语法**|**keyval** `key $variable zone=name`;|
+|**默认**|——|
+|**上下文**|stream|
+
+创建一个新的 `$variable`，其值在键值数据库中通过 key 查找。匹配规则由 [keyval_zone](#keyval_zone) 指令的 [type](#keyval_type) 参数定义。数据库存储在 `zone` 参数指定的共享内存区域中。
+
+### keyval_zone
+
+|\-|说明|
+|:------|:------|
+|**语法**|**keyval_zone** `zone=name:size [state=file] [timeout=time] [type=string\|ip\|prefix] [sync]`;|
+|**默认**|——|
+|**上下文**|stream|
+
+设置维持键值数据库的共享内存区域的名称（`name`）和大小（`size`）。键值对通过 [API](ngx_http_api_module.md#stream_keyvals_) 进行管理。
+
+可选的 `state` 参数指定一个文件（`file`），该文件以 JSON 格式保存键值数据库的当前状态，并在重新启动 nginx 时保持不变。
+
+可选的 `timeout` 参数（1.15.0）设置将键值对从区域中删除的时间。
+
+可选的 `type` 参数（1.17.1）激活一个额外的索引，该索引针对某种类型的键匹配进行了优化，匹配规则在计算[键值](#keyval) `$variable` 时定义。
+
+> 索引存储在相同的共享存储区中，因此需要额外的存储。
+
+- `type=string`
+
+ 默认配置，不启用索引；使用记录 key 和一个搜索 key 的完全匹配来执行变量查找
+
+- `type=ip`
+
+ 搜索 key 是 IPv4 或 IPv6 地址或 CIDR 范围的文字表示；要匹配记录 key，搜索 key 必须属于记录 key 指定的子网或与 IP 地址完全匹配
+
+- `type=prefix`
+
+ 使用记录 key 和搜索 key 的前缀匹配（1.17.5）执行变量查找；要与记录 key 匹配，记录 key 必须是搜索 key 的前缀
+
+可选的 `sync` 参数（1.15.0）启用共享内存区域[同步](ngx_stream_zone_sync_module.md#zone_sync)。同步要求设置超时（`timeout`）参数。
+
+> 如果启用了同步，则将仅在目标群集节点上执行键值对（无论是[一个](ngx_http_api_module.md#patchStreamKeyvalZoneKeyValue)还是[全部](ngx_http_api_module.md#deleteStreamKeyvalZoneData)）的删除操作。经过 `timeout` 时间后，将删除其他群集节点上相同的键值对。
+
+## 原文档
+
+- [http://nginx.org/en/docs/stream/ngx_stream_keyval_module.html](http://nginx.org/en/docs/stream/ngx_stream_keyval_module.html)
diff --git "a/\346\250\241\345\235\227\345\217\202\350\200\203/stream/ngx_stream_proxy_module.md" "b/\346\250\241\345\235\227\345\217\202\350\200\203/stream/ngx_stream_proxy_module.md"
new file mode 100644
index 0000000..1e3bffe
--- /dev/null
+++ "b/\346\250\241\345\235\227\345\217\202\350\200\203/stream/ngx_stream_proxy_module.md"
@@ -0,0 +1,420 @@
+# ngx_stream_proxy_module
+
+- [示例配置](#example_configuration)
+- [指令](#directives)
+ - [proxy_bind](#proxy_bind)
+ - [proxy_buffer_size](#proxy_buffer_size)
+ - [proxy_connect_timeout](#proxy_connect_timeout)
+ - [proxy_download_rate](#proxy_download_rate)
+ - [proxy_next_upstream](#proxy_next_upstream)
+ - [proxy_next_upstream_timeout](#proxy_next_upstream_timeout)
+ - [proxy_next_upstream_tries](#proxy_next_upstream_tries)
+ - [proxy_pass](#proxy_pass)
+ - [proxy_protocol](#proxy_protocol)
+ - [proxy_requests](#proxy_requests)
+ - [proxy_responses](#proxy_responses)
+ - [proxy_session_drop](#proxy_session_drop)
+ - [proxy_socket_keepalive](#proxy_socket_keepalive)
+ - [proxy_ssl](#proxy_ssl)
+ - [proxy_ssl_certificate](#proxy_ssl_certificate)
+ - [proxy_ssl_certificate_key](#proxy_ssl_certificate_key)
+ - [proxy_ssl_ciphers](#proxy_ssl_ciphers)
+ - [proxy_ssl_crl](#proxy_ssl_crl)
+ - [proxy_ssl_name](#proxy_ssl_name)
+ - [proxy_ssl_password_file](#proxy_ssl_password_file)
+ - [proxy_ssl_protocols](#proxy_ssl_protocols)
+ - [proxy_ssl_server_name](#proxy_ssl_server_name)
+ - [proxy_ssl_session_reuse](#proxy_ssl_session_reuse)
+ - [proxy_ssl_trusted_certificate](#proxy_ssl_trusted_certificate)
+ - [proxy_ssl_verify](#proxy_ssl_verify)
+ - [proxy_ssl_verify_depth](#proxy_ssl_verify_depth)
+ - [proxy_timeout](#proxy_timeout)
+ - [proxy_upload_rate](#proxy_upload_rate)
+
+`ngx_stream_proxy_module` 模块（1.9.0）允许通过 TCP、UDP（1.9.13）和 UNIX 域套接字代理数据流。
+
+
+
+## 示例配置
+
+```nginx
+server {
+ listen 127.0.0.1:12345;
+ proxy_pass 127.0.0.1:8080;
+}
+
+server {
+ listen 12345;
+ proxy_connect_timeout 1s;
+ proxy_timeout 1m;
+ proxy_pass example.com:12345;
+}
+
+server {
+ listen 53 udp reuseport;
+ proxy_timeout 20s;
+ proxy_pass dns.example.com:53;
+}
+
+server {
+ listen [::1]:12345;
+ proxy_pass unix:/tmp/stream.socket;
+}
+```
+
+
+
+## 指令
+
+### proxy_bind
+
+|\-|说明|
+|------:|------|
+|**语法**|**proxy_bind** `address [transparent]` | `off`;|
+|**默认**|——|
+|**上下文**|stream、server|
+|**提示**|该指令在 1.9.2 版本中出现|
+
+使到被代理服务器的出站连接源自指定的本地 IP 地址（`address`）。参数值可以包含变量（1.11.2）。特殊值 `off` 指定不继承上级 `proxy_bind` 指令配置，这使系统可以自动分配本地 IP 地址。
+
+`transparent` 参数（1.11.0）允许到被代理服务器的出站连接源自非本地 IP 地址，例如，来自一个客户端的真实 IP 地址：
+
+```nginx
+proxy_bind $remote_addr transparent;
+```
+
+为了使此参数生效，通常必须使用[超级用户特权](../核心功能.md#user)运行 nginx worker 进程。在 Linux上，如果指定了 `transparent` 则不需要（1.13.8），worker 进程从 master 进程继承 `CAP_NET_RAW` 能力。还需要配置内核路由表以拦截来自被代理服务器的网络流量。
+
+### proxy_buffer_size
+
+|\-|说明|
+|------:|------|
+|**语法**|**limit_conn_log_level** `size`;|
+|**默认**|proxy_buffer_size 16k;|
+|**上下文**|stream、server|
+|**提示**|该指令在 1.9.4 版本中出现|
+
+设置读取被代理服务器数据的缓冲区的大小（`size`）。也用于设置读取客户端数据的缓冲区的大小（`size`）。
+
+### proxy_connect_timeout
+
+|\-|说明|
+|------:|------|
+|**语法**|**proxy_connect_timeout** `time`;|
+|**默认**|proxy_connect_timeout 60s;|
+|**上下文**|stream、server|
+
+设置与被代理服务器建立连接的超时时间。
+
+### proxy_download_rate
+
+|\-|说明|
+|------:|------|
+|**语法**|**proxy_download_rate** `rate`;|
+|**默认**|proxy_download_rate 0;|
+|**上下文**|stream、server|
+|**提示**|该指令在 1.9.3 版本中出现|
+
+限制读取被代理服务器数据的速率。`rate` 以每秒字节数指定。零值禁用速率限制。该限制是针对每个连接设置的，因此，如果 nginx 同时打开两个与被代理服务器的连接，则总速率将是指定限制速率的两倍。
+
+参数值可以包含变量（1.17.0）。如果需要根据特定条件限制速率，可参考以下配置示例：
+
+```nginx
+map $slow $rate {
+ 1 4k;
+ 2 8k;
+}
+
+proxy_download_rate $rate;
+```
+
+### proxy_next_upstream
+
+|\-|说明|
+|------:|------|
+|**语法**|**proxy_next_upstream** `on` | `off`;|
+|**默认**|proxy_next_upstream on;|
+|**上下文**|stream、server|
+
+当连接无法与某个被代理服务器建立连接时，是否将客户端连接传递给下一个服务器。
+
+将连接传递到下一个服务器可能会受到[尝试次数](#proxy_next_upstream_tries)和[时间](#proxy_next_upstream_timeout)的限制。
+
+### proxy_next_upstream_timeout
+
+|\-|说明|
+|------:|------|
+|**语法**|**proxy_next_upstream_timeout** `time`;|
+|**默认**|proxy_next_upstream_timeout 0;|
+|**上下文**|stream、server|
+
+设置将连接传递到[下一个服务器](#proxy_next_upstream)的超时时间。`0` 值关闭此限制。
+
+### proxy_next_upstream_tries
+
+|\-|说明|
+|------:|------|
+|**语法**|**proxy_next_upstream_tries** `number`;|
+|**默认**|proxy_next_upstream_tries 0;|
+|**上下文**|stream、server|
+
+设置将连接传递到[下一个服务器](#proxy_next_upstream)的尝试次数。`0` 值关闭此限制。
+
+### proxy_pass
+
+|\-|说明|
+|------:|------|
+|**语法**|**proxy_pass** `address`;|
+|**默认**|——|
+|**上下文**|server|
+
+设置被代理服务器的地址。该地址可以指定为一个域名或 IP 地址以及端口：
+
+```nginx
+proxy_pass localhost:12345;
+```
+
+或作为 UNIX 域套接字路径：
+
+```nginx
+proxy_pass unix:/tmp/stream.socket;
+```
+
+如果一个域名解析为多个地址，则所有这些地址都将以轮询的方式使用。另外，可以将地址指定为一个[服务器组](ngx_stream_upstream_module.md)。
+
+也可以使用变量（1.11.3）指定地址：
+
+```nginx
+proxy_pass $upstream;
+```
+
+在这种情况下，在配置的[服务器组](ngx_stream_upstream_module.md)中查找服务器名称，如果找不到，则使用一个 [resolver](ngx_stream_core_module.md#resolver)确定服务器名称。
+
+### proxy_protocol
+
+|\-|说明|
+|------:|------|
+|**语法**|**proxy_protocol** `on` | `off`;|
+|**默认**|proxy_protocol off;|
+|**上下文**|stream、server|
+|**提示**|该指令在 1.9.2 版本中出现|
+
+为到被代理服务器的连接启用 [PROXY 协议](http://www.haproxy.org/download/1.5/doc/proxy-protocol.txt)。
+
+### proxy_requests
+
+|\-|说明|
+|------:|------|
+|**语法**|**proxy_requests** `number`;|
+|**默认**|proxy_requests 0;|
+|**上下文**|stream、server|
+|**提示**|该指令在 1.15.7 版本中出现|
+
+设置丢弃客户端和现有 UDP 流会话之间绑定的客户端数据报的数量。在收到指定数量的数据报后，来自同一客户端的下一个数据报将启动一个新会话。当所有客户端数据报都发送到被代理服务器并接收到预期的[响应](#proxy_responses)数时，或者达到[超时时间](#proxy_timeout)时，会话将终止。
+
+### proxy_responses
+
+|\-|说明|
+|------:|------|
+|**语法**|**proxy_responses** `number`;|
+|**默认**|——|
+|**上下文**|stream、server|
+|**提示**|该指令在 1.9.13 版本中出现|
+
+如果使用 [UDP](ngx_stream_core_module.md#udp) 协议，设置响应客户端数据报中来自被代理服务器的数据报期望数。该数字用作会话终止的提示。默认情况下，数据报的数量不受限制。
+
+如果指定零值，则不会响应。但如果收到响应并且会话仍未完成，则该响应将被处理。
+
+### proxy_session_drop
+
+|\-|说明|
+|------:|------|
+|**语法**|**proxy_session_drop** `on` | `off`;|
+|**默认**|proxy_session_drop off;|
+|**上下文**|stream、server|
+|**提示**|该指令在 1.15.8 版本中出现|
+
+设置在将被代理服务器从组中删除或标记为永久不可用后，是否可以终止与被代理服务器的所有会话。在[重新解析](#resolver)或使用了 API [`DELETE`](ngx_http_api_module.md#deleteStreamUpstreamServer) 命令时，可能会发生这种情况。如果服务器处于[不健康](ngx_stream_upstream_hc_module.md#health_check)状态或使用 API [PATCH](ngx_http_api_module.md#patchStreamUpstreamServer) 命令修改，服务器可标记为永久不可用。当为客户端或被代理服务器处理下一个读取或写入事件时，每个会话都会终止。
+
+> 该指令为[商业订阅](http://nginx.com/products/?_ga=2.125901509.99786210.1588592638-1615340879.1588592638)部分。
+
+### proxy_socket_keepalive
+
+|\-|说明|
+|------:|------|
+|**语法**|**proxy_socket_keepalive** `on` | `off`;|
+|**默认**|proxy_socket_keepalive off;|
+|**上下文**|stream、server|
+|**提示**|该指令在 1.15.6 版本中出现|
+
+为到被代理服务器的出站连接配置 **TCP keepalive** 行为。默认情况下，操作系统的设置影响到套接字。如果指令设置为 `on` 值，则将为套接字打开 `SO_KEEPALIVE` 套接字选项。
+
+### proxy_ssl
+
+|\-|说明|
+|------:|------|
+|**语法**|**proxy_ssl** `on` | `off`;|
+|**默认**|proxy_ssl off;|
+|**上下文**|stream、server|
+
+为到被代理服务器的连接启用 SSL/TLS 协议。
+
+### proxy_ssl_certificate
+
+|\-|说明|
+|------:|------|
+|**语法**|**proxy_ssl_certificate** `file`;|
+|**默认**|——|
+|**上下文**|stream、server|
+
+指定一个 PEM 格式的证书文件，用于验证被代理服务器的身份。
+
+### proxy_ssl_certificate_key
+
+|\-|说明|
+|------:|------|
+|**语法**|**proxy_ssl_certificate_key** `file`;|
+|**默认**|——|
+|**上下文**|stream、server|
+
+指定一个 PEM 格式的私钥文件，用于验证被代理服务器的身份。
+
+### proxy_ssl_ciphers
+
+|\-|说明|
+|------:|------|
+|**语法**|**proxy_ssl_ciphers** `ciphers`;|
+|**默认**|proxy_ssl_ciphers DEFAULT;|
+|**上下文**|stream、server|
+
+指定连接到被代理服务器启用的密码算法。密码算法需要 OpenSSL 库支持。
+
+可以使用 `openssl ciphers` 命令查看完整的算法支持列表。
+
+### proxy_ssl_crl
+
+|\-|说明|
+|------:|------|
+|**语法**|**proxy_ssl_crl** `file`;|
+|**默认**|——|
+|**上下文**|stream、server|
+
+指定一个 PEM 格式的吊销证书（CRL）文件，用于[验证](#proxy_ssl_verify)被代理服务器的证书。
+
+### proxy_ssl_name
+
+|\-|说明|
+|------:|------|
+|**语法**|**proxy_ssl_name** `name`;|
+|**默认**|proxy_ssl_name 来自 proxy_pass 的 host;|
+|**上下文**|stream、server|
+
+允许覆盖用于[验证](#proxy_ssl_verify)被代理服务器证书的服务器名称，并在与被代理服务器建立连接时[通过 SNI 传递](#proxy_ssl_server_name)。也可以使用变量（1.11.3）指定服务器名称。
+
+默认情况下，使用 [proxy_pass](#proxy_pass) 地址的主机部分。
+
+### proxy_ssl_password_file
+
+|\-|说明|
+|------:|------|
+|**语法**|**proxy_ssl_password_file** `file`;|
+|**默认**|——|
+|**上下文**|stream、server|
+
+指定一个保存有[密钥](#proxy_ssl_certificate_key)密码的文件，每个密码独占一行。加载密钥时依次尝试使用这些密码。
+
+### proxy_ssl_protocols
+
+|\-|说明|
+|------:|------|
+|**语法**|**proxy_ssl_protocols** `[SSLv2] [SSLv3] [TLSv1] [TLSv1.1] [TLSv1.2] [TLSv1.3]`;|
+|**默认**|proxy_ssl_protocols TLSv1 TLSv1.1 TLSv1.2;|
+|**上下文**|stream、server|
+
+为到被代理服务器的连接启用指定协议。
+
+### proxy_ssl_server_name
+
+|\-|说明|
+|------:|------|
+|**语法**|**proxy_ssl_server_name** `on` | `off`;|
+|**默认**|proxy_ssl_server_name off;|
+|**上下文**|stream、server|
+
+与被代理服务器建立连接时，启用或禁用通过 [TLS 服务器名称指示扩展](http://en.wikipedia.org/wiki/Server_Name_Indication)（SNI、RFC 6066）传递服务器名称。
+
+### proxy_ssl_session_reuse
+
+|\-|说明|
+|------:|------|
+|**语法**|**proxy_ssl_session_reuse** `on` | `off`;|
+|**默认**|proxy_ssl_session_reuse on;|
+|**上下文**|stream、server|
+
+在使用被代理服务器时是否可以重用 SSL 会话。如果日志中出现错误 `SSL3_GET_FINISHED:digest check failed`，请尝试禁用会话重用。
+
+### proxy_ssl_trusted_certificate
+
+|\-|说明|
+|------:|------|
+|**语法**|**proxy_ssl_trusted_certificate** `file`;|
+|**默认**|——|
+|**上下文**|stream、server|
+
+指定一个 PEM 格式的可信 CA 证书文件，该证书用于[验证](#proxy_ssl_verify)被代理服务器的证书。
+
+### proxy_ssl_verify
+
+|\-|说明|
+|------:|------|
+|**语法**|**proxy_ssl_verify** `on` | `off`;|
+|**默认**|proxy_ssl_verify off;|
+|**上下文**|stream、server|
+
+启用或禁用被代理服务器证书验证。
+
+### proxy_ssl_verify_depth
+
+|\-|说明|
+|------:|------|
+|**语法**|**proxy_ssl_verify_depth** `number`;|
+|**默认**|proxy_ssl_verify_depth 1;|
+|**上下文**|stream、server|
+
+设置被代理服务器证书链验证深度。
+
+### proxy_timeout
+
+|\-|说明|
+|------:|------|
+|**语法**|**proxy_timeout** `timeout`;|
+|**默认**|proxy_timeout 10m;|
+|**上下文**|stream、server|
+
+设置客户端或被代理服务器连接两次连续读取或写入操作之间的超时时间（`timeout`）。如果在此时间内没有数据传输，则连接将关闭。
+
+### proxy_upload_rate
+
+|\-|说明|
+|------:|------|
+|**语法**|**proxy_upload_rate** `rate`;|
+|**默认**|proxy_upload_rate 0;|
+|**上下文**|stream、server|
+|**提示**|该指令在 1.9.3 版本中出现|
+
+限制读取客户端数据的速率。该速率以每秒字节数指定。零值禁用速率限制。该限制只针对单个连接，因此，如果客户端同时打开两个连接，则总速率将是指定限制速率的两倍。
+
+参数值可以包含变量（1.17.0）。如果需要根据特定条件设置限制速率，可参考以下配置示例：
+
+```nginx
+map $slow $rate {
+ 1 4k;
+ 2 8k;
+}
+
+proxy_upload_rate $rate;
+```
+
+## 原文档
+
+[http://nginx.org/en/docs/stream/ngx_stream_proxy_module.html](http://nginx.org/en/docs/stream/ngx_stream_proxy_module.html)
\ No newline at end of file
diff --git "a/\346\250\241\345\235\227\345\217\202\350\200\203/stream/ngx_stream_upstream_module.md" "b/\346\250\241\345\235\227\345\217\202\350\200\203/stream/ngx_stream_upstream_module.md"
new file mode 100644
index 0000000..63d35cb
--- /dev/null
+++ "b/\346\250\241\345\235\227\345\217\202\350\200\203/stream/ngx_stream_upstream_module.md"
@@ -0,0 +1,350 @@
+# ngx_stream_upstream_module
+
+- [示例配置](#example_configuration)
+- [指令](#directives)
+ - [upstream](#upstream)
+ - [server](#server)
+ - [zone](#zone)
+ - [state](#state)
+ - [hash](#hash)
+ - [least_conn](#least_conn)
+ - [least_time](#least_time)
+ - [random](#random)
+ - [resolver](#resolver)
+ - [resolver_timeout](#resolver_timeout)
+- [内部变量](#embedded_variables)
+
+`ngx_stream_upstream_module` 模块（1.9.0）用于定义可以由 [proxy_pass](ngx_stream_proxy_module.md#proxy_pass) 指令引用的服务器组。
+
+
+
+## 示例配置
+
+```nginx
+upstream backend {
+ hash $remote_addr consistent;
+
+ server backend1.example.com:12345 weight=5;
+ server backend2.example.com:12345;
+ server unix:/tmp/backend3;
+
+ server backup1.example.com:12345 backup;
+ server backup2.example.com:12345 backup;
+}
+
+server {
+ listen 12346;
+ proxy_pass backend;
+}
+```
+
+拥有定期运行[健康检查](ngx_stream_upstream_hc_module.md)的动态可配置组为[商业订阅](http://nginx.com/products/?_ga=2.130645319.99786210.1588592638-1615340879.1588592638)部分：
+
+```nginx
+resolver 10.0.0.1;
+
+upstream dynamic {
+ zone upstream_dynamic 64k;
+
+ server backend1.example.com:12345 weight=5;
+ server backend2.example.com:12345 fail_timeout=5s slow_start=30s;
+ server 192.0.2.1:12345 max_fails=3;
+ server backend3.example.com:12345 resolve;
+ server backend4.example.com service=http resolve;
+
+ server backup1.example.com:12345 backup;
+ server backup2.example.com:12345 backup;
+}
+
+server {
+ listen 12346;
+ proxy_pass dynamic;
+ health_check;
+}
+```
+
+
+
+## 指令
+
+### upstream
+
+|\-|说明|
+|------:|------|
+|**语法**|**upstream** `name { ... }`;|
+|**默认**|——|
+|**上下文**|stream|
+
+定义一组服务器。服务器可以在不同的端口上监听。此外，可以将监听 TCP 和 UNIX 域套接字的服务器混合使用。
+
+示例：
+
+```nginx
+upstream backend {
+ server backend1.example.com:12345 weight=5;
+ server 127.0.0.1:12345 max_fails=3 fail_timeout=30s;
+ server unix:/tmp/backend2;
+ server backend3.example.com:12345 resolve;
+
+ server backup1.example.com:12345 backup;
+}
+```
+
+默认使用加权轮询均衡算法在服务器间分配连接。在上面的示例中，每 7 个连接将如下分配：5 个连接转到 `backend1.example.com:12345`，一个连接到第二个和第三个服务器。如果在与服务器通信期间发生错误，则连接将被传递到下一个服务器，依此类推，直到尝试完所有正常运行的服务器为止。如果与所有服务器的通信都失败，则连接将关闭。
+
+### server
+
+|\-|说明|
+|------:|------|
+|**语法**|**server** `address [parameters]`;|
+|**默认**|——|
+|**上下文**|upstream|
+
+定义服务器的地址（`address`）和其他参数。该地址可以指定为带有端口的域名或 IP 地址，也可以指定前缀为 `unix` 的 UNIX 域套接字路径。解析为多个 IP 地址的域名一次定义了多个服务器。
+
+可以定义以下参数：
+
+- `weight=number`
+
+ 设置服务器的权重，默认情况下为 1。
+
+- `max_conns=number`
+
+ 限制到被代理服务器的最大同时连接数（1.11.5）。默认值为零，表示没有限制。如果服务器组未驻留在[共享内存](#zone)中，则此限制在每个 worker 进程中均有效。
+
+ > 在 1.11.5 版本之前，此参数作为[商业订阅](http://nginx.com/products/?_ga=2.208745946.99786210.1588592638-1615340879.1588592638)部分。
+
+- `max_fails=number`
+
+ 设置在 `fail_timeout` 参数设置的时间内与服务器通信的失败尝试次数，以便认定服务器在 `fail_timeout` 参数设置的时间内不可用。默认情况下，失败尝试的次数设置为 1。零值将禁用尝试记录。在这里，当与服务器正在建立连接中，失败尝试将是一个错误或超时。
+
+- `fail_timeout=time`
+
+ 设置
+
+ - 在时间范围内与服务器通信的失败尝试达到指定次数，应将服务器视为不可用
+ - 服务器被视为不可用的时长
+
+ 默认情况下，该参数设置为 10 秒。
+
+- `backup`
+
+ 将服务器标记为备用服务器。当主服务器不可用时，连接将传递到备用服务器。
+
+ > 该参数不能与 [hash](#hash) 和 [random](#random) 负载均衡算法一起使用。
+
+- `down`
+
+ 将服务器标记为永久不可用。
+
+此外，以下参数作为[商业订阅](http://nginx.com/products/?_ga=2.134173126.99786210.1588592638-1615340879.1588592638)部分提供：
+
+- `resolve`
+
+ 监视与服务器域名相对应的 IP 地址的更改，并自动修改 upstream 配置，而无需重新启动 nginx。服务器组必须驻留在[共享内存](#zone)中。
+
+ 为了使此参数生效，必须在 [stream](ngx_stream_core_module.md#resolver) 块或相应的 [upstream](#resolver) 块中指定 `resolver` 指令。
+
+- `service=name`
+
+ 启用 DNS [SRV](https://tools.ietf.org/html/rfc2782) 记录的解析并设置服务名称（1.9.13）。为了使此参数生效，必须为服务器指定 [resolve](#resolve) 参数，并指定不带端口号的主机名。
+
+ 如果服务名称不包含点（`.`），则构造符合 [RFC](https://tools.ietf.org/html/rfc2782) 的名称，并将 TCP 协议添加到服务前缀。例如，要查找 `_http._tcp.backend.example.com` SRV 记录，必须指定指令：
+
+ 如果服务名称包含一个或多个点（`.`），则通过将服务前缀和服务器名称结合在一起来构造名称。例如，要查找 `_http._tcp.backend.example.com` 和 `server1.backend.example.com` SRV 记录，必须指定指令：
+
+ ```nginx
+ server backend.example.com service=_http._tcp resolve;
+ server example.com service=server1.backend resolve;
+ ```
+
+ 最高优先级的 SRV 记录（具有相同的最低优先级值的记录）被解析为主服务器，其余的 SRV 记录被解析为备用服务器。如果为服务器指定了 [backup](#backup) 参数，则将高优先级 SRV 记录解析为备用服务器，其余的 SRV 记录将被忽略。
+
+- `slow_start=time`
+
+ 设置当服务器从非健康状态转为健康状态或一段时间[不可用](#fail_timeout)后转为可用状态，服务器将其权重从 0 恢复到原值的时间（`time`）。默认值为零，即禁用此功能。
+
+ > 该参数不能与 [hash](#hash) 和 [random](#random) 负载均衡算法一起使用。
+
+如果组中只有一台服务器，则将忽略 `max_fails`、`fail_timeout` 和 `slow_start` 参数，这样的服务器将永远不会被视为不可用。
+
+### zone
+
+|\-|说明|
+|------:|------|
+|**语法**|**zone** `name [size]`;|
+|**默认**|——|
+|**上下文**|upstream|
+
+定义共享内存区域的名称（`name`）和大小（`size`），以存储 worker 进程之间共享的组配置和运行时状态。多个组可共享同一区域。在这种情况下，仅指定一次大小就足够了。
+
+另外，在[商业订阅](http://nginx.com/products/?_ga=2.171473384.99786210.1588592638-1615340879.1588592638)部分中，此类组允许更改组成员身份或修改特定服务器的设置，而无需重新启动 nginx。可通过 [API](../http/ngx_http_api_module.md) 模块（1.13.3）访问该配置。
+
+> 在 1.13.3 版本之前，只能访问特殊的 location 来通过 [upstream_conf](../http/ngx_http_upstream_conf_module.md#upstream_conf) 处理。
+
+### state
+
+|\-|说明|
+|------:|------|
+|**语法**|**state** `file`;|
+|**默认**|——|
+|**上下文**|upstream|
+|**提示**|该指令在 1.9.7 版本中出现|
+
+指定一个文件用于保存动态可配置组的状态。
+
+示例：
+
+```nginx
+state /var/lib/nginx/state/servers.conf; # path for Linux
+state /var/db/nginx/state/servers.conf; # path for FreeBSD
+```
+
+当前状态仅限于带有参数的服务器列表。解析配置时会读取该文件，并且每次更改 upstream 配置时都会[更新](../http/ngx_http_api_module.md#stream_upstreams_stream_upstream_name_servers_)该文件。应避免直接更改文件内容。该指令不能与 [server](#server) 指令一起使用。
+
+> 在[配置重新加载](../../介绍/控制nginx.md#reconfiguration)或[二进制升级](../../介绍/控制nginx.md#upgrade)期间所做的更改可能会丢失。
+
+> 该指令为[商业订阅](http://nginx.com/products/?_ga=2.128922308.99786210.1588592638-1615340879.1588592638)部分。
+
+### hash
+
+|\-|说明|
+|------:|------|
+|**语法**|**hash** `key [consistent]`;|
+|**默认**|——|
+|**上下文**|upstream|
+
+指定服务器组的负载均衡算法，在该服务器组中，客户端——服务器的映射基于哈希键值（key/value）。key 可以包含文本、变量及其组合（1.11.2）。 用法示例：
+
+```nginx
+hash $remote_addr;
+```
+
+请注意，从组中添加或删除服务器可能会导致大量 key 重新映射到其他服务器。该方法与 [Cache::Memcached](https://metacpan.org/pod/Cache::Memcached) Perl 库兼容。
+
+如果指定了 `consistent` 参数，则将使用 [ketama](https://www.metabrew.com/article/libketama-consistent-hashing-algo-memcached-clients) 一致性哈希算法。该方法可确保在将服务器添加到组中或从组中删除服务器时，只有很少的 key 被重新映射到不同的服务器。这有助于缓存服务器实现更高的缓存命中率。该方法与 `ketama_points` 参数设置为 160 的 [Cache::Memcached::Fast](https://metacpan.org/pod/Cache::Memcached::Fast) Perl 库兼容。
+
+### least_conn
+
+|\-|说明|
+|------:|------|
+|**语法**|**least_conn**;|
+|**默认**|——|
+|**上下文**|upstream|
+
+指定组使用的负载均衡算法，其将连接传递到活动连接数最少的服务器，同时要考虑服务器的权重。如果有多个这样的服务器，则依次使用加权轮询均衡算法进行尝试。
+
+### least_time
+
+|\-|说明|
+|------:|------|
+|**语法**|**least_time** `connect` | `first_byte` | `last_byte` `[inflight]`;|
+|**默认**|——|
+|**上下文**|upstream|
+
+指定组应使用的负载均衡算法，其将连接传递到平均时间最少且活动连接数最少的服务器，同时考虑服务器的权重。如果有多个这样的服务器，则依次使用加权轮询均衡算法进行尝试。
+
+如果指定了 `connect` 参数，则使用[连接](#var_upstream_connect_time)到 upstream 服务器的时间。如果指定了 `first_byte` 变量，则使用接收数据的[首字节](#var_upstream_first_byte_time)的时间。如果指定了 `last_byte`，则使用接收数据[尾字节](#var_upstream_session_time)的时间。如果指定了 `inflight` 参数（1.11.6），还将考虑不完整连接。
+
+> 在 1.11.6 版本之前，默认情况下会考虑不完整的连接。
+
+> 该指令作为[商业订阅](http://nginx.com/products/?_ga=2.162551156.99786210.1588592638-1615340879.1588592638)部分。
+
+### random
+
+|\-|说明|
+|------:|------|
+|**语法**|**random** `[two [method]]`;|
+|**默认**|——|
+|**上下文**|upstream|
+|**提示**|该指令在 1.15.1 版本中出现|
+
+指定组应使用的负载均衡算法，其将连接传递到随机选择的服务器，同时要考虑服务器的权重。
+
+可选的两个参数指示 nginx 随机选择[两个](https://homes.cs.washington.edu/~karlin/papers/balls.pdf)服务器，然后使用指定的算法（`method`）选择一个服务器。默认方法是 `minimum_conn`，它将连接传递到活动连接数最少的服务器。
+
+`minimum_time` 算法将连接传递到平均时间最少且活动连接数最少的服务器。如果指定了 `least_time=connect` 参数，则使用[连接](#var_upstream_connect_time)到 upstream 服务器的时间。如果指定了 `least_time=first_byte` 参数，则使用接收数据的[首字节](#var_upstream_first_byte_time)的时间。如果指定了 `least_time=last_byte`，如果指定了 `last_byte`，则使用接收数据[尾字节](#var_upstream_session_time)的时间。
+
+> `least_time` 算法是[商业订阅](http://nginx.com/products/?_ga=2.200372710.99786210.1588592638-1615340879.1588592638)部分。
+
+### resolver
+
+|\-|说明|
+|------:|------|
+|**语法**|**resolver** `address ... [valid=time] [ipv6=on\|off] [status_zone=zone]`;|
+|**默认**|——|
+|**上下文**|upstream|
+|**提示**|该指令在 1.17.5 版本中出现|
+
+配置用于将 upstream 服务器的名称解析为地址的名称服务器，例如：
+
+```nginx
+resolver 127.0.0.1 [::1]:5353;
+```
+
+可以将地址指定为域名或 IP 地址，配置一个可选端口。如果未指定端口，则使用 53 端口。以轮询算法查找名称服务器。
+
+默认情况下，nginx 在解析时将同时查找 IPv4 和 IPv6 地址。如果不需要查找 IPv6 地址，则可以指定 `ipv6=off` 参数。
+
+默认情况下，nginx 使用响应的 TTL 值缓存回复。可选的 `valid` 参数覆盖默认行为：
+
+```nginx
+resolver 127.0.0.1 [::1]:5353 valid=30s;
+```
+
+> 为防止 DNS 欺骗，建议在一个受到保护的可信本地网络中配置 DNS 服务器。
+
+可选的 `status_zone` 参数启用对指定区域中请求和响应的 DNS 服务器统计信息的[收集](../../http/ngx_http_api_module.md#resolvers_)。
+
+> 该指令为[商业订阅](http://nginx.com/products/?_ga=2.175591914.99786210.1588592638-1615340879.1588592638)部分。
+
+### resolver_timeout
+
+|\-|说明|
+|------:|------|
+|**语法**|**resolver_timeout** `time`;|
+|**默认**|resolver_timeout 30s;|
+|**上下文**|upstream|
+|**提示**|该指令在 1.17.5 版本中出现|
+
+为名称解析设置一个超时时间，例如：
+
+```nginx
+resolver_timeout 5s;
+```
+
+> 该指令为[商业订阅](http://nginx.com/products/?_ga=2.133192262.99786210.1588592638-1615340879.1588592638)部分。
+
+
+
+## 内部变量
+
+`ngx_stream_upstream_module` 模块支持以下内部变量：
+
+- `$upstream_addr`
+
+ 保留 IP 地址和端口或 upstream 服务器的 UNIX 域套接字（1.11.4）路径。如果在代理过程中联系了多个服务器，则它们的地址用逗号分隔，例如 `192.168.1.1:12345, 192.168.1.2:12345, unix:/tmp/sock`。如果无法选择服务器，则该变量将保留服务器组的名称。
+
+- `$upstream_bytes_received`
+
+ 从 upstream 服务器收到的字节数（1.11.4）。来自多个连接的值使用逗号分隔，参考 `$upstream_addr` 变量中的地址。
+
+- `$upstream_bytes_sent`
+
+ 发送到 upstream 服务器的字节数（1.11.4）。来自多个连接的值使用逗号分隔，参考 `$upstream_addr` 变量中的地址。
+
+- `$upstream_connect_time`
+
+ 连接 upstream 服务器的时间（1.11.4），时间以毫秒为单位，以秒为单位。多个连接的时间用逗号分隔，参考 `$upstream_addr` 变量中的地址。
+
+- `$upstream_first_byte_time`
+
+ 接收数据的第一个字节的时间（1.11.4），时间以毫秒为单位，以秒为单位。多个连接的时间用逗号分隔，参考 `$upstream_addr` 变量中的地址。
+
+- `$upstream_session_time`
+
+ 会话持续时间，以毫秒为单位，以毫秒为单位（1.11.4）。多个连接的时间用逗号分隔，参考 `$upstream_addr` 变量中的地址。
+
+## 原文档
+
+[http://nginx.org/en/docs/stream/ngx_stream_upstream_module.html](http://nginx.org/en/docs/stream/ngx_stream_upstream_module.html)
\ No newline at end of file