janus-Gateway

需求是前后端的webRTC推拉流，但是后端用的是c++，于是使用了这个库做视频流的推送和拉取，记录踩坑过程。

如果你也需要自己部署janus的服务端并在前端拉流测试，希望对你有所帮助。

由于janus的服务器搭建需要linux环境，源码并不支持windows，因此需要准备局域网下的另一台ubantu电脑通过ssh连接。

服务端的搭建本人并不熟悉，参考的是newchenxf大佬的这篇文章，由于版本更新，有些报错的地方会在下文指正。

服务端搭建

1.下载源码

通过 github 下载源码，也可以在 官网 查看详细的api和在线demo 。

2.安装Janus依赖库

部分直接命令行安装，部分需要通过源码安装。

2.1 命令行安装

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

请注意安装结果，如果有某一个安装失败，又是官网要求必须装的，则需要手动下载安装，方法参照下面的源码安装↓

2.2 源码安装libnice

libnice是一个建立ice连接必须的库，官方推荐方法依赖比较多，需要Python 3 Meson and Ninja（我直接用的第二种方法）

git clone https://gitlab.freedesktop.org/libnice/libnice
cd libnice
meson --prefix=/usr build && ninja -C build && sudo ninja -C build install

第二种方法，下载 libnice_0.1.16.orig.tar.gz，下载完后将压缩文件移动到usr/local下

cd /usr/local
tar -zxvf libnice_0.1.16.orig.tar.gz
cd /usr/local/libnice_0.1.16
./configure && make && sudo make install

2.3 源码安装libwebsocket

webSocket不是必须的，但是最好装一下，因为websocket也很常用，网页Demo也会用。

下载 libwebsockets (蓝奏云)压缩包，将压缩文件移动到/usr/local下

 sudo tar -zxvf libwebsockets.tar.gz
 cd /usr/local/libwebsockets
 mkdir build
 cd build/
 cmake ..
 make && make install

如无报错情况下，build/bin目录下，将生成 example类文件， 此时还需要进入example的源码目录:libwebsockets/minimal-examples-lowlevel/ws-server/minimal-ws-server二次编译。

 cd /usr/local/libwebsockets/minimal-examples-lowlevel/ws-server/minimal-ws-server
 cmake .
 make
 ./lws-minimal-ws-server

终端执行结果应该是这样：

此时便可以通过本机ip加7681端口(如果本机ip为1.1.1.1 则访问 1.1.1.1:7681)，访问websocket网页查看服务是否启动↓（网页应该如下图所示）。

在编译 janus 时，janus 默认会增加对 WebSocket 的集成，或者通过增加编译参数 –enable-websockets 打开 WebSocket 开关。

2.4 源码安装libsrtp

这一个不是绝对必须的，因为前面通过命令行也安装了libsrtp-dev。事实上运行起demo是没有问题的，如果只跑demo可以跳过。只不过Janus官网建议，如果你的libsrtp版本低于1.5，建议升级到最新的，比如2.2，因为之前的版本可能有bug，会引入问题。

sudo apt-get install libsrtp-dev

如果是按步骤来，会提示已经安装过了(安装的是老版本，终端执行结果应该是这样)

Reading package lists... Done
Building dependency tree       
Reading state information... Done
Note, selecting 'libsrtp0-dev' instead of 'libsrtp-dev'
libsrtp0-dev is already the newest version (1.4.5~20130609~dfsg-2ubuntu1).

安装新版本，更新到2.2后，不需要pkg-config来修改版本，因为这个库名字和老版本不一样，叫做libsrtp2，不会冲突。如果有libsrtp2，Janus会自动选这个库。

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

2.5 源码安装usrsctp

这个也是非必须，如果要起Data Channel才需要，简单来说就是推拉流运行起来后，如果需要文本互相发送会用到。

装好以后，编译janus会默认启用他

git clone https://github.com/sctplab/usrsctp
cd usrsctp
./bootstrap
./configure --prefix=/usr --disable-programs --disable-inet --disable-inet6
make && sudo make install

3. 编译Janus

依赖都准备好了，可以编译janus了

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

如果还想生成帮助文档，可以加一个–enable-docs，编译前，还需要装一下doxygen等辅助工具（可选）

aptitude install doxygen graphviz

执行configure

./configure

此时终端的执行结果应该为 ↓ ，没有配置Data Channel不影响demo运行

Compiler:                  gcc
libsrtp version:           2.x
SSL/crypto library:        OpenSSL
DTLS set-timeout:          not available
Mutex implementation:      GMutex (native futex on Linux)
DataChannels support:      yes
Recordings post-processor: no
TURN REST API client:      yes
Doxygen documentation:     no
Transports:
    REST (HTTP/HTTPS):     yes
    WebSockets:            yes
    RabbitMQ:              no
    MQTT:                  no
    Unix Sockets:          yes
    Nanomsg:               no
Plugins:
    Echo Test:             yes
    Streaming:             yes
    Video Call:            yes
    SIP Gateway:           yes
    NoSIP (RTP Bridge):    yes
    Audio Bridge:          yes
    Video Room:            yes
    Voice Mail:            yes
    Record&Play:           yes
    Text Room:             yes
    Lua Interpreter:       no
    Duktape Interpreter:   no
Event handlers:
    Sample event handler:  yes
    WebSocket ev. handler: yes
    RabbitMQ event handler:no
    MQTT event handler:    no
    Nanomsg event handler: no
    GELF event handler:    yes
External loggers:
    JSON file logger:      no
JavaScript modules:        no

4. 运行Janus

Janus运行需要参数配置，安装目录(/opt/janus/etc/janus/)已经有配置的sample。

进入以后，发现有很多jcfg.sample文件，比如janus.jcfg.sample， janus.transport.websockets.jcfg.sample。

需要把这些都复制成可被读取的文件（即去掉.sample结尾），要全部复制。

所以需要复制第一个文件名称，替换命令里面的名字，执行命令，再复制第二个文件名称，替换命令里面的名字，再执行…直到复制完文件夹下的十几个.sample文件。

文件名均为 xxx.jcfg.sample 后面的文件名就是xxx.jcfg（即 前面的删掉 .sample ）

sudo cp -rf 文件名 文件名（去掉最后的sample）

所以假如复制的文件名为 janus.jcfg.sample ，命令就是 ↓ 这条

sudo cp -rf janus.jcfg.sample janus.jcfg

全部完成后，需要生成ssl证书。

5. ssl证书

Janus默认的配置，是没有enable SSL的，意味着，https和wss不支持。而有些浏览器，要拉起摄像头，必须是加密协议下的。所以，如果你Demo运行不起来，可以服务端配置一下SSL。

cd ~
mkdir ssl
cd ssl
# Gen ssl certs:
openssl req -new -newkey rsa:4096 -nodes -keyout key.pem -out cert.csr
openssl x509 -req -sha256 -days 365 -in cert.csr -signkey key.pem -out cert.pem
chmod 600 cert.csr
chmod 600 cert.pem
chmod 600 key.pem

生成的过程中会让你输入信息，姓名密码之类的，直接enter跳过即可，不能跳过的随便填。

注意：如果填密码的时候是输入了密码的，那么要记住它，改配置文件需要填密码。

这个是私人证书，访问时会报不安全，如果公司性质的需要另外申请。

5.1 配置文件修改ssl信息

打开刚才改.sample文件的目录 /opt/janus/etc/janus/

使用文本编辑janus.jcfg，注意这里的证书路径需要在文件夹中找一下，不同的用户生成不同

比如我的是root用户，我的ssl证书生成在/root/ssl， 并且由于我填密码时enter跳过了，所以pwd为空

注意前面的#要去掉，填完之后前面三行复制即可

certificates: {
        cert_pem = "/root/ssl/cert.pem"
        cert_key = "/root/ssl/key.pem"
        cert_pwd = ""
        #dtls_accept_selfsigned = false
        #dtls_ciphers = "your-desired-openssl-ciphers"
        #rsa_private_key = false
}

再编辑同目录下的janus.transport.http.jcfg，把https改为true，去掉secure_port的注释#，certificates配置跟上面一样

general: {
        #events = true                                  # Whether to notify event handlers about transport events (default=true)
        json = "indented"                               # Whether the JSON messages should be indented (default),
                                                                        # plain (no indentation) or compact (no indentation and no spaces)
        base_path = "/janus"                    # Base path to bind to in the web server (plain HTTP only)
        http = true                                             # Whether to enable the plain HTTP interface
        port = 8088                                             # Web server HTTP port
      
        https = true                                    # Whether to enable HTTPS (default=false)
        secure_port = 8089                              # Web server HTTPS port, if enabled

}


certificates: {
        cert_pem = "/root/ssl/cert.pem"
        cert_key = "/root/ssl/key.pem"
        cert_pwd = ""
        #ciphers = "PFS:-VERS-TLS1.0:-VERS-TLS1.1:-3DES-CBC:-ARCFOUR-128"
}

再编辑同目录下的janus.transport.websockets.jcfg，把wss改为true，去掉wss_port的注释#，certificates配置跟上面一样

general: {

        ws = true                                               # Whether to enable the WebSockets API
        ws_port = 8188                                  # WebSockets server port
        #ws_interface = "eth0"                  # Whether we should bind this server to a specific interface only
        #ws_ip = "192.168.0.1"                  # Whether we should bind this server to a specific IP address only
        wss = true                                              # Whether to enable secure WebSockets
        wss_port = 8989                         # WebSockets server secure port, if enabled
}

certificates: {
        cert_pem = "/root/ssl/cert.pem"
        cert_key = "/root/ssl/key.pem"
        cert_pwd = ""
        #ciphers = "PFS:-VERS-TLS1.0:-VERS-TLS1.1:-3DES-CBC:-ARCFOUR-128"
}

注意：改的这三个文件均为.jcfg结尾的文件（刚才4. 运行Janus时转化的），如果改到了.sample结尾的文件，配置就不生效了。

6. 运行

所有的准备和配置都搞定了，接下来就是启动服务。

/opt/janus/bin/janus --debug-level=7

终端的执行结果

libwebsockets logging: 0
Websockets server started (port 8188)...
Using certificates:
        /root/ssl/cert.pem
        /root/ssl/key.pem
Secure Websockets server started (port 8989)...
Admin Websockets server disabled
Secure Admin Websockets server disabled

JANUS WebSockets transport plugin initialized!    <---JANUS websocket初始化

        Version: 1 (0.0.1)
           [janus.transport.websockets] JANUS WebSockets transport plugin
           This transport plugin adds WebSockets support to the Janus API via libwebsockets.
           Plugin API version: 8
           Janus API: enabled
           Admin API: disabled
           
WebSockets thread started     <---JANUS websocket启动成功

如果是这样说明启动成功了！

检查运行端口

lsof -i | grep janus

终端运行结果

janus   32306 chenxiaofeng    5u  IPv6  887081      0t0  UDP *:rfe 
janus   32306 chenxiaofeng    6u  IPv6  887082      0t0  UDP *:5004 
janus   32306 chenxiaofeng   13u  IPv6  884414      0t0  TCP *:omniorb (LISTEN)
janus   32306 chenxiaofeng   16u  IPv6  884415      0t0  TCP *:8089 (LISTEN)
janus   32306 chenxiaofeng   21u  IPv4  884417      0t0  TCP *:8188 (LISTEN)
janus   32306 chenxiaofeng   24u  IPv4  884418      0t0  TCP *:8989 (LISTEN)

8089是https， 8188是ws， 8989是wss(websocket secure)

STUN server警告

[WARN] Janus is deployed on a private address (192.168.1.107) but you didn't specify any STUN server! Expect trouble if this is supposed to work over the internet and not just in a LAN...

启动的时候还会有STUN警告信息，对于我们运行Demo是没问题的。因为一般运行在局域网，没有P2P打通的需要。

但如果你是正式使用则需要解决这个警告，需要安装STUN server， 也就是coturn。

打开/opt/janus/etc/janus/janus.jcfg，修改配置

nat: {
        #stun_server = "stun.voip.eutelia.it"
        #stun_port = 3478
..
        #turn_server = "myturnserver.com"
        #turn_port = 3478
        #turn_type = "udp"
        #turn_user = "myuser"
        #turn_pwd = "mypassword"

安装coturn

git clone https://github.com/coturn/coturn
cd coturn
./configure 
make 
sudo make install

安装coturn服务器不一定和janus一起，也可以一起。总之装好后把信息写到janus的配置文件中。

7. 在线demo

我们可以在服务端通过http-server将demo的html发布到本地服务器，方便我们使用

首先我们需要在ubantu中安装nodejs，参考ubantu下nodejs安装

安装完成后，全局安装http-server

npm -g install http-server

安装好以后，进入janus源码的html目录。

cd /usr/local/janus-gateway/html

然后执行http-server

注意：web的demo，默认都是走http的，这在有些环境下的浏览器，是无法拉起摄像头的（权限问题），推荐使用https

这里/root/ssl是ssl证书生成的目录

http-server --ssl --cert /root/ssl/cert.pem --key /root/ssl/key.pem

启动后访问即可，由于是私人ssl证书，浏览器会有警告，继续前往即可。

此时就可以访问在线的demo了。

服务端的部署到这里就结束了，接下来是前端模块