# 系统事件配置
events {
    # 略
}

http {
    # 略
}


# 开启自动推送流, 只允许被放置在根配置
# 默认情况下, 若 FFmpeg/OBS 等推流端因网络波动、进程异常、服务器重启等原因断开与 Nginx RTMP 服务的连接
# 如果设置 rtmp_auto_push 之后会主动等待推流端重新建立连接, 恢复推流后自动接续分发
# rtmp_auto_push_reconnect 则是设定自动开启之后每次重连的间隔
rtmp_auto_push on;
rtmp_auto_push_reconnect 1s;


# RTMP 模块通用配置
rtmp {
    # 日志配置
    access_log /var/log/nginx/rtmp_access.log; 
    
    # 具体配置可以查看 https://github.com/arut/nginx-rtmp-module
    # 引用加载其他服务目录的文件配置 
    include /etc/nginx/rtmp.d/*.conf;
}

server {
    listen 1935;         # RTMP 默认端口, 可自定义
    chunk_size 4096;     # 数据块大小, 优化小文件推流
    max_message 1M;      # 单包最大尺寸, 防止恶意数据
    timeout 60s;         # 延长连接超时，避免短连接导致数据中断
    ping 30s;            # 每30s发送心跳包，维持推/拉流连接
    ping_timeout 10s;    # 心跳超时时间，避免假死连接
    
    # 核心直播应用（推/拉流核心标识）
    # 这里其实和 http-location 一样, 用来声明访问路径, 也就是访问的是 rtmp://{服务地址}:{listen}/{application声明路径}/{自定义推送名称:也就是推流码}
    # 最后访问的就是类似 127.0.0.1:1935/live/{自定义推送名称:推流码}
    # 这里其实有 BUG, 也就是不知道是不是 Ngnix 实现有问题, {推流码} 其实是无效的, 推流和拉流最后只能通过 rtmp://{服务地址}:{listen}/{application} 处理
    # 后面会说明这个 BUG, 我也是网上找资料之后才发现这个问题
    application live {
        live on;    # 开启直播模式
        record off; # 不需要做流录制
        meta copy;  # 保留推流的元数据(必须加, 否则播放端解析不到流信息)
        interleave on;  # 交织音频/视频包(RTMP 标准要求)
        
        # 允许推流, 可限制IP
        # 因为我们的流其实就是本地视频文件, 所以推流的地址也就是我们本地
        allow publish 127.0.0.1;
        
        # 如果我们需要多个推送来源可以不断附加
        # 支持范用的匹配机制支持内网IP访问
        allow publish 192.168.1.0/24;
        
        
        # 拒绝所有未在白名单的IP推流必须放在最后
        # 建议不相关的地址全都禁止, 避免被其他嗅探到
        deny publish all;
        
        # 如果 20s 内没有 push 行为就断开连接
        drop_idle_publisher 20s;
        
        # 允许拉流, 允许所有来源的地址进行拉取流播放
        # 如果要封禁指定操作也是如下
        # deny play 111.111.111.111
        allow play all;
    }
    
    # 如果是本地文件需要将自动转为 rtmp 可以直接配置目录
    # 这里声明 files, 则是直接访问 rtmp://{服务地址}:{listen}/{application声明路径}/{文件名}
    # 但是需要注意: 这种方式只能处理 mp4 格式文件, 无法处理其他格式文件
    application files {
        # 这里我路径有 /data/media/anime-1.mp4 文件, 可以直接映射到内部转化为流
        # 也就是最后播放地址是 rtmp://127.0.0.1:1935/files/anime-1.mp4
        # 如果单独的单文件播放的话, 这种方式就足够支持了, 但是没办法做到多个视频轮播这种功能
        play /data/media;
    }
    
    # 另外还有个小技巧, 就是网络文件的的流转发
    # 如果远程服务器有个 http://localhost:8080/files/video.mp4 文件
    # 那么依靠这种方式可以读取并自动将影片解码成 rtmp 协议
    # 依靠这种方法可以播放远程 rtmp://127.0.0.1:1935/remote/video.mp4 资源 
    # 这种适合本地内网本身有另外服务器专门保存的情况, 直接转发给内网挂载在 Web 上的资源就行了
    #application remote {
    #    play http://localhost:8080/files/;
    #}
}

# 我们上面说过的 NGINX 可能算是 BUG 的问题
# 比如设置 /live/movie 推流
rtmp://127.0.0.1:1935/live/movie
# 采用这种方式是没办法接收到流

# 而是必须要采用无推送码推送
# 只有这样才能被正确推流和拉流
rtmp://127.0.0.1:1935/live

# 这样来转发内网的资源, 只需要内网服务器开个 nginx 把资源暴露出来
# 但是需要注意: 这种方式只能处理 mp4 格式文件
application remote {
    play http://localhost:8080/files/;
}

server {
    listen 1936;        # 这里为了规避原来的 live 配置该了端口 
    chunk_size 4096;     # 数据块大小, 优化小文件推流
    max_message 1M;      # 单包最大尺寸, 防止恶意数据
    timeout 60s;         # 延长连接超时，避免短连接导致数据中断
    ping 30s;            # 每30s发送心跳包，维持推/拉流连接
    ping_timeout 10s;    # 心跳超时时间，避免假死连接

    # HLS 核心应用(切片存储+分发)
    application hls {
        live on;        # 开启直播模式
        record off;     # 不需要做流录制
        meta copy;      # 保留推流的元数据(必须加, 否则播放端解析不到流信息)
        interleave on;  # 交织音频/视频包(RTMP 标准要求)
        
        # 允许推流的IP(本地/内网)
        allow publish 127.0.0.1;
        allow publish 192.168.1.0/24;
        deny publish all;
        allow play all;

        # HLS 切片核心配置
        hls on;                          # 开启HLS切片
        hls_path /data/frames/hls/;      # 切片文件存储目录(需提前创建并赋权), 这里就是 http-hls 访问的目录
        hls_fragment 5s;                 # 切片时长(建议3-10s，越小延迟越低)
        hls_playlist_length 30s;         # 播放列表保留的切片时长(至少大于1个切片)
        hls_continuous on;               # 断流后重新推流时，继续追加切片(而非新建)
        hls_cleanup on;                  # 自动清理过期切片(防止磁盘占满), 如果想持久化保存流则需要直接关闭
        hls_nested on;                   # 按流名称创建子目录存储切片(避免冲突)
        hls_type live;                   # 直播模式(区别于点播)
    }

    # HLS 点播应用(直接播放本地切片文件)
    application hls_play {
        play /data/frames/hls/;          # 直接读取已生成的.m3u8和.ts文件
    }
}