-
-
Notifications
You must be signed in to change notification settings - Fork 5.4k
v1_CN_Build
本文说明了如何编译和打包SRS,另外,可以直接下载release的binary,提供了几个常见系统的安装包,安装程序会安装系统服务,直接以系统服务启动即可。参考:Github: release或者国内镜像: release
- README中的Usage,在Centos6.x/Ubuntu12下面测试成功。按照Step操作后,浏览器中打开服务器地址就能观看所有的DEMO。
- DEMO演示了所有SRS的功能,特别是ffmpeg依赖的库巨多,因此为了简化,推荐使用Centos6.x/Ubuntu12.
- 若的确需要在其他系统下编译SRS,下面说明SRS依赖的各种库,可以关掉某些功能减少编译的依赖。
有时候启动没有问题,但是就是看不了,原因是防火墙和selinux开着。
可以用下面的方法关掉防火墙:
# disable the firewall
sudo /etc/init.d/iptables stop
sudo /sbin/chkconfig iptables off
selinux也需要disable,运行命令getenforce
,若不是Disabled,执行下面的步骤:
- 编辑配置文件:
sudo vi /etc/sysconfig/selinux
- 把SELINUX的值改为disabled:
SELINUX=disabled
- 重启系统:
sudo init 6
确定用什么编译选项后(参考下面的说明),编译SRS其实很简单。只需要RTMP和HLS:
./configure && make
指定配置文件,即可启动SRS:
./objs/srs -c conf/srs.conf
推RTMP流和观看,参考Usage: RTMP
更多使用方法,参考Usage
SRS提供了详细的编译选项来控制功能的开关,以及提供了一些有用的预设,针对不同的应用场景默认选项。
SRS会先应用预设集,然后应用用户的选项,譬如:./configure --rtmp-hls --with-http-api
,应用顺序为:
- 首先应用预设集:--rtmp-hls,开启ssl/hls,其他功能都处于关闭状态。
- 应用用户选项:--with-http-api,开启http api接口。
所以这个编译命令最后支持的功能是:RTMP+HLS+HTTP接口
支持的预设集参考末尾的参数列表,或者执行:./configure -h
查看。
由于SRS在configure时需要编译ffmpeg/nginx,这个过程会很漫长,如果你有多核机器,那么可以使用jobs来并行编译。
- configure: 在编译srs依赖的工具时可以并行编译。
- make: 在编译srs时可以使用并行编译。
srs并行编译和串行编译的项目包括(srs会自动判断,不需要用户指定):
- srs: 支持并行编译。
- st-1.9: 串行编译,库比较小,编译时间很短。
- http-parser: 串行编译,库比较小,编译时间很短。
- openssl: 串行编译,并行编译有问题。
- nginx: 支持并行编译。
- ffmpeg: 支持并行编译。
- lame: 支持并行编译。ffmpeg用到的mp3库。
- libaacplus: 串行编译,并行编译有问题。ffmpeg用到的aac库。
- x264: 支持并行编译。ffmpeg用到的x264库。
configure使用并行编译的方法如下:
./configure --jobs=16
注意:configure不支持make那样的"-jN",只支持"--jobs[=N]"。
make使用并行编译的方法如下:
// or make --jobs=16
make -j16
SRS提供了打包脚本,可以将srs打包(不包含nginx/ffmpeg等外部程序)。安装包也提供下载,参考本文开头部分。
打包脚本会编译srs,然后将srs的文件打包为zip(zip比tar通用)。详细参考package的帮助:
[winlin@dev6 srs]$ ./scripts/package.sh --help
--help print this message
--x86-x64 configure with x86-x64 and make srs.
--arm configure with arm and make srs.
SRS依赖于g++/gcc/make,st-1.9,http-parser2.1,ffmpeg,cherrypy,nginx,openssl-devel,python2。
除了g++/gcc/make基础工具,st-1.9是必选,其他都可以通过编译选项禁用。
SRS可以自定义编译器,譬如arm编译时使用arm-linux-g++而非g++。参考ARM:手动编译
注意:SRS和ST都可以通过编译前设置变量编译,但是ssl需要手动修改Makefile。还好ssl不用每次都编译。
configure和make将会生成一些项目,都在objs目录,其他会自动软链到objs目录。
- ./objs/srs 启动SRS服务器
- ./objs/research/librtmp/srs_bandwidth_check linux测速工具
- ./objs/research/librtmp/srs_ingest_flv 将FLV文件采集为RTMP流工具
- ./objs/research/librtmp/srs_ingest_rtmp 将RTMP流采集为RTMP流工具
- ./objs/nginx/sbin/nginx 分发HLS用到的nginx服务器
- research/api-server/server.py 启动HTTP hooks和DEMO视频会议用到的api-server
- ./objs/ffmpeg/bin/ffmpeg SRS转码用的FFMPEG,DEMO推流也是用它
- ./objs/lib/srs_librtmp.a SRS提供的客户端库,参考srs-librtmp
- ./objs/nginx/html/players SRS的DEMO的静态页面,当没有开启HttpCallback时
SRS的配置(configure)参数说明如下:
- --help 配置的帮助信息
- --with-ssl 添加ssl支持,ssl用来支持复杂握手。参考:RTMP Handshake。
- --with-hls 支持HLS输出,将RTMP流切片成ts,可用于支持移动端HLS(IOS/Android),不过PC端jwplayer也支持HLS。参考:HLS
- --with-dvr 支持将RTMP流录制成FLV。参考:DVR
- --with-nginx 编译nginx,使用nginx作为web服务器分发HLS文件,以及demo的静态页等。
- --with-http-callback 支持http回调接口,用于认证,统计,事件处理等。参考:HTTP callback
- --with-http-api 打开HTTP管理接口。参考:HTTP API
- --with-http-server 打开内置HTTP服务器,支持分发HTTP流。参考:HTTP Server
- --with-ffmpeg 编译转码/转封装/采集用的工具FFMPEG。参考:FFMPEG
- --with-transcode 直播流转码功能。需要在配置中指定转码工具。参考:FFMPEG
- --with-ingest 采集文件/流/设备数据,封装为RTMP流后,推送到SRS。参考:Ingest
- --with-stat 是否开启数据统计功能,SRS可以采集cpu/内存/网络/磁盘IO等数据,供监控系统通过http-api获取。(目前osx不支持)。
- --with-research 是否编译research目录的文件,research目录是一些调研,譬如ts info是做HLS时调研的ts标准。和SRS的功能没有关系,仅供参考。
- --with-utest 是否编译SRS的单元测试,默认开启,也可以关闭。
- --with-gperf 是否使用google的tcmalloc库,默认关闭。
- --with-gmc 是否使用gperf的内存检测,编译后启动srs会检测内存错误。这个选项会导致低性能,只应该在找内存泄漏时才开启。默认关闭。参考:gperf
- --with-gmp 是否使用gperf的内存性能分析,编译后srs退出时会生成内存分析报告。这个选项会导致地性能,只应该在调优时开启。默认关闭。参考:gperf
- --with-gcp 是否启用gperf的CPU性能分析,编译后srs退出时会生成CPU分析报告。这个选项会导致地性能,只应该在调优时开启。默认关闭。参考:gperf
- --with-gprof 是否启用gprof性能分析,编译后srs会生成CPU分析报告。这个选项会导致地性能,只应该在调优时开启。默认关闭。参考:gprof
- --with-librtmp 客户端推流/播放库,参考srs-librtmp
- --with-arm-ubuntu12 交叉编译ARM上运行的SRS,要求系统是Ubuntu12。参考srs-arm
- --jobs[=N] 开启的编译进程数,和make的-j(--jobs)一样,在configure时可能会编译nginx/ffmpeg等工具,可以开启多个jobs编译,可以显著加速。参考:Build: jobs
- --static 使用静态链接。指定arm编译时,会自动打开这个选项。手动编译需要用户自身打开。参考:ARM
预设集:
- --x86-x64,默认预设集,一般的x86或x64服务器使用。release使用这个配置编译。
- --osx,苹果MAC OSX(Darwin)系统下编译,安装好xcode和brew后,可以使用这个选项。
- --pi,树莓派预设集,arm的子集。树莓派的release用这个配置编译。
- --cubie,在cubieboard下直接编译的选项,使用ubuntu差不多的配置集。
- --arm,ubuntu下交叉编译,等价于--with-arm-ubuntu12。release使用这个配置。
- --mips,ubuntu下交叉编译,为hiwifi的mips路由器编译。(目前srs在mips上有内存泄漏,2天左右会把路由器跑死)。
- --dev,开发选项,尽可能开启功能。
- --fast,关闭所有功能,只支持基本RTMP(不支持h264/aac),最快的编译速度。
- --pure-rtmp,支持RTMP(支持h264+aac),需要编译ssl。
- --rtmp-hls,支持RTMP和HLS,典型的应用方式。还可以加上内置的http服务器(--with-http-server)。
- --disable-all, 禁用所有功能,只支持rtmp(vp6)。
- --demo,SRS的演示编译选项。
- --full,开启SRS所有的功能。
专家选项:有可能编译失败,不是专家就不要用这个。
- --use-sys-ssl 使用系统的ssl,不单独编译ssl(在--with-ssl时有效)。
Winlin 2014.2
Welcome to SRS wiki!
Please select your language:
Please select your language:
Please select your language:
Please select your language:
Please select your language: