v3_EN_Home

HOME > EN

SRS Overview

SRS is a simple, high efficiency and realtime video server, supports RTMP/HLS/HTTP-FLV.

Getting Started

Get SRS source, recommend CentOS7:

git clone -b 3.0release https://github.com/ossrs/srs.git

Build SRS in srs/trunk:

cd srs/trunk
./configure
make

Run SRS server:

./objs/srs -c conf/srs.conf

Check SRS by http://localhost:8080/ or:

# Check the process status
./etc/init.d/srs status

# Check the SRS logs
tail -f ./objs/srs.log

Publish stream by FFmpeg or OBS :

ffmpeg -re -i ./doc/source.flv -c copy -f flv -y rtmp://localhost/live/livestream

Play stream by:

• RTMP (by VLC): rtmp://localhost/live/livestream
• H5(HTTP-FLV): http://localhost:8080/live/livestream.flv
• H5(HLS): http://localhost:8080/live/livestream.m3u8

Please read more information about SRS.

Docker

Run SRS docker, the available images is here :

docker run --rm -it -p 1935:1935 -p 1985:1985 -p 8080:8080 \
    ossrs/srs:3 ./objs/srs -c conf/srs.conf

Please read more information about SRS.

Effective SRS

SRS is industrial-strength live streaming cluster, for the best conceptual integrity and the simplest implementation. SRS provides variety of inputs, for example, Push RTMP to SRS, Push RTSP/UDP/FLV to SRS, Pull Stream to SRS. SRS can transform the RTMP to other protocols or deliveries, for example, RTMP Transcode, Snapshot, Forward to Other Servers, Transmux to HTTP-FLV, Transmux to HLS, Transmux to HDS, Transmux to DASH, DVR to FLV/MP4. SRS canbe used in CDN for large stream clusters, for example, RTMP Cluster、 OriginCluster, VHOST, Reload, HTTP-FLV Cluster. Futhermore, SRS provides apis, for example, HTTP Callback, Security, HTTP API, RTMP Bandwidth Test. There're lots of Applications in both CDN and origin servers.

Note: Please read https://www.processon.com/view/link/5e3f5581e4b0a3daae80ecef for details.

User Guides:

• Quick Start: A quick introduction of SRS, please start here.
• Milestones: The milestone and product design。
• Why SRS: Why you should choose SRS? What's the roadmap?
• GIT Mirrors: The GIT mirrors of SRS to get SRS faster.
• Main Features: The features list of SRS. Some features is introduced from specified version; while some features are experiment.
• Releases: The released versions of SRS.
• Docs: The detail tech docs of SRS.

Deployment Guides:

We illustrate and explain how to deploy SRS for typical use scenarios.

• Delivery RTMP: How to delivery RTMP using SRS.
• Delivery HLS: How to delivery RTMP and HLS using SRS.
• Delivery HTTP FLV: How to remux RTMP to HTTP FLV stream.
• Delivery HDS: How to delivery HDS using SRS.
• Delivery DASH: How to delivery DASH using SRS.
• Transcode: How to transcode the RTMP stream.
• Snapshot: How to snapshot thumbnail of RTMP stream.
• Forward: How to forward RTMP to other servers.
• Low latency: How to deploy the low latency SRS.
• Ingest: How to ingest other streams to SRS.
• HTTP Server: How to deploy SRS as HTTP server.
• SRS DEMO: How to deploy the demo of SRS.
• Projects: Who are using SRS.
• Setup: How to setup SRS.

Cluster Guides:

The examples here are aimed for deploying and maintaining origin/edge cluster.

• Origin Cluster: Origin Cluster for huge streams or fault tolerance.
• Edge Cluster: RTMP: Edge Cluster for RTMP streaming.
• Edge Cluster: FLV: Edge Cluster for HTTP-FLV streaming.
• VHOST: Support multiple customers in the same cluster by vhost.
• Reload: Apply changed config by reload.
• Tracable Log: Debug and trace user in cluster log.
• Log Rotate: How to rotate the log.

Integration Guides:

• Linux Service: Start or stop SRS as service.
• HTTP Callback: Use HTTP callback to hook the events of SRS.
• HTTP API: Get system data from HTTP API of SRS.
• RTMP Bandwidth: Use bandwidth api to test the available bandwidth for SRS.
• Special Control: Some special control config for expert.

Migrate From NGINX-RTMP:

If you are a user of nginx-rtmp, there is a tendency to use SRS as nginx-rtmp that you already know. Be aware of this bias and try to avoid it.

• NG EXEC: Fork/Exec external program when got some event.

Benchmarks:

• Compare: The comparation of SRS to other servers.
• Performance: The performance benchmark.

Join Us:

• How to file a issue to SRS?
• File Issue: File an issue.
• Contact: Contact us by DingTalk or Wechat.

Develop Guide

• SRS Code Analysis, code and arch.
• SRS Librtmp: Exported librtmp library by SRS, can be used to push or pull stream over RTMP, and it's C++ code to compile for Android or iOS.
• Third-party Client SDK: For mobile platform, such as Android and iOS, there are some client SDKs to publish or play live stream.

Questions or need help?

For any help, contact us.

Winlin 2015.7