本地代理

1.（可选）搭建 Nginx 服务器

请您自行搜索 Nginx 服务器搭建相关教程，完成 Nginx 服务器搭建。如果您之前已搭建完成，请忽略本步骤。

2. 配置 Nginx 服务器

vi /etc/nginx/nginx.conf

在 Nginx 配置中添加 server 内容。

server { 
    # nginx 服务器域名
    server_name proxy.example.com;
    # nginx 服务器的访问端口
    listen 443 ssl;
    ssl_certificate ./cert.pem;
    ssl_certificate_key ./key.pem;
    proxy_ssl_server_name on;
    proxy_ssl_session_reuse off;

    location /accesshub/ { # 对应 setLocalProxyConfig 中的 accesshubProxy 参数
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade; 
        proxy_set_header Connection "upgrade";
        rewrite ^/accesshub/(.*)$ /$1 break; # 将localtion 的路径进行重写到域名根路径
        proxy_pass https://accesshub-wss.example.com;  # 该域名为示例，域名后面不要带路径。域名由ZEGO提供。
    }

    location /logger/ { # 对应 setLocalProxyConfig 中的 loggerProxy 参数
        proxy_http_version 1.1; 
        proxy_set_header Upgrade $http_upgrade; 
        proxy_set_header Connection "upgrade"; 
        rewrite ^/logger/(.*)$ /$1 break; # 将localtion 的路径进行重写到域名根路径
        proxy_pass https://weblogger.example.com;  # 该域名为示例，域名后面不要带路径。域名由ZEGO提供。
    }
}

假设：

1. Nginx 代理服务器域名 server_name 为 proxy.example.com；
2. ZEGO Express SDK 原直连的信令服务域名 proxy_pass 为 accesshub-wss.example.com。
3. 通过 SDK 的 setLocalProxyConfig 接口设置 accesshubProxy 为 proxy.example.com/accesshub。

后续 SDK 接口对 accesshub-wss.example.com 的所有请求，都会将域名部分替换为 proxy.example.com/accesshub 后作为请求地址请求 Nginx 代理，Nginx 服务器再对原请求地址发起请求。

例如，实际 Nginx 请求地址（即原直连的请求接口地址）为 “wss://accesshub-wss.example.com/accesshub”，而 SDK 的代理请求地址为 “wss://proxy.example.com/accesshub/accesshub”。

3. 执行重新加载 Nginx

nginx -s reload

至此，Nginx 服务器部署完毕。

coturn 是一种开源的 STUN/TURN 服务器。可以用于搭建一个能够在 NAT 防火墙和代理服务器背后运行的实时通信系统。

1. （可选）安装 coturn

请您自行搜索 coturn 服务器搭建相关教程，完成 coturn 服务器搭建。如果您之前已搭建完成，请忽略本步骤。

以在 CentOS 中搭建 coturn 服务器为例，执行如下命令，安装 coturn。

yum install coturn

执行如下命令，如果输出结果为 /usr/bin/turnserver，则表示安装 coturn 成功。

which turnserver

2. 配置运行参数

1. 创建配置文件。

cd /etc/
sudo mkdir coturn && cd coturn
sudo vim turnserver.conf

2. 编辑基本配置。

listening-port=3478
external-ip=xx.xx.xx.xx
min-port=30000
max-port=60000
verbose
fingerprint
realm=zego.im
cert=**/**/turn_server_cert.pem
pkey=***/**/turn_server_pkey.pem
log-binding
no-stun
no-rfc5780
no-stun-backward-compatibility
response-origin-only-with-rfc5780
log-file=/var/log/coturn/turnserver.log
use-auth-secret=yes
static-auth-secret=*zego*

3. 生成 coturn 登录凭证

开发者可以使用 turnserver.conf 中配置的静态秘钥参数 static-auth-secret，在自己的业务后台生成 coturn 登录凭证，通过接口提供给客户端。

使用 Node.js 生成登录凭证，参考示例代码如下：

const crypto = require("crypto");

// 凭证有效期的结束时间点，单位秒。这里示例是当前时间点的 86400s 后
const end_ts = Math.floor(new Date().getTime() / 1000) + 86400;
function getCredential(endTime, userName) {
    // screctKey 为 turnserver.conf 中 static-auth-secret 填写的静态密钥。
    const screctKey = "*zego*";
    const username_ts = endTime.toString() + ":" + userName;
    const method = crypto.createHmac("sha1", screctKey);
    method.setEncoding("base64");
    method.write(username_ts);
    method.end();
    return {
        username: username_ts,
        credential: method.read()
    };
}

const { credential, username } = getCredential(end_ts, "test");

console.log("username: " + username);
console.log("credential: " + credential);

客户端获取到上述的 username 和 credential 后，调用 SDK 的 setTurnServer 接口，传入对应的参数，与 turn server 建立连接。

zg.setTurnServer([{
    url: "turn:1.2.3.4:3478?transport=udp", // 1.2.3.4:3478 为 turn server 配置的 external-ip 和 listening-port
    username: username,
    credential: credential
}]);

3. 运行 coturn

sudo systemctl start coturn

执行如下命令，确认 coturn 是否运行成功。

# 查看进程是否启动
ps aux | grep turnserver
# 通过 systemctl 查看 coturn 启动状态
sudo systemctl status coturn

如果 coturn 运行失败、出现 status=127 错误提示，可能是用户没有权限执行文件。执行如下命令，给 coturn 的可执行文件添加权限。

chmod -x /usr/bin/turnserver

然后修改 coturn.service 文件。

sudo vim /usr/lib/systemd/system/coturn.service

将文件内容中的 User 和 Group 配置改为有执行权限的 root 用户和用户组。示例如下：

# 省略文件前面部分内容
[Service]
User=root
Group=root
# 省略文件后面部分内容

修改完成，保存文件之后，再次运行 coturn。

sudo systemctl daemon-reload
# 再次运行 coturn
sudo systemctl start coturn

4. 测试 turn server

前往 测试页面，测试您搭建好的 turn server 是否能够正常连通访问。如果最后一行显示 Done，则表示连通性正常。

至此，coturn 服务器部署完毕。