Jo-im开发:用于WebRTC的ICE中继服务器Coturn搭建

对号东 2024-10-03 11:03:03 阅读 73

前言

        本人计划开发一套具备文本、语音、视频通话功能的IM demo,同时具备多人在线会议功能,按习惯大概会开源版定义名称为Duihao jo-im,本案主要用于实现语音视频通话的基础组件支撑。因为我们选择基于WebRTC实现IM中语音、视频通话,因此需要搭建用于WebRTC的ICE中继服务器,我们选择coturn进行搭建。

        在 WebRTC 网络传输模块中,当遇到 NAT 之间无法打通的情况下,会使用 TURN 协议通过中转的方式实现端与端之间的通信。Coturn 就是一种开源的 STUN/TURN 服务器,它可以让你轻松地搭建一个能够在 NAT 防火墙和代理服务器背后运行的实时通信系统。Coturn 支持各种协议和技术,包括 STUN(Session Traversal Utilities for NAT)、TURN(Traversal Using Relays around NAT)和 ICE(Interactive Connectivity Establishment)。Coturn 可以用于向 WebRTC 应用程序提供 TURN 服务器,这些应用程序需要在 P2P 通信中转储流量。本文主要介绍 Coturn 在 Linux系统下部署的步骤。

服务器环境

云服务器:阿里ECS

操作系统:Alibaba Cloud linux

控制面板:BT宝塔

安装&启动coturn

        因为coturn使用到了UDP,所以要把coturn监听的UDP和TCP相关端口在安全组中打开,这个一般在云资源控制台的服务器安全组配置中。我们这次使用的是3478端口。

安装依赖

       下载libevent2发行包,通过宝塔面板直接上传到服务器,并解压。因为阿里云国内服务器的国际资源访问限制,建议您通过浏览器下载后直接上传、解压。

Release release-2.1.12-stable · libevent/libevent · GitHub

icon-default.png?t=N7T8

https://github.com/libevent/libevent/releases/tag/release-2.1.12-stable        您也可以使用命令进行下载(阿里云国内服务器可能会报错):

<code>wget https://github.com/libevent/libevent/releases/download/release-2.1.12-stable/libevent-2.1.12-stable.tar.gz

         使用命令解压:

tar -zxvf libevent-2.1.12-stable.tar.gz

        解压后,进入libevent2目录,执行编译安装:

cd libevent-2.1.12-stable

./configure && make && make install

        安装过程如下:

下载coturn代码

        方法1:使用git命令下载(需要服务器中已安装git):

<code># 国内仓库(推荐使用)

git clone https://gitee.com/whatitis/coturn

# 原仓库(速度会慢一些)

git clone https://github.com/coturn/coturn

        方法2:使用wget命令下载,然后执行解压:

wget https://github.com/coturn/coturn/archive/4.5.1.1.tar.gz

# 解压

tar -zxvf 4.5.1.1.tar.gz

执行coturn编译安装

cd coturn

./configure --prefix=/usr/local/coturn

make && make install

配置 Coturn

        切换到 coturn 的 etc 目录,拷贝一份 turnserver.conf.default 再进行修改。宝塔面板可以直接进入 /usr/local/coturn/etc 这个目录去复制,并修改文件。

        1、进入目录

cd /usr/local/coturn/etc

        2、复制文件

cp ./turnserver.conf.default ./turnserver.conf

        3、修改配置项

vi ./turnserver.conf

        vi命令注释:终端编辑文件时先输入 i 进入编辑模式,编辑好后,按 esc 退出编辑模式,输入:wq 保存文件

        4、配置说明

        修改 turnserver.conf 文件配置内容,realm 需要指定 IP 或域名,否则无法在 WebRTC 本地库中使用,虽然使用 trickle-ice 可以正常访问,但是在 WebRTC本地库中是没法正常使用的。将下方的代码直接复制到 turnserver.conf 文件最后,保存。

# 指定侦听的端口。

listening-port=3478

# 云主机内网 IP 地址,如果没有内网IP就直接用公网IP。

listening-ip=xxx.xxx.xxx.xxx

# 云主机的公网 IP 地址。

external-ip=xxx.xxx.xxx.xxx

# 这个很重要,如果没有配置这个就服务使用中转服务。云主机的公网 IP 地址或域名。

realm=xxx.xxx.xxx.xxx

# 访问 STUN/TURN 服务的用户名和密码。

user=admin:123456

服务器端口开启

        在阿里云ecs服务器安全组中进行开启,需要到控制中的安全策略组或者防火墙中允许 3478、49152-65535 端口 UDP/TCP 通行(出、入),然后在宝塔面板安全中再进行开启。

        阿里云ECS安全规则如下:

        宝塔面板安全规则:

启动Coturn

        设置系统环境变量,直接打开 /etc/profile文件,在文件末尾加上以下内容

<code>export PATH=$PATH:/usr/local/coturn/bin

        执行以下命令,让系统环境变量生效

source /etc/profile

        通过配置文件执行启动命令

turnserver -c /usr/local/coturn/etc/turnserver.conf

        启动命令运行结果

检测coturn工作状态

        使用这个网址可以检测ICE服务器的工作状态,出现 relay 说明配置成功。https://webrtc.github.io/samples/src/content/peerconnection/trickle-ice/

icon-default.png?t=N7T8

https://cloud.tencent.com/developer/tools/blog-entry?target=https%3A%2F%2Fwebrtc.github.io%2Fsamples%2Fsrc%2Fcontent%2Fpeerconnection%2Ftrickle-ice%2F&source=article&objectId=2037764

        测试的时候,STUN or TURN URI 需要加入协议头和端口号,点击 Add Server 按钮,然后再点击Gather candidates 按钮。

        如:<code>turn:143.163.245.191:3478

将 Coturn 设置为系统服务

        把 Coturn 设置成系统服务,便于开机自动启动,就不用手动启动了。

        执行以下命令:

<code>touch /usr/lib/systemd/system/coturn.service

        命令编辑或直接宝塔面板找到刚刚生成的服务文件,编辑:

vi /usr/lib/systemd/system/coturn.service

        编辑coturn.service 文件内容如下:

[Unit]

Description=Coturn Server

After=network.target

[Install]

WantedBy=multi-user.target

[Service]

User=root

Group=root

ExecStart=/usr/local/coturn/bin/turnserver -c /usr/local/coturn/etc/turnserver.conf

LimitNOFILE = 5000

        将 coturn 设置开机启动:

systemctl enable coturn

        启动 coturn 服务:

systemctl start coturn

       重启 coturn 服务:

systemctl restart coturn

        停止 coturn 服务:

systemctl stop coturn

结束语

        本文仅对IM中语音视频通话所需要的WebRTC支持组件进行安装,要想开发具备语音、视频通话的IM,还有大量工作需要做,后续Jo-im系列文章将会持续更新,敬请关注。



声明

本文内容仅代表作者观点,或转载于其他网站,本站不以此文作为商业用途
如有涉及侵权,请联系本站进行删除
转载本站原创文章,请注明来源及作者。