简介
apprtc 是什么,webrtc.org官方指定体验app
原料:
ubuntu14.04,其他linux版本不限,官方并没特殊说明
chrome M51+
rfc5766-turn-server https://code.google.com/archive/p/rfc5766-turn-server/
步骤:
设置代理
由于国内网络的特殊性,这步非常关键,如果没有靠谱的代理,很可能以失败告终。
设置shell环境的代理
添加如下内容到 ~/.bashrc
export http_proxy=http://10.xx.xx.xx:100
export https_proxy=http://10.xx.xx.xx:100
设置git的代理
添加如下内容到 ~/.gitconfig
[http]
proxy = http://10.xx.xx.xx:100
sslverify = false
[https]
proxy = http://10.xx.xx.xx:100
下载,解压.
建议存放在和apprtc同级目录
├── code
│ ├── google_appengine
│ ├── apprtc
安装apprtc
下载apprtc源码
git clone https://github.com/webrtc/apprtc.git
建议存放在和google_appengine同级目录
├── code
│ ├── google_appengine
│ ├── apprtc
安装npm
下面摘录自[1],如果设置好代理之后,这些步骤可很顺利的完成
Install grunt by first installing npm. npm is distributed as part of nodejs.
sudo apt-get install nodejs
sudo npm install -g npm
On Ubuntu 14.04 the default packages installs
/usr/bin/nodejs
but the /usr/bin/node
executable is required for grunt. This is installed on some Ubuntu package sets; if it is missing, you can add this by installing the nodejs-legacy
package,sudo apt-get install nodejs-legacy
It is easiest to install a shared version of
grunt-cli
from npm
using the -g
flag. This will allow you access the grunt
command from /usr/local/bin
. More information can be found on gruntjs
Getting Started.sudo npm -g install grunt-cli
Omitting the -g
flag will install grunt-cli
to the current directory under the node_modules
directory.
Finally, you will want to install grunt and required grunt dependencies. This can be done from any directory under your checkout of the webrtc/apprtc repository.
npm install
On Ubuntu, you will also need to install the webtest package:
sudo apt-get install python-webtest
编译apprtc
sudo grunt build --force
每次更新修改代码都应该重新编译,编译生成的文件存放在out目录中
运行apprtc
sudo ../google_appengine//dev_appserver.py ./out/app_engine --host 0.0.0.0
安装 rfc5766-turn-server
sudo app-get install rfc5766-turn-server
配置
编辑 /etc/trunserver.conf
确保打开了以下行的注释,并且赋予正确的值,port,ip的值当然要按照实际情况填写,static-auth-secret=4080218913最好也不要修改成其他值,因为apprtc硬编码了这个值,除非你也去修改apprtc里对应的地方。realm=cn.cn 这个没有要求,填写自己的域名即可。Verbose 不是必须的,打开它只是为了可以看到更多输出而已。
18:listening-port=9000
52:listening-ip=10.58.60.236
97:relay-ip=10.58.60.236
154:Verbose
203:use-auth-secret
211:static-auth-secret=4080218913
289:realm=cn.cn
446:
制作证书
➜ apprtc git:(restapi) ✗ openssl req -x509 -newkey rsa:2048 -keyout key.pem -out cert.pem -days 99999 -nodes
Generating a 2048 bit RSA private key
..............+++
....................................................+++
writing new private key to 'key.pem'
-----
You are about to be asked to enter information that will be incorporated
into your certificate request.
What you are about to enter is what is called a Distinguished Name or a DN.
There are quite a few fields but you can leave some blank
For some fields there will be a default value,
If you enter '.', the field will be left blank.
-----
Country Name (2 letter code) [AU]:cn
State or Province Name (full name) [Some-State]:cn
Locality Name (eg, city) []:cn
Organization Name (eg, company) [Internet Widgits Pty Ltd]:cn
Organizational Unit Name (eg, section) []:cn
Common Name (e.g. server FQDN or YOUR name) []:cn
Email Address []:cn
生成过程中多次提示输入一些信息,可以马马虎虎填写一下。
将生成的 cert.pem 和 key.pem 安装到/cert/目录下,为什么要放在这个目录呢,因为collidermain中硬编码读取下面两个文件。不放在这里就意味着要去修改collidermain中的代码,为了省事,暂且顺着它的方式来。
"/cert/cert.pem"
"/cert/key.pem"
安装 stunnle
sudo app-get install stunnle
配置
编辑 /usr/local/etc/stunnel/stunnel.conf
添加以下内容
[apprtc_main]
accept = 443
connect = 8080
cert = /cert/cert.pem
[apprtc_auth]
accept = 4431
connect = 8081
cert = /cert/cert.pem
安装golang
sudo app-get install golang
编译信令
在apprtc目录中
export GOPATH=$(shell pwd)
go build -o collidermain src/collider/collidermain/main.go
编译rfc5766-turn-server授权服务:apprtc_turn_auth
授权服务笔者没有找到源码,所以需要自己写,这里共享出笔者写golang版的代码。
编译方式如下
export GOPATH=$(shell pwd)
go build -o auth auth.go
修改apprtc中的代码
对apprtc/src做如下修改,但是IP地址要根据实际情况填写。修改之后必不可少的步骤是重新编译,千万别忘了。
diff --git a/src/app_engine/apprtc.py b/src/app_engine/apprtc.py
index dbe9d84..2acc179 100755
--- a/src/app_engine/apprtc.py
+++ b/src/app_engine/apprtc.py
@@ -292,6 +292,7 @@ def get_room_parameters(request, room_id, client_id, is_initiator):
if room_id is not None:
room_link = request.host_url + '/r/' + room_id
+ room_link = room_link.replace("http", "https")
room_link = append_url_arguments(request, room_link)
params['room_id'] = room_id
params['room_link'] = room_link
diff --git a/src/app_engine/constants.py b/src/app_engine/constants.py
index 430a7a2..7d4dd73 100644
--- a/src/app_engine/constants.py
+++ b/src/app_engine/constants.py
@@ -16,8 +16,8 @@ TURN_BASE_URL = 'https://computeengineondemand.appspot.com'
TURN_URL_TEMPLATE = '%s/turn?username=%s&key=%s'
CEOD_KEY = '4080218913'
-ICE_SERVER_BASE_URL = 'https://networktraversal.googleapis.com'
-ICE_SERVER_URL_TEMPLATE = '%s/v1alpha/iceconfig?key=%s'
+ICE_SERVER_BASE_URL = 'https://10.58.60.236:4431' # 'https://networktraversal.googleapis.com'
+ICE_SERVER_URL_TEMPLATE = '%s/turn?key=%s' # '%s/v1alpha/iceconfig?key=%s'
ICE_SERVER_API_KEY = os.environ.get('ICE_SERVER_API_KEY')
# Dictionary keys in the collider instance info constant.
@@ -25,13 +25,13 @@ WSS_INSTANCE_HOST_KEY = 'host_port_pair'
WSS_INSTANCE_NAME_KEY = 'vm_name'
WSS_INSTANCE_ZONE_KEY = 'zone'
WSS_INSTANCES = [{
- WSS_INSTANCE_HOST_KEY: 'apprtc-ws.webrtc.org:443',
+ WSS_INSTANCE_HOST_KEY: '10.58.60.236:4432', # 'apprtc-ws.webrtc.org:443',
WSS_INSTANCE_NAME_KEY: 'wsserver-std',
WSS_INSTANCE_ZONE_KEY: 'us-central1-a'
-}, {
- WSS_INSTANCE_HOST_KEY: 'apprtc-ws-2.webrtc.org:443',
- WSS_INSTANCE_NAME_KEY: 'wsserver-std-2',
- WSS_INSTANCE_ZONE_KEY: 'us-central1-f'
+# }, {
+# WSS_INSTANCE_HOST_KEY: 'apprtc-ws-2.webrtc.org:443',
+# WSS_INSTANCE_NAME_KEY: 'wsserver-std-2',
+# WSS_INSTANCE_ZONE_KEY: 'us-central1-f'
}]
WSS_HOST_PORT_PAIRS = [ins[WSS_INSTANCE_HOST_KEY] for ins in WSS_INSTANCES]
diff --git a/src/collider/collidermain/main.go b/src/collider/collidermain/main.go
index a499ada..5e164dd 100644
--- a/src/collider/collidermain/main.go
+++ b/src/collider/collidermain/main.go
@@ -6,7 +6,7 @@
package main
import (
- "collider"
+ "collider/collider"
"flag"
"log"
)
➜ apprtc git:(restapi) ✗
最后
由于整个过程过于繁琐,笔者在实验过程中写了Makefile,现也共享传来。这个Makefile在调试运行过程中缺失带来了很多便利,不用每次噼里啪啦的敲一堆命令。几乎包含了上述所有编译,运行的操作,有了此文件只需make xxx 就行
➜ apprtc git:(restapi) ✗ cat Makefile
all: apprtc auth collidermain
apprtc:
sudo grunt build --force
auth: auth.go env
go build -o auth auth.go
collidermain: src/collider/collidermain/main.go env
go build -o collidermain src/collider/collidermain/main.go
clean:
rm auth
env:
export GOPATH=$(shell pwd)
test_auth:
curl http://localhost:8081/turn
curl http://localhost:8081/v2/turn
run_apprtc:
sudo ../google_appengine//dev_appserver.py ./out/app_engine --host 0.0.0.0 2>&1 | tee app.log
run_auth:
sudo ./auth -port 8081
run_collidermain:
sudo ./collidermain -port 4432 -room-server http://localhost:8080 2>&1 | tee collider.log
run_stunnel:
sudo stunnel
run_turnserver:
sudo turnserver
.PHONY: all test clean apprtc env
体验
参考文章
未完……