# BLSS

**Repository Path**: yangzheyu/BLSS

## Basic Information

- **Project Name**: BLSS
- **Description**: nginx http flv
- **Primary Language**: Unknown
- **License**: BSD-2-Clause
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 1
- **Created**: 2018-08-16
- **Last Updated**: 2024-06-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README


BLSS: Bravo Live Streaming Service 
======================================

[![Powered][1]][2] [![Build Status][3]][4] [![Downloads][5]][6]

[1]: https://img.shields.io/badge/nginx--rtmp--module-Powered-blue.svg
[2]: https://github.com/arut/nginx-rtmp-module
[3]: https://travis-ci.org/gnolizuh/BLSS.svg?branch=master
[4]: https://travis-ci.org/gnolizuh/BLSS
[5]: https://img.shields.io/github/downloads/atom/atom/total.svg
[6]: https://github.com/gnolizuh/BLSS/releases

[README in english](https://github.com/gnolizuh/BLSS/blob/master/README.md) 

# 简介

BLSS是一个NGINX第三方模块，它基于开源项目[nginx-rtmp-module](https://github.com/arut/nginx-rtmp-module)二次开发实现，保留了原有特性的基础上提供一些关键功能，
如**HTTP-FLV协议的分发、GOP缓存、正则匹配推拉流域名、vhost**等。

# 安装方法

下载[nginx](https://nginx.org/)：

    wget https://nginx.org/download/nginx-$VERSION.tar.gz
    tar zxvf nginx-$VERSION.tar.gz

下载[BLSS](https://github.com/gnolizuh/BLSS/releases)：

    wget https://github.com/gnolizuh/BLSS/archive/v1.1.4.tar.gz
    tar zxvf v1.1.4.tar.gz

编译安装：

    cd NGINX-SRC-DIR
    ./configure --add-module=/path/to/BLSS
    make
    make install

编译DEBUG模式(输出DEBUG日志)：

    ./configure --add-module=/path/to/BLSS --with-debug

# 配置步骤

修改配置文件如下：

    worker_processes 8;   # 开启多进程模式
    relay_stream hash;    # 选择多进程级联工作模式

    # rtmp 相关配置
    rtmp {
        server {
            listen 1935 reuseport;

            service cctv {
                hostname pub rtmp *.pub.rtmp.cctv;         # 正则匹配RTMP推流域名
                hostname sub rtmp *.sub.rtmp.cctv;         # 正则匹配RTMP拉流域名
                hostname sub http_flv *.sub.httpflv.cctv;  # 正则匹配HTTP-FLV拉流域名

                application news {
                    live on;
                    gop_cache on;
                    gop_cache_count 5;  # cache 5 GOPs

                    hls on;
                    hls_fragment 10s;
                    hls_playlist_length 30s;
                }

                application sports {
                    hls on;
                    hls_fragment 1m;
                    hls_playlist_length 3m;
                }
            }
        }
    }
    
    http {
        include      mime.types;
        default_type application/octet-stream;

        log_format   main  '$remote_addr - $remote_user [$time_local] "$request" '
                            '$status $body_bytes_sent "$http_referer" '
                            '"$http_user_agent" "$http_x_forwarded_for"';

        access_log   logs/http_sla.log main;

        keepalive_timeout 60;

        server {
            listen 80 reuseport;

            location / {

                add_header 'Content-Type' 'video/x-flv';      # content type header
                add_header 'Access-Control-Allow-Origin' '*'; # cross-domain header

                http_flv on;    # 开启http-flv分发模式
            }
        }
    }

启动nginx

    ./obj/nginx -p /path/to/nginx

# 测试

## 测试工具

- [OBS](https://obsproject.com/) [**推流**]
- [FFMPEG](https://ffmpeg.org/) [**推流/播放**]
- [VLC](http://www.videolan.org/vlc/) [**播放**]

## 测试方法

### 推流

客户端需要绑定HOST：

    192.168.1.100 test.pub.rtmp.cctv     # RTMP推流地址

下面以FFMPEG进行RTMP推流：

    ffmpeg -re -i movie.flv -vcodec copy -acodec copy -f flv rtmp://test.pub.rtmp.cctv/news/test

以IP形式进行推流：

    ffmpeg -re -i movie.flv -vcodec copy -acodec copy -f flv rtmp://192.168.1.100/test.pub.rtmp.cctv/news/test

### 播放

客户端需要绑定HOST：

    192.168.1.100 test.sub.rtmp.cctv     # RTMP播放地址
    192.168.1.100 test.sub.httpflv.cctv  # HTTP-FLV播放地址

使用播放器进行RTMP/HTTP-FLV播放：

    rtmp://test.sub.rtmp.cctv/news/test
    http://test.sub.httpflv.cctv/news/test.flv

以IP形式进行播放

    rtmp://192.168.1.100/test.sub.rtmp.cctv/news/test
    http://192.168.1.100/test.sub.httpflv.cctv/news/test.flv