Skip to main content
版本:4.0 (Archived) 📦

URL Specification

RTMP的url其实很简单,vhost其实也没有什么新的概念,但是对于没有使用过的同学来讲,还是很容易混淆。 几乎每个新人都必问的问题:RTMP那个URL推流时应该填什么,什么是vhost,什么是app?

Vhost(Virtual Host)就是虚拟域,用来隔离客户或业务。如下图所示:

RTMP和HLS的优势参考:HLS

Use Scenarios

Vhost的主要应用场景包括:

  • 一个分发网络支持多个客户:譬如CDN,一个分发网络中,有N个客户公用一套流媒体系统,如何区分用户,计费,监控等等?通过app么?大家可能都叫做live之类。最好是通过各自的域名。
  • 不同的应用配置:譬如FMLE推上来的流是h264+mp3,可以将音频转码后放到其他的vhost分发hls,这样接入h264+mp3的vhost就不用切hls。

总之,vhost作为应用配置的单元,能隔离客户,应用不同的配置。

Standard RTMP URL

标准RTMP URL指的是最大兼容的RTMP URL,基本上所有的服务器和播放器都能识别的URL,和HTTP URL其实很相似,例如:

HTTPSchemaHostPortAppStream
http://192.168.1.10:80/players/srs_player.htmlhttp192.168.1.1080playerssrs_player.html
rtmp://192.168.1.10:1935/live/livestreamrtmp192.168.1.101935livelivestream

其中:

  • Schema:协议头,HTTP为HTTP或HTTPS,RTMP为RTMP/RTMPS/RTMPE/RTMPT等众多协议,还有新出的RTMFP。
  • Host:主机,表示要连接的主机,可以为主机DNS名称或者IP地址。商用时,一般不会用IP地址,而是DNS名称,这样可以用CDN分发内容(CDN一般使用DNS调度,即不同网络和地理位置的用户,通过DNS解析到的IP不一样,实现用户的就近访问)。
  • Port:端口,HTTP默认为80,RTMP默认为1935。当端口没有指定时,使用默认端口。
  • Path:路径,HTTP访问的文件路径。
  • App:RTMP的Application(应用)名称,可以类比为文件夹。以文件夹来分类不同的流,没有特殊约定,可以任意划分。
  • Stream:RTMP的Stream(流)名称,可以类比为文件。

NO Vhost

其实,vhost大多数用户都用不到,而且不推荐用,有点复杂。一般的用户用app就可以了。因为vhost/app/stream,只是一个分类方法而已;vhost需要在配置文件中说明,app/stream都不需要配置。

什么时候用vhost?如果你是提供服务,譬如你有100个客户,都要用一套平台,走同样的流媒体服务器分发。那可以每个客户一个vhost,这样他们的app和stream可以相同都可以。

一般的用法,举个例子,有个视频网站,自己搭建服务器,所以只有他自己一个客户,就不要用vhost了,直接用app就足够了。假设视频网站提供聊天服务,聊天有不同的话题类型,每个话题就是一个app,譬如:军事栏目,读书栏目,历史栏目三个分类,每个分类下面有很多聊天室。只要这么配置就好:

listen              1935;
vhost __defaultVhost__ {
}

生成网页时,譬如军事栏目的网页,都用app名称为military,某个聊天室叫做火箭,这个页面的流可以用:rtmp://yourdomain.com/military/rock,编码器也推这个流,所有观看这个军事栏目/火箭聊天室的页面的人,都播放这个流。

军事栏目另外的网页,都用同样的app名称military,但是流不一样,譬如某个聊天室叫做雷达,这个页面的流可以用:rtmp://yourdomain.com/military/radar,推流和观看一样。

如此类推,军事栏目页面生成时,不用更改srs的任何配置。也就是说,新增聊天室,不用改服务器配置;新增分类,譬如加个公开课的聊天室,也不用改服务器配置。足够简单!

另外,读书栏目可以用app名称为reader,栏目下的某个聊天室叫红楼梦,这个页面的流可以用:rtmp://yourdomain.com/reader/red_mansion,所有在这个聊天室的人都是播放这个流。

Vhost Use Scenarios

RTMP的Vhost和HTTP的Vhost概念是一样的:虚拟主机。详见下表(假设域名demo.srs.com被解析到IP为192.168.1.10的服务器):

HTTPHostPortVhost
http://demo.srs.com:80/players/srs_player.html192.168.1.1080demo.srs.com
rtmp://demo.srs.com:1935/live/livestream192.168.1.101935demo.srs.com

Vhost主要的作用是:

  • 支持多用户:当一台服务器需要服务多个客户,譬如CDN有cctv(央视)和wasu(华数传媒)两个客户时,如何隔离他们两个的资源?相当于不同的用户共用一台计算机,他们可以在自己的文件系统建立同样的文件目录结构,但是彼此不会冲突。
  • 域名调度:CDN分发内容时,需要让用户访问离自己最近的边缘节点,边缘节点再从源站或上层节点获取数据,达到加速访问的效果。一般的做法就是Host是DNS域名,这样可以根据用户的信息解析到不同的节点。
  • 支持多配置:有时候需要使用不同的配置,考虑一个支持多终端(PC/Apple/Android)的应用,PC上RTMP分发,Apple和Android是HLS分发,如何让PC延迟最低,同时HLS也能支持,而且终端播放时尽量地址一致(降低终端开发难度)?可以使用两个Vhost,PC和HLS;PC配置为最低延迟的RTMP,并且将流转发给HLS的Vhost,可以对音频转码(可能不是H264/AAC)后切片为HLS。PC和HLS这两个Vhost的配置肯定是不一样的,播放时,流名称是一样,只需要使用不同的Host就可以。

Multiple Customers

假设cctv和wasu都运行在一台边缘节点(192.168.1.10)上,用户访问这两个媒体的流时,Vhost的作用见下表:

RTMPHostPortVhostAppStream
rtmp://show.cctv.cn/live/livestream192.168.1.101935show.cctv.cnlivelivestream
rtmp://show.wasu.cn/live/livestream192.168.1.101935show.wasu.cnlivelivestream

在边缘节点(192.168.1.10)上的SRS,需要配置Vhost,例如:

listen              1935;
vhost show.cctv.cn {
}
vhost show.wasu.cn {
}

DNS GSLB

详细参考DNS和CDN的实现。

Config Unit

以上面举的例子,若cctv需要延迟最低(意味着启动时只有声音,画面是黑屏),而wasu需要快速启动(打开就能看到视频,服务器cache了最后一个gop,延迟会较大)。

只需要对这两个Vhost进行不同的配置,例如:

listen              1935;
vhost show.cctv.cn {
    chunk_size 128;
}
vhost show.wasu.cn {
    chunk_size 4906;
}

总之,这两个Vhost的配置完全没有关系,不会相互影响。

Default Vhost

FMS的__defaultVhost__是默认的vhost,当用户请求的vhost没有匹配成功时,若配置了defaultVhost,则使用它来提供服务。若匹配失败,也没有defaultVhost,则返回错误。

譬如,服务器192.168.1.10上的SRS配置如下:

listen              1935;
vhost demo.srs.com {
    enabled         on;
}

那么,当用户访问以下vhost时:

  • rtmp://demo.srs.com/live/livestream:成功,匹配vhost为demo.srs.com
  • rtmp://192.168.1.10/live/livestream:失败,没有找到vhost,也没有defaultVhost。

defaultVhost和其他vhost的规则一样,只是用来匹配那些没有匹配成功的vhost的请求的。

Locate Vhost

如何访问某台服务器上的Vhost?有两个方法:

  • 配置hosts:因为Vhost实际上就是DNS解析,所以可以配置客户端的hosts,将域名(Vhost)解析到指定的服务器,就可以访问这台服务器上的指定的vhost。
  • 使用stream的参数:需要服务器支持。在stream后面带参数指定要访问的Vhost。SRS支持?vhost=VHOST?domain=VHOST这两种方式。

普通用户不用这么麻烦,直接访问RTMP地址就好了,有时候运维需要看某台机器上的Vhost的流是否有问题,就需要这种特殊的访问方式。考虑下面的例子:

RTMP URL: rtmp://demo.srs.com/live/livestream
边缘节点数目:50台
边缘节点IP:192.168.1.100 至 192.168.1.150
边缘节点SRS配置:
    listen              1935;
    vhost demo.srs.com {
        mode remote;
        origin: xxxxxxx;
    }

各种访问方式见下表:

用户RTMP URLhosts设置目标
普通用户rtmp://demo.srs.com/live/livestream由DNS
解析到指定边缘
运维rtmp://demo.srs.com/live/livestream192.168.1.100 demo.srs.com查看192.168.1.100上的流
运维rtmp://192.168.1.100/live?
vhost=demo.srs.com/livestream
查看192.168.1.100上的流
运维rtmp://192.168.1.100/live
...vhost...demo.srs.com/livestream
查看192.168.1.100上的流

访问其他服务器的流也类似。

Parameters in URL

RTMP URL一般是不带参数,类似于http的query,有时候为了特殊的要求,会在RTMP URL中带参数,譬如:

  • Vhost:前面讲过,在stream后面加参数,可以访问指定服务器的指定Vhost。这个SRS的特殊约定,方便排错。
  • token认证:SRS还未实现。在连接服务器时,在app后面指定token(方式和vhost一样),服务器可以取出token,进行验证,若验证失败则断开连接,这种是比Refer更高级的防盗链。

例如,下面都是SRS可以识别的URL参数:

  • rtmp://192.168.1.100/live/livestream?vhost=demo.srs.com
  • rtmp://192.168.1.100/live/livestream?domain=demo.srs.com
  • rtmp://192.168.1.100/live/livestream?token=xxx
  • rtmp://192.168.1.100/live/livestream?vhost=demo.srs.com&token=xxx

Note: 之前由于FMLE定义的参数,是传在app中的,这会造成困扰,不推荐使用。

除了RTMP,其他协议也是一样的用法,比如:

  • http://192.168.1.100/live/livestream.flv?vhost=demo.srs.com&token=xxx
  • http://192.168.1.100/live/livestream.m3u8?vhost=demo.srs.com&token=xxx
  • webrtc://192.168.1.100/live/livestream?vhost=demo.srs.com&token=xxx

Note: SRT由于协议的特殊性,无法使用这种方式,详细请参考SRT Parameters

URL of SRS

SRS只做简化的事情,绝对不把简单的事情搞复杂。

SRS的RTMP URL使用标准的RTMP URL,一般不需要对app和stream加参数,或者更改他们的意义。除了两个地方:

  • vhost支持参数访问:为了方便运维访问某台服务器的vhost,不需要设置hosts。不影响普通用户。
  • 支持token验证:为了支持token验证,在app后面带参数,这个是token验证必须的方式。

另外,SRS建议用户使用一级app和一级stream,不使用多级app和多级stream。譬如:

// 不推荐使用的多级app或stream
rtmp://demo.srs.com/show/live/livestream
rtmp://demo.srs.com/show/live/livestream/2013

srs播放器(srs_player)和srs编码器(srs_publisher)不支持多级app和stream,他们认为最后一个斜杠(/)后面的就是stream,前面的是app。即:

// srs_player和srs_publisher的解析方式:
// play or publish the following rtmp URL:
rtmp://demo.srs.com/show/live/livestream/2013
schema: rtmp
host/vhost: demo.srs.com
app: show/live/livestream
stream: 2013

做此简化的好处是,srs播放器和编码器,只需要指定一个url,而且两者的url是一样的。

SRS常见的三种RTMP URL,详细见下表:

URL说明
rtmp://demo.srs.com/live/livestream普通用户的标准访问方式,观看直播流
rtmp://192.168.1.10/live/livestream?vhost=demo.srs.com运维对特定服务器排错
rtmp://demo.srs.com/live/livestream?key=ER892ID839KD9D0A1D87Dtoken验证用户

Example Vhosts in SRS

SRS的full.conf配置文件中,有很多Vhost,主要是为了说明各个功能,每个功能都单独列出一个vhost。所有功能都放在demo.srs.com这个vhost中。

CategoryVhost说明
RTMPdefaultVhost默认Vhost的配置,只支持RTMP功能
RTMPchunksize.vhost.com如何设置chunk size的实例。其他Vhost将此配置打开,即可设置chunk size。
Forwardsame.vhost.forward.vhost.comForward实例:将流转发到同一个vhost。
HLSwith-hls.vhost.comHLS实例:如何开启HLS,以及HLS的相关配置。
HLSno-hls.vhost.comHLS实例:如何禁用HLS。
RTMPmin.delay.comRTMP最低延迟:如何配置最低延迟的RTMP流
RTMPrefer.anti_suck.comRefer实例:如何配置Refer防盗链。
RTMPremoved.vhost.com禁用vhost实例:如何禁用vhost。
Callbackhooks.callback.vhost.com设置http callback的实例,当这些事件发生时,SRS会调用指定的http api。其他Vhost将这些配置打开,就可以支持http callback。
Transcodemirror.transcode.vhost.com转码实例:使用ffmpeg的实例filter,将视频做镜像翻转处理。其他Vhost添加这个配置,就可以对流进行转码。
注:所有转码的流都需要重新推送到SRS,使用不同的流名称(vhost和app也可以不一样)。
Transcodecrop.transcode.vhost.com转码实例:剪裁视频filter。其他vhost添加此filter,即可对视频进行剪裁。
注:所有转码的流都需要重新推送到SRS,使用不同的流名称(vhost和app也可以不一样)。
Transcodelogo.transcode.vhost.com转码实例:添加图片/视频水印。其他vhost添加这些配置,可以加图片/视频水印。
注:所有转码的流都需要重新推送到SRS,使用不同的流名称(vhost和app也可以不一样)。
Transcodeaudio.transcode.vhost.com转码实例:只对音频转码。其他vhost添加此配置,可只对音频转码。
注:所有转码的流都需要重新推送到SRS,使用不同的流名称(vhost和app也可以不一样)。
Transcodecopy.transcode.vhost.com转码实例:只转封装。类似于forward功能。
Transcodeall.transcode.vhost.com转码实例:对上面的实例的汇总。
Transcodeffempty.transcode.vhost.com调用ffempty程序转码,这个只是一个stub,打印出参数而已。用作调试用,看参数是否传递正确。
Transcodeapp.transcode.vhost.com转码实例:只对匹配的app的流进行转码。
Transcodestream.transcode.vhost.com转码实例:只对匹配的流进行转码。

SRS的demo.conf配置文件中,包含了demo用到的一些vhost。

CategoryVhost说明
DEMOplayerssrs_player播放的演示流,按照Readme的Step会推流到这个vhost,demo页面打开后播放的流就是这个vhost中的流
DEMOplayers_pubsrs编码器推流到players这个vhost,然后转码后将流推送到这个vhost,并切片为hls,srs编码器播放的带字幕的流就是这个vhost的流
DEMOplayers_pub_rtmpsrs编码器演示页面中的低延时播放器,播放的就是这个vhost的流,这个vhost关闭了gop cache,关闭了hls,让延时最低(在1秒内)
DEMOdemo.srs.comsrs的演示vhost,Readme的step最后的12路流演示,以及播放器的12路流延时,都是访问的这个vhost。包含了SRS所有的功能。
Othersdev开发用的,可忽略

Winlin 2014.2