WebRTC之Kurento开发实践（一）Kurento Server安装

ゞ浴缸里的玫瑰 2022-12-23 06:49 630阅读 0赞

先来两篇扫盲文章，大致有个了解：

> [基于Kurento搭建WebRTC服务器][Kurento_WebRTC]

> [实现 WebRTC 的几个想法][WebRTC]

其他资料：

> [kurento和打洞的服务器的安装及部署][kurento]

## 安装KMS （Kurento Media Server） ##

推荐使用`Docker`安装，如果没有安装`Docker`，这里有个安装教程：Centos安装Docker

打开Docker相关页面：[Docker Hub][]，按照官方说明来

1.  安装镜像：

$ docker run -d --name kms -p 8888:8888 kurento/kurento-media-server:latest

![8e51107173d47223382942a68d3040e9.png][]

1.  检查KMS是否已准备就绪并且正在侦听，请发出以下命令（您需要在系统上安装curl）

$ curl -i -N -H "Connection: Upgrade" -H "Upgrade: websocket" -H "Host: 127.0.0.1:8888" -H "Origin: 127.0.0.1" http://127.0.0.1:8888/kurento

如果出现以下情况，说明启动成功，不要在意错误提示，这是一个预期的错误，因为curl命令不会说KMS理解的协议。我们只是在检查服务器是否启动并正在侦听连接。

![7c24bc75b8d12a4ddc1ae8c8a968857b.png][]

1.  KMS 日志

服务器日志可通过Docker公开其容器的日志的常规方式获得。因此，假设您为容器`kms`命名（使用`--name kms`，如上例所示）：

$ docker logs kms

您可能还想实时跟踪日志，可以使用`-f`或`--follow`来实现：

$ docker logs -f kms

1.  环境变量

*  调试日志

KMS使用环境变量`GST_DEBUG`定义所有基础模块的调试级别。设置此变量可以更改KMS生成的日志的详细程度：

$ docker run -d --name kms -p 8888:8888 -e GST_DEBUG="Kurento*:5" kurento/kurento-media-server:latest

检查有关[调试日志][Link 1]的文档部分，以获取有关此环境变量和其他环境变量的更多信息。

## docker安装stun和turn服务器（打洞服务器） ##

1.  安装git，做好基本配置

$ yum install git -y
    $ git config --global user.name "xxx"
    $ git config --global user.email "xxxx@xxxx.com"

1.  拉取`coturn`一个安装工具仓库

$ git clone https://github.com/konoui/kurento-coturn-docker.git
    $ cd /kurento-coturn-docker/coturn/
    // 使用dockerfile,记住加点

使用`Dockerfile`安装镜像

$ sudo docker build --tag coturn .
    // 后台运行coturn
    $ sudo docker run -p 3478:3478 -p 3478:3478/udp coturn

出现错误：

![104f6dbc206a8ec7c3a1229bbda3f19d.png][]

原因可能是`https://ubuntu.com/esm`不能再使用，或者不能再免费使用，需要登录授权，我尝试了一下，可以打开`Dockerfile`暂时把`curl/`这一行去掉，先不安装这个工具。

![d6c606d80099d39f07a2ec2f7c573c34.png][]

安装成功之后需要测试一下，打开页面：[https://webrtc.github.io/samples/src/content/peerconnection/trickle-ice/][https_webrtc.github.io_samples_src_content_peerconnection_trickle-ice]

这个dockerfile给你配置turn的用户名和密码都是kurento，在页面中对应的位置填入服务器信息，如图：

![46482719ef200a4577f8d4e5e7112da5.png][]

点击`Add Server`，调整一下参数，点击下面的`Gather candidates`按钮，如果出现如下图的结果，并且服务器有输出日志，说明，成功了。

![27fc5fda7d2df1703f9a8d54731a8fba.png][]

![431c0892fffd7a51b7f935fdc18b0bc3.png][]

浏览器输入：`IP + PORT`，测试一下，出现如下页面：

![c90437a1c36399d0eda80b6878fe2239.png][]

> 测试最好使用`FireFox浏览器`，`Chrome`有时候会出现错误：`The server stun:xxx.xxx.xxx.xxx:3478 returned an error with code=701: STUN server address is incompatible.`

## 测试搭建是否成功 ##

使用官方`helloworld Node.js`版本测试：

curl -sL https://deb.nodesource.com/setup_8.x | sudo -E bash -
    sudo apt-get install -y nodejs
    sudo npm install -g bower
    git clone https://github.com/Kurento/kurento-tutorial-node.git
    cd kurento-tutorial-node/kurento-hello-world
    git checkout 6.12.0
    npm install
    cd static
    bower install --allow-root
    cd ../
    npm start

> 其中需要注意的是：nodejs不要安装过低的版本，推荐适应`nvm`切换最新稳定版。如果使用的`root`用户，`bower install`后面要跟参数`--allow-root`。不推荐使用`cnpm`，会出现莫名奇妙的错误。

运行可能会出现如下错误：

`TypeError: Cannot read property 'unmask' of undefined at Receiver.unmask`

![948758e1833927c4600c0b072fa10d8c.png][]

这是`package.json`中的`ws`的版本过低`"ws": "~1.0.1"`

或者出现`TypeError: Cannot read property 'session' of undefined`

![1b1ea3b32d42bda7897aa019410b1ca3.png][]

这是`package.json`中的`ws`的版本过高`"ws": "^7.1.0"`

这两种错误都需要手动把`package.json`中的`ws`版本改成`"ws": "~2.0.2"`

这时候，再次运行，打开页面，会发现，还是不成功。

\[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-KXfkFOsJ-1606109602389)(11.png)\]

\[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-ER8OatmS-1606109602390)(12.png)\]

进入`kurento-media-server docker`：`docker exec -it kms /bin/bash`，进入`/var/log/kurento-media-server/`，查看日志文件，发现最后一行有一个错误：

![3918b5a4dcb4a28c9b643eda0567ee9f.png][]

## 简单使用 ##

[官方`Node.js Client`文档][Node.js Client]

[Kurento_WebRTC]: https://blog.gmem.cc/webrtc-server-basedon-kurento
[WebRTC]: https://www.infoq.cn/article/webrtc-implementation-ideas
[kurento]: https://blog.csdn.net/XRRRICK/article/details/85010829
[Docker Hub]: https://hub.docker.com/r/kurento/kurento-media-server
[8e51107173d47223382942a68d3040e9.png]: /images/20221120/9c45d5c6f4f7468fa6ef48ec82587a26.png
[7c24bc75b8d12a4ddc1ae8c8a968857b.png]: https://img-blog.csdnimg.cn/img_convert/7c24bc75b8d12a4ddc1ae8c8a968857b.png
[Link 1]: https://doc-kurento.readthedocs.io/en/stable/features/logging.html
[104f6dbc206a8ec7c3a1229bbda3f19d.png]: https://img-blog.csdnimg.cn/img_convert/104f6dbc206a8ec7c3a1229bbda3f19d.png
[d6c606d80099d39f07a2ec2f7c573c34.png]: https://img-blog.csdnimg.cn/img_convert/d6c606d80099d39f07a2ec2f7c573c34.png
[https_webrtc.github.io_samples_src_content_peerconnection_trickle-ice]: https://webrtc.github.io/samples/src/content/peerconnection/trickle-ice/
[46482719ef200a4577f8d4e5e7112da5.png]: https://img-blog.csdnimg.cn/img_convert/46482719ef200a4577f8d4e5e7112da5.png
[27fc5fda7d2df1703f9a8d54731a8fba.png]: https://img-blog.csdnimg.cn/img_convert/27fc5fda7d2df1703f9a8d54731a8fba.png
[431c0892fffd7a51b7f935fdc18b0bc3.png]: https://img-blog.csdnimg.cn/img_convert/431c0892fffd7a51b7f935fdc18b0bc3.png
[c90437a1c36399d0eda80b6878fe2239.png]: https://img-blog.csdnimg.cn/img_convert/c90437a1c36399d0eda80b6878fe2239.png
[948758e1833927c4600c0b072fa10d8c.png]: https://img-blog.csdnimg.cn/img_convert/948758e1833927c4600c0b072fa10d8c.png
[1b1ea3b32d42bda7897aa019410b1ca3.png]: https://img-blog.csdnimg.cn/img_convert/1b1ea3b32d42bda7897aa019410b1ca3.png
[3918b5a4dcb4a28c9b643eda0567ee9f.png]: https://img-blog.csdnimg.cn/img_convert/3918b5a4dcb4a28c9b643eda0567ee9f.png
[Node.js Client]: https://doc-kurento.readthedocs.io/en/6.11.0/_static/client-jsdoc/index.html