云端服务由golang语言开发，天然具有跨平台和高性能特点。kkp2p云端服务有四个运行模块，分别是p2p_route、p2p_track、p2p_relay，turnserver，这四个模块均支持分布式部署，即可以分别部署在多台机器上，也可以集中部署在同一台服务器上，整个云端系统可以随着业务规模的变化进行弹性的扩缩容。

     turnserver模块是开源的c++可选模块，如果您需要以下三个功能之一，则必须部署turnserver模块，否则可以不用部署（如果仅使用tcp类型通道，且不需要ipv6穿透功能）。其开源地址为  https://github.com/coturn/coturn.git

     (1)、需要使用udp类型通道

     (2)、需要使用webrtc类型通道

     (3)、需要支持ipv6穿透，此时turnserver必须多配置监听机器的ipv6地址,该ipv6地址要加到turnserver的域名解析中。

    如果您的sdk创建连接使用的是局域网搜索模式，是不需要部署和使用云端服务的。

1、p2p_route模块的配置说明和部署

1.1 模块介绍

    p2p_route是路由模块，里面保存了所有的peer server的登录路由相关的信息。p2p_route一台机器只能部署一个实例，因为p2p_route对外提供的服务端口号只能有一个，该端口号是给peer server登录以及给peer client建连使用的。peer server和peer client支持使用域名或者ip地址进行登录或者建连。当使用域名进行登录或建连时，您可以设计成一个域名对应多台机器，每台机器上部署一个p2p_route实例。kkp2p sdk内部会定时对域名进行解析出ip地址列表，会随机选择一台机器ip进行登录或者建连。

p2p_route对登陆peer数没有限制，能保存多少路由信息，完全由您机器的内存决定。

1.2 启动命令

nohup ./p2p_route -f ./p2p_route.json &

启动命令如上，开头的nohup和最后的&符号表示以后台方式运行。-f后面是配置文件名称

1.3 配置说明

[root@ecs-def8 p2p_route]# cat p2p_route.json 

{

    "public_ip" : "124.71.217.***",

    "route_wan_host": "192.168.0.44:3080",

    "route_lan_host": "192.168.0.44:3081",

    "ocm_lan_host": "192.168.0.44:32917",

     "turn_server": "your-domain:3478",

    "turn_realm": "your-domain",

     "webrtc_conf": {

                "http_wan_host": "192.168.0.44:8080",

                "ssl_cert_file": "/etc/nginx/test.pem",

                "ssl_key_file": "/etc/nginx/test.key"

    }

}

2、p2p_track模块的配置说明和部署

2.1 模块介绍

    p2p_track是实际的登录模块，peer server会登录到p2p_track模块并保持和p2p_track之间的长连接，且定时和p2p_track之间发送心跳消息。peer client和peer server建连的信令协议是通过p2p_track模块进行中转的。

p2p_track同时向外提供NAT探测服务，所以需要云服务器同时放开udp和tcp端口的访问权限。

p2p_track可以部署在一台或者多台机器之上，支持动态扩缩容（增加部署实例即扩容，停止实例服务即缩容）。也支持在一台服务器之上部署多个p2p_track实例，只要这些实例的端口号配置不一样即可。

2.2 启动命令

nohup ./p2p_track -f ./p2p_track.json -l p2p_license &

启动命令如上，开头的nohup和最后的&符号表示以后台方式运行。-f选项后面是配置文件名称, -l选项后面是license文件所存放的目录；如果没有-l选项，默认是程序启动目录下的名为p2p_license的目录。

2.3 配置说明

[root@ecs-def8 p2p_track]# cat p2p_track.json 

{

    "public_ip": "124.71.217.***",

    "track_wan_host": "192.168.0.44:3380",

    "route_lan_hosts": [

        "192.168.0.44:3081"

    ],

    "ocm_lan_host": "192.168.0.44:32918",  

    "webrtc_conf": {

        "websocket_wan_host": "192.168.0.44:8090"

     }

}

2.4 license目录以及license文件

    license目录存放了所有的license文件，license文件必须由深圳库快科技有限公司提供。具体一个license文件举例如下：[root@ecs-def8 p2p_license]# cat license_id.txt 

kkuai-ipc-00001 WtXmjG

kkuai-ipc-00002 OBq26M

license-sign AUav2LFuXS5TWFwxJ3NLDL*************************

    该配置文件一共有三行。第一行和第二行是两个登录账号以及各自的密码，用于对登录的peer的签名信息进行鉴权，保障云端服务的安全性，只允许合法的账号进行登录。最后一行是深圳市库快科技有限公司的签名信息。您必须通过在深圳库快科技有限公司的官网上通过购买方式合法获取license文件，否则程序运行会出现异常。

    license文件可以按照业务的发展情况按量分多批次购买，统一放在该目录下，程序启动时候会一次性读取该目录下所有的license文件信息。

    友善提醒您，您购买的license登录账号个数只要超过您的最大同时在线设备数即可，可以在您的业务逻辑里面实现设备在线时候动态获取登录账号和密码，设备离线时候动态回收，这样可以极大节约您的购买成本。另外在很多场景，比如通过手机app观看网络摄像头，作为连接的服务端（peer server），只有网络摄像头需要购买license账号和密码进行登录；作为主动发起连接的手机app客户端（peer client），是不需要使用登录账号和密码的。

2.5 open files数限制

    一般对于linux系统，每个进程能够打开的句柄数（包括socket句柄）是有限制的，可以通过ulimit -a命令查看限制，如下图所示：

ubuntu下系统缺省值是65535，因此最多只支持65535个设备同时在线，建议将该值改为655350，即单机支持65万设备同时在线。ubuntu下通过vi命令修改文件 /etc/security/limits.conf，将里面的65535改为655350，修改完毕后执行reboot命令重启生效。

经过测试，在4核（2500MHz）8G服务器（8G内存，400% cpu资源），p2p track至少支持25W设备同时在线（实耗3.6G内存、59% cpu），因此理论上单台4核8G服务器应该可以同时支持50W设备同时在线。

3、p2p_relay模块的配置说明和部署

3.1 模块介绍

    p2p_relay是中转模块，当两个peer之间NAT穿透失败无法直接通信时候，就通过p2p_relay模块中转方式进行通信。p2p_relay模块必须部署在带宽比较充足的云服务器上，您才会获取得较好的中转性能，具体需要的中转带宽和性能您可以根据自己的业务量和业务特性进行评估。

p2p_relay可以部署在一台或者多台机器之上，支持动态扩缩容（增加部署实例即扩容，停止实例服务即缩容）。也支持在一台服务器之上部署多个p2p_relay实例，只要这些实例的端口号配置不一样即可。

3.2 启动命令

nohup ./p2p_relay -f ./p2p_relay.json -l p2p_license &

启动命令如上，开头的nohup和最后的&符号表示以后台方式运行。-f选项后面是配置文件名称, -l选项后面是license文件所存放的目录；如果没有-l选项，默认是程序启动目录下的名为p2p_license的目录。

3.3 配置说明

[root@ecs-def8 p2p_relay]# cat p2p_relay.json 

{

    "public_ip":"124.71.217.***",

    "relay_wan_host": "192.168.0.44:3280",

    "route_lan_hosts":[

         "192.168.0.44:3081"

        ],

    "ocm_lan_host":"192.168.0.44:32919"

}

3.4 license目录以及license文件

和2.4章节介绍相同。

4、coturn模块的配置说明和部署

4.1 模块介绍

    coturn是一个开源服务，向外提供stun/turn服务。turnserver可以进行集群化部署，通过域名进行访问。

    由于coturn是一个开源服务，因此不是库快公司的正式对外交付件，用户可以取开源代码自行编译最新版本，以及查阅资料自行进行安装。官网上免费下载个人版云端服务中提供了库快科技编译的corturn服务的各模块binary以及配置文件模板，提供用户参考。一般安装时需要先安装libssl-dev、libevent-dev和sqlite数据库。

    本文档仅用于描述corturn服务的配置参考，以及和kkp2p sdk相关的一些操作。

4.2 启动命令

nohup ./turnserver -f -r your-realm -c ../etc/turnserver.conf &

启动命令如上，开头的nohup和最后的&符号表示以后台方式运行。-c选项后面是配置文件名称；-r后面的your-realm需要替换成实际的realm配置，一般是部署turnserver服务器的访问域名

4.3 配置说明

root@test-aliyun:~/test# cat tunserver.conf

no-rfc5780

no-stun-backward-compatibility

response-origin-only-with-rfc5780

listening-port=3478

listening-ip=172.17.241.15

# listening-ip=2408:xxxx:10e9:xxxx:xxxx:xxxx:xxxx:8e4c

relay-device=eth0

relay-ip=172.17.241.15

external-ip=224.75.168.66

min-port=10000

max-port=65535

verbose

fingerprint

lt-cred-mech

realm=test.com

userdb=/usr/local/var/db/turndb

4.4 账号配置操作

     为了安全起见，需要将p2p登录账号和密码配置到turnserver系统中，让turnserver可以对客户端进行鉴权操作，拒绝非法访问。

     为了方便批量导入，库快提供了一个脚本，脚本内容如下：

     root@test-aliyun:/usr/local/coturn/bin# cat batch-turn-perm.sh

#!/bin/bash
if [ $# -lt 3 ] ; then
    echo "usage: $0 your-license-file your-turn-sqlite-db your-turn-realm"
    exit 1;
fi
while read id key
do
  if [ "$id" == "license-sign" ];then
      continue
  fi
  echo ./turnadmin -a -b $2 -u $id -p $key -r $3
  ./turnadmin -a -b $2 -u $id -p $key -r $3
done < $1

脚本用法如下

./batch-turn-perm.sh your-license-file your-turn-sqlite-db your-turn-realm

第1个参数为p2p账号license文件，第2个参数为sqlite的数据文件名（见配置项说明），第三个参数为turnserver的realm配置（见配置项说明）

以下命令可以查看当前turnserver中配置了哪些账号，-b后面的参数为实际的db文件名

./turnadmin  -l  -b  /usr/local/var/db/turndb