--Ubuntu 下 Janus Server 搭建笔记

一 、简介

Janus是一个开源的,通过 C 语言实现了对 WebRTC 支持的 Gateway;Janus 自身实现得很简单,提供插件机制来支持不同的业务逻辑,配合官方自带插件就可以用来实现高效的 Media Server 服务。

本文主要介绍如何在 Ubuntu 16.04 下搭建起 janus 服务器,实现 janus 官方 Demo 浏览器与 Android APP Demo(janus-gateway-android)之间的音视频通话。

目前浏览器仅支持 FireFox 浏览器,因为 Chrome 浏览器打开音视频采集的话需要 HTTPS 加密访问!

效果图如下:

安装完ubuntu server后必做的事情(Ubuntu下Janus)(1)

Janus 官网:https://janus.conf.meetecho.com/index.html

参考文档:https://github.com/meetecho/janus-gateway

二、 下载编译 Janus

编译运行 Janus Server 需要依赖较多的一些第三方库,而这些依赖库在 Ubuntu 下主要通过 aptitude 进行安装,首先通过安装 aptitude:

sudo apt-get install aptitude

1、 安装依赖

Ubuntu 下通过 aptitude 批量安装依赖工具包,这里建议 Ubuntu 镜像源(/etc/apt/source.list)不要为了追求速度而改用了国内的某些镜像源,如 网易 163,这可能会导致某些工具包下载失败,建议依然使用官方自带的镜像源。

批量安装命令:

sudo aptitude install libmicrohttpd-dev libjansson-dev libnice-dev \ libssl-dev libsrtp-dev libsofia-sip-ua-dev libglib2.0-dev \ libopus-dev libogg-dev libcurl4-OpenSSL-dev pkg-config gengetopt \ libtool automake

如果出现某个工具包下载失败,请修改镜像源为官方地址,并执行以下命令

sudo apt-get update && sudo apt-get upgrade

以更新镜像源,完成后重新安装。

2、 安装 WebSocket

janus 支持 WebSocket 是可选项,如果不安装,编译 janus 时,默认不支持 WebSocket 的链接请求,而 Android APP Demo 是通过 WebSocket 与 janus 进行通信的,因为我们希望 Android APP Demo 能与浏览器(HTTP)进行视频通话,所以就必须要在编译 janus 时支持 WebSocket。

依次执行以下命令,分别进行下载,编译,安装:

git clone https://github.com/warmcat/libwebsockets.git cd libwebsockets mkdir build cd build cmake -DCMAKE_INSTALL_PREFIX:PATH=/usr -DCMAKE_C_FLAGS="-fpic" .. make && sudo make install

安装成功后,在编译 janus 时,janus 默认会增加对 WebSocket 的集成,或者通过增加编译参数 --enable-websockets 打开 WebSocket 开关,或 --disable-websockets 关闭 WebSocket 开关。

3、 安装 Http Server

Janus 源码目录下的 html 下自带 Web Demo(html & JavaScript ),Janus 编译完成并 Start 以后,需要通过 http server 访问 Janus Web Demo,其中包括:

Echo Test: yes Streaming: yes Video Call: yes SIP Gateway: yes Audio Bridge: yes Video Room: yes Voice Mail: yes Record&Play: yes Text Room: yes

以上 janus 插件均可通过相应的 http 链接进行访问体验。

以下介绍一种快速,便捷,轻巧的 HTTP Server 安装方式:

通过 Node.js (基于 Chrome V8 引擎的 JavaScript 运行环境) 进行安装,首先安装 Node.js:

sudo apt-get install nodejs

安装成功后,通过 npm (npm 是 Node.js 的包管理器,是全球最大的开源库生态系统) 进行安装 httpserver:

sudo npm -g install http-server

启动方式:

进入到 html 目录,执行 http-server 命令即可,如:

gobert@gobert-ThinkPad-X230:~/OpenSource/janus-gateway$ cd html/ gobert@gobert-ThinkPad-X230:~/OpenSource/janus-gateway/html$ http-server Starting up http-server, serving ./ Available on: http://127.0.0.1:8080 http://100.100.32.64:8080 Hit CTRL-C to stop the server

输入 http url 即可访问。

注:需首先 build & start janus Server!

4、 安装 libsrtp

Janus 需要至少 version 1.5 以上的 libsrtp,如果系统中已经安装了 libsrtp,则首先卸载后,手动安装新版本,这里我们安装 libsrtp 2.0,依次执行以下命令:

wget https://github.com/cisco/libsrtp/archive/v2.0.0.tar.gz tar xfv v2.0.0.tar.gz cd libsrtp-2.0.0 ./configure --prefix=/usr --enable-openssl make shared_library && sudo make install

5、 编译 Janus

通过 Git 下载 Janus 源码,并编译安装:

git clone https://github.com/meetecho/janus-gateway.git sh autogen.sh ./configure --prefix=/opt/janus --enable-websockets --enable-docs make sudo make install

configure 执行成功后,会输出 janus 所支持的 协议及插件,如下:

libsrtp version: 2.0.x SSL/crypto library: OpenSSL DTLS set-timeout: not available DataChannels support: no Recordings post-processor: no TURN REST API client: yes Doxygen documentation: no Transports: REST (HTTP/HTTPS): yes //支持 HTTP 访问 WebSockets: yes (new API) //支持 WebSocket 访问 RabbitMQ: no MQTT: no Unix Sockets: yes Plugins: Echo Test: yes Streaming: yes Video Call: yes SIP Gateway: yes Audio Bridge: yes Video Room: yes Voice Mail: yes Record&Play: yes Text Room: yes Event handlers: Sample event handler: yes

6、 运行 Janus

如果全部安装以上步骤进行编译的 janus ,那么 janus 的全局配置文件存放目录为 :

/opt/janus/etc/janus/janus.cfg

或者在启动 janus 时,加上相应的启动参数,参数可通过 janus --help 查看;

janus 默认的配置中是没有 WebSocket 的配置的,直接启动 Janus 会因没有 WebSocket 配置文件而报错。幸运的是在配置目录中 Janus 已经给我们提供了一个 WebSocket 的示例配置文件 : janus.transport.websockets.cfg.sample,(如果我们要通过 WebSocket 连接 Janus,则需要有个 WebSocket 的配置文件)这里我们可以直接拷贝这个示例文件:

sudo cp janus.transport.websockets.cfg.sample janus.transport.websockets.cfg

通过查看此配置文件,可以得知 Janus 默认的 WebSocket 的端口号为 8188,记住这个端口号,在 Android APP Demo 中会使用到!

启动 Janus:

/opt/janus/bin/janus --debug-level=7 --log-file=$HOME/janus-log

根据需要可以选择是否加上后面两个启动参数。

三、 视频通话联调测试

我们使用 PC 下的 浏览器 与 Android APP Demo 进行联调。

1、 启动 Web Demo

进入到 janus 目录下的 html 目录,启动 http-server

gobert@gobert-ThinkPad-X230:~$ cd ~/OpenSource/janus-gateway/html/ gobert@gobert-ThinkPad-X230:~/OpenSource/janus-gateway/html$ http-server Starting up http-server, serving ./ Available on: http://127.0.0.1:8080 http://100.100.32.64:8080 Hit CTRL-C to stop the server

这样外部便可以通过 http://100.100.32.64:8080 进行访问了,进入首页后,找到 videoRoom,Start

2、 启动 Android APP Demo

git clone git@github.com:Computician/janus-gateway-android.git

private VideoRenderer.Callbacks remoteRenders[] = new VideoRenderer.Callbacks[3];

remoteRenders[0] = VideoRendererGui.create(0, 0, 25, 25, VideoRendererGui.ScalingType.SCALE_ASPECT_FILL, true);

private final String JANUS_URI = "ws://100.100.32.64:8188";

3、联调测试

Janus Server 默认会开启两个视频房间:1234 和 5678,分别使用 VP8 和 VP9 视频编码器,所以我们通过 Brower 和 Android APP Demo 进行联调测试时,暂不需要设置房间 ID。

效果图:

安装完ubuntu server后必做的事情(Ubuntu下Janus)(2)

,