共计 4643 个字符,预计需要花费 12 分钟才能阅读完成。
本文主要面向需要在自己系统中集成视频会议的读者。
原文发布在 腾讯云计算社区 https://cloud.tencent.com/developer/article/1923349,如果论坛存在排版问题,可以到原文观看。
客户要求在页面中集成视频会议功能,本来刚开始准备直接用腾讯云的服务来实现,但是客户说他们完全是一个不能访问互联网的局域网的环境,因此需要部署一个自托管的视频会议服务器,并且这个视频会议服务器需要提供相应的接口来和自己的项目集成。经过一些调研,发现了一些不错的第三方开源的项目。今天介绍的是其中的一个 openvidu,其采用的是 WEBRTC 技术,功能基本上可以满足我们目前的需要,而且采用 Docker 部署的话也十分方便。
openvidu 虽然自身也提供了视频会议的 Web 页面,但是十分简陋,其主要还是面向的开发用户,用来在自己开发的系统中集成视频会议功能。
前期的测试主要还是在公网环境下运行,因此需要采购一台公网的服务器来做开发测试使用。根据官网的要求,服务器配置至少需要 2 核 CPU 以及 8G 的内存配置,并且需要充足的带宽。基于成本考虑,我们最终购买了腾讯云轻量服务器的 4 核 8G10M 带宽配置,后续都基于这个服务器进行部署搭建。
由于浏览器安全协议的限制,除了使用 localhost 地址访问以后,浏览器会禁止 HTTP 协议的页面使用摄像头。因此下面的过程中需要配置证书。openvidu 支持自己配置证书,也支持使用 letsencrypt 自动签发证书。如果使用 letsencrypt 自动签发证书的话,需要使用域名指向服务器 IP,使用国内的服务器域名需要备 案。如果没有备 案的域名的话,可以选择购买同配置香港的轻量服务器。
购买服务器
如果没有服务器的话,需要先购买一台腾讯云的轻量服务器。
轻量应用服务器(TencentCloud Lighthouse)是新一代开箱即用、面向轻量应用场景的云服务器产品,助力中小企业和开发者便捷高效的在云端构建网站、小程序 / 小游戏、电商、云盘 / 图床以及各类开发测试和学习环境,相比普通云服务器更加简单易用,提供高带宽流量包并以套餐形式整体售卖基础云资源,将热门开源软件融合打包实现一键构建应用,是您使用腾讯云的最佳入门途径。为了方便安装应用,我们需要准备 Docker 环境。
Docker 是一个开源的应用容器引擎,让开发者可以打包他们的应用以及依赖包到一个可移植的容器中, 然后发布到任何流行的 Linux 或 Windows 操作系统的机器上, 也可以实现虚拟化, 容器是完全使用沙箱机制, 相互之间不会有任何接口。使用 docker 来部署应用是非常简单的,一般情况下,只需要一行命令即可完成。
腾讯云经常举办各种活动,可以点击这里进入他们的活动页面进行购买 (注意根据官网要求,配置至少要求为 8G 以上),可以选择距离最近的区域购买,不过不想备 案的话,可以选择境外的服务器 (比如香港区域) 进行购买。镜像的话,选择【官方镜像】下的【docker 基础镜像】,实例套餐选择适合自己的,然后提交订单,付款即可。如果不选择【Docker 基础镜像】,后面需要自行安装 docker 容器。
安装 docker 以及 docker-compose
如果没有选择 docker 基础镜像,则需要自行安装 docker 镜像。这里假设使用的 Ubuntu 系统。安装 docker 的步骤如下
- sudo apt-get update
- sudo apt-get install ca-certificates curl gnupg lsb-release
- curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg –dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
- echo \
- “deb [arch=$(dpkg –print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu \
- $(lsb_release -cs) stable” | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
- sudo apt-get update
- sudo apt-get install docker-ce docker-ce-cli containerd.io
然后安装 docker-compose
- sudo curl -L “https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(uname -s)-$(uname -m)” -o /usr/local/bin/docker-compose
- sudo chmod +x /usr/local/bin/docker-compose
- docker-compose –version
配置安全组
视频会议功能内部采用 WEBRTC 技术,会使用比较多的端口,因此需要在轻量服务器的防火墙策略上放行相应的端口,目前官网上要求开放的端口如下。
22 TCP: SSH 端口
80 TCP: HTTP 端口
443 TCP:HTTPS 端口
3478 TCP+UDP: TURN 服务器端口,TURN 服务器是在视频双方无法直接建立点对点连接时进行流量转发使用
40000 – 57000 TCP+UDP: Kurento Media Server 建立媒体连接的端口
57001 – 65535 TCP+UDP: TURN 服务器建立媒体连接的端口。
除此之外,请确保这些端口 80, 443, 3478, 5442, 5443, 6379 和 8888 不能被占用
如果嫌麻烦而且仅仅是测试环境使用,可以直接放行所有的端口。
域名解析
将要使用的域名解析到服务器的 IP 上。如果使用的是国内的服务器,域名需要备 案。如果没有备 案的域名,需要选购香港的服务器。或者也可以不使用域名,直接使用 IP。直接使用 IP 的话,需要自己来签发并配置证书并配置浏览器信任证书。
开始安装部署
准备工作做完以后,就可以开始下载安装了。默认在 /opt 目录下进行安装
首先进入到 /opt 目录下
- cd /opt
然后使用 openvidu 提供的脚本进行安装
- curl https://s3-eu-west-1.amazonaws.com/aws.openvidu.io/install_openvidu_latest.sh | bash
由于政策原因,在国内服务器上可能下载会失败,可以先在科学上网的环境下安装好,然后把相应的文件上传到服务器的安装目录里。
进入到 openvidu 目录里
- cd /openvidu
使用熟悉的工具来编辑.env 文件,本文档中使用 letsencrypt 来自动签发证书(ov 的默认选项),只需要修改下面几项配置。
- DOMAIN_OR_PUBLIC_IP= 自己的域名
- OPENVIDU_SECRET=xxxxxx #密钥,换成一个安全系数高的
- LETSENCRYPT_EMAIL=xx@xx.com #换成自己的邮箱
或者不使用 letsencrypt 签发证书,来自行配置证书。具体配置方法在.env 文件中有详细说明。
- # OpenVidu configuration
- # ———————-
- # Documentation: https://docs.openvidu.io/en/stable/reference-docs/openvidu-config/
- # NOTE: This file doesn’t need to quote assignment values, like most shells do.
- # All values are stored as-is, even if they contain spaces, so don’t quote them.
- # Domain name. If you do not have one, the public IP of the machine.
- # For example: 198.51.100.1, or openvidu.example.com
- DOMAIN_OR_PUBLIC_IP=
- # OpenVidu SECRET used for apps to connect to OpenVidu server and users to access to OpenVidu Dashboard
- OPENVIDU_SECRET=
- # Certificate type:
- # – selfsigned: Self signed certificate. Not recommended for production use.
- # Users will see an ERROR when connected to web page.
- # – owncert: Valid certificate purchased in a Internet services company.
- # Please put the certificates files inside folder ./owncert
- # with names certificate.key and certificate.cert
- # – letsencrypt: Generate a new certificate using letsencrypt. Please set the
- # required contact email for Let’s Encrypt in LETSENCRYPT_EMAIL
- # variable.
- CERTIFICATE_TYPE=selfsigned
- # If CERTIFICATE_TYPE=letsencrypt, you need to configure a valid email for notifications
- LETSENCRYPT_EMAIL=user@example.com
- 推荐lixiaofei
- 半小时前
本帖最后由 lixiaofei 于 2021-12-23 12:23 编辑
都配置好了以后,然后运行下面命令启动
- ./openvidu start
此命令会拉取并启动相应服务的 docker 镜像,执行完毕后,用 docker ps 可以看出启动的容器
启动完毕后,访问 https://xxx.xxx.xxx.xxx:port 验证服务器。
如果打开看到下面的页面,说明成功了 50%。
然后在标签页多打开页面,都加入同样的房间,来测试效果。如果看到下面的画面,说明配置已经成功。
与自己的系统集成
openvidu 提供了各种语言和框架的 SDK,包含服务端和客户端,并且提供了大量的可以直接复制粘贴的例子来使用。只要把上面的服务配置好了,只需要花十几分钟,就可以集成到自己的系统中。
官方例子提供的 github 地址是 https://github.com/OpenVidu/openvidu-tutorials
提供的例子有
下面是我在自己 VUE 项目中集成的效果图,核心代码都是直接复制的例子的。
算了,还是不放自己项目的图了,反正就是集成起来很容易
说的最后
openvidu 是一个非常优秀的开源视频会议服务器,腾讯云轻量服务器也是一个性价比非常高的服务器,两者的配合相得益彰。你们还知道有哪些类似的开源视频会议服务,也来推荐一下吧。