Need help with media-server?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

200 Stars 60 Forks Apache License 2.0 22 Commits 2 Opened issues


A brpc-based server to host and proxy live streams

Services available


Need anything else?

Contributors list


media-server is a live streaming server based on brpc used in Live Streaming Service of Baidu Cloud.

Main features

Getting Started

Supported operating system: Linux, MacOSX.

  • Install brpc which is the main dependency of media-server
  • Compile media-server with cmake:
    mkdir build && cd build && cmake .. && make -sj4
  • Run media-server as origin server with minimum configuration(the default port is 8079):
    Then you can push/play stream from it.

Main options

Please run

./output/bin/media_server --help
to get all configurations in detail.
  • -proxy_to When not specified or empty, media-server runs in origin mode, which aggregates push(such as OBS, ffmpeg) and accepts play(such as cyberplayer, ffplay) requests.

  • -proxylb When -proxyto is a naming service(such as http://...), you need to specify load balancing algorithm. The options are rr, random, la, cmurmurhash and cmd5. Read client load balancing for details.

  • -port Specifies the service port of media-server. Brpc is characterized by supporting all protocols on the same port, so this port can also be used for accessing the built-in service via http. Only ports in the range of 8000-9000 can be accessed by browsers, which means if the service port is external, be sure to configure -internal_port to prevent built-in service from leaking detailed service information.

  • -internal_port This port can be configured as a port that can only be accessed on the internal network. In this case, the -port port no longer provides built-in services, but will only be accessible through this port.

  • -retryintervalms When media-server runs in edge mode, push and pull requests to upstreams will be retried when error happens until clients no longer need. This option specifies the minimum interval for continuous retry, which is 1 second by default.

  • -shareplayconnection When set to true, multiple streams connected to the same server will reuse the same rtmp connection in play.

  • -sharepublishconnection When set to true, multiple streams connected to the same server will reuse the same rtmp connection in publish.

  • -timeout_ms Timeout period for creating a stream when media-server runs in edge mode. The default value is 1000ms.

  • -serveridletimeout Connections without data transmission for so many seconds will be closed. The default value is -1(turned off).

  • -cdnmergeto When this option is set, media-server starts two ports, one for external service request and the other for the aggregating request. Usually the aggregating server will be found using consistent hashing, which is used widely in cache service. This option is often used in cdn nodes.

  • -cdnmergelb The load balancing algorithm. Read the explanation written below -proxy_lb.

  • -flagfile media-server uses gflags options, which is specified by default in the command line and can also in file format during online deployment by using -flagfile.


Other docs

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.