update

im-pingo · im-pingo · commit 1f6da9daa32b · 2020-04-16T01:27:43.000+08:00
diff --git a/docs/zh/2.13-config-dns.md b/docs/zh/2.13-config-dns.md
@@ -0,0 +1,95 @@
+---
+title: 动态DNS查询
+permalink: /docs/zh/config-dns
+key: docs-config-dns-zh
+---
+
+
+## 适用场景
+
+[notify](./config-notify)、[pull](./config-dir-pull)、[push](./config-dir-push)操作过程中会使用到域名，动态dns查询支持动态更新域名解析。
+{:.success}
+^
+
+## 配置
+
+### resolver
+
+*Syntax:* `resolver [dns-server];`  
+*Default:* -  
+*Context:* event 
+
+* **Desc**  
+> 向DNS服务器查询服务器中使用到的域名。
+
+### resolver_timeout
+*Syntax:* `resolver_timeout [time];`  
+*Default:* 60s  
+*Context:* event 
+
+* **Desc**  
+> 等待DNS服务器返回结果的超时时间。  
+
+### dynamic_refresh_interval
+*Syntax:* `dynamic_refresh_interval [time];`  
+*Default:* 5s  
+*Context:* event 
+
+* **Desc**  
+> 更新域名解析结果的间隔时间。  
+
+## 配置模板
+
+```nginx
+user  root;
+daemon off;
+master_process off;
+worker_processes  1;
+#worker_rlimit 4g;
+
+#error_log  logs/error.log;
+#error_log  logs/error.log  notice;
+error_log  logs/error.log  info;
+
+worker_rlimit_nofile 102400;
+worker_rlimit_core   2G;
+working_directory    /tmp;
+
+#pid        logs/nginx.pid;
+
+events {
+    use epoll;
+    worker_connections  1024;
+    multi_listen unix:/tmp/http 80;
+    multi_listen unix:/tmp/rtmp 1935;
+
+    dynamic_refresh_interval 2s; # DNS更新间隔
+#    dynamic_domain_buckets   1001;
+    resolver 114.114.114.114; # DNS服务器
+    resolver_timeout 30s; # DNS超时查询
+}
+
+rtmp {
+    server {
+        listen 1935;
+
+        application * {
+            pull rtmp://live.pingos.io/live/ice app=live; # 对域名 live.pingos.io 解析
+            live on;
+        }
+    }
+}
+
+http {
+    include       mime.types;
+    default_type  application/octet-stream;
+
+    server {
+        listen 80;
+        location / {
+             chunked_transfer_encoding on;
+             root html/;
+        }
+    }
+}
+```
diff --git a/docs/zh/2.13-config-multiple-process.md b/docs/zh/2.13-config-multiple-process.md
@@ -0,0 +1,101 @@
+---
+title: 多进程模式
+permalink: /docs/zh/config-multiple-process
+key: docs-config-multiple-process-zh
+---
+
+### 进程间回源
+
+```mermaid
+graph LR;
+    pub[推流端]
+    p0[worker进程0]
+    p1[worker进程1]
+    p2[worker进程2]
+    pl0[拉流端0]
+    pl1[拉流端1]
+    pl2[拉流端2]
+    pl3[拉流端3]
+    pub-->p0
+    p0-->p1
+    p0-->p2
+    p1-->pl0
+    p1-->pl1
+    p2-->pl2
+    p2-->pl3
+```
+
+在nginx多进程情况下rtmp或http连接被分配到不同worker进程，推流端连接和拉流端连接可能会被分配到不同进程，从而导致一定概率的无法拉流。  
+为了解决这个问题，我们可以让其他进程向推流端连接的进程回源。由于这种方式跟跨服务器之间的回源逻辑一致，所以我们将这种操作称为`进程间回源`{:.error}。
+{:.info}
+
+### 配置
+
+#### rtmp_auto_pull
+*Syntax:* `rtmp_auto_pull on|off`  
+*Default:* `off`{:.info}  
+*Context:* rtmp, server, application
+
+* **Desc**  
+进程间回源开关，on 开启进程间回源，off关闭进程间回源，如果你希望使用nginx的多进程模式，已经要将这个配置设置成on。  
+
+---
+
+#### rtmp_auto_pull_port
+
+*Syntax:* `rtmp_auto_pull_port value`  
+*Default:* -  
+*Context:* rtmp, server, application
+
+* **Desc**  
+进程间回源所使用的unix套接字地址，需要注意的是此地址必须要与`multi_listen`中的保持一致。  
+
+#### multi_listen
+*Syntax:* `multi_listen [unix socket] [rtmp port]`  
+*Default:* -  
+*Context:* event
+
+* **Desc**  
+multi_listen的作用是让每个worker进程监听不同的unix套接字，然后通过向不同unix套接字推拉流实现多进程的流共享。
+
+### 配置模板
+
+    ```nginx
+    user  root;
+    daemon on;
+    master_process on;
+    worker_processes 6; # 开启6个worker进程
+
+    error_log  logs/error.log  info;
+
+    events {
+        use epoll;
+        worker_connections  1024;
+        multi_listen unix:/tmp/rtmp 1935; # 为1935端口开启多进程端口映射，每个进程都开启一个unix套接字映射到1935端口上
+    }
+
+    rtmp {
+        rtmp_auto_pull on;
+        rtmp_auto_pull_port unix:/tmp/rtmp; # 进程间回源使用的unix套接字地址，该地址必须与 multi_listen 中的配置一致
+        server {
+            listen 1935;
+            application live {
+                live on;
+            }
+        }
+    }
+
+    http {
+        server {
+            listen 80;
+            location /flv {
+                flv_live 1935 app=live;
+            }
+
+            location /ts {
+                ts_live 1935 app=live;
+            }
+        }
+    }
+
+    ```
