segator/proxylive

proxylive

镜像概述和主要用途

proxylive是一款视频流转码与广播应用，可将HTTP MPEG-TS流按需转码为MPEG-TS或HLS格式并分发给多个客户端。核心价值在于实现多客户端共享单个后端连接，降低资源占用；支持按需转码以适配不同设备或带宽需求，并提供多源故障切换、EPG（电子节目指南）及用户认证功能，适用于家庭媒体中心或小型直播分发场景。

核心功能和特性

• 广播功能：多个用户连接同一频道时，仅占用单个后端连接，减少资源消耗。
• 按需转码：可定义FFmpeg转码配置文件，将流转换为所需格式（支持MPEG-TS和HLS容器）。
• 实时M3u播放列表：自动生成实时M3u播放列表，便于客户端获取频道列表。
• 用户认证：支持Plex认证和LDAP认证（LDAP暂未实现），仅允许授权用户访问。
• 多源故障切换：单个频道可配置多个源，当主源故障时自动切换至备用源，不中断用户连接或转码。
• EPG支持：可获取并提供电子节目指南数据。

频道源类型

Tvheadend源

自动加载Tvheadend中的所有频道，需配置Tvheadend连接信息及频道刷新间隔。

配置示例（application.yaml）：

yaml
source:
    tvheadendURL: http://user:password@your.tvheadend.com:9981
    channels:
        type: tvheadend
        refresh: 60 # 刷新间隔（秒）

自定义JSON源

通过JSON文件定义频道信息，支持从文件/URL或Git仓库加载，配置刷新机制。

文件/URL方式

定期从指定文件路径或URL读取JSON数据。

配置示例（application.yaml）：

yaml
source:
    channels:
        type: json
        refresh: 60 # 刷新间隔（秒）
        url: file:///my/disk/channels.json 或 http://my.server.com/channels.json

Git方式

从Git仓库读取频道数据和图标（picons），仅在检测到新提交时刷新。

配置示例（application.yaml）：

yaml
source:
    channels:
        git:
            repository: https://github.com/user/repo.git
            # 可选配置
            user: youruser
            pass: yourpass 
            branch: master
        type: json
        refresh: 60 # 刷新间隔（秒）

channels.json示例：

json
[ 
    {
      "number" : 1,
      "name" : "La 1 HD",
      "id" : "la1hd",
      "epgID" : "La 1 HD",
      "logoFile":"/picons/la1hd.png",
      "logoURL": "http://server.com/logo.png",
      "categories" : [ "Generales", "TDT" ],
      "ffmpegParameters": "额外的FFmpeg参数（可选，用于MTPS提取）",
      "sources" : [ 
          {
            "url" : "http://your/server/stream",
            "priority" : 1,
            "type" : "ffmpeg"  // 强制使用FFmpeg处理原始流（适用于MTPS）
          },
          {
            "url" : "udp://225.225.201.1:8008",
            "closeHook": "http://myServer/hook?myChannel={{channel}}&date={{now}}",
            "priority" : 2
          },
          {
            "url" : "rtp://200.100.1500:1001",
            "priority" : 3
          },
          {
            "url" : "hlss://my.server/my/stream.m3u8",  // hls或hlss（TLS加密）
            "closeHook": "pipe://echo \"Closed channel {{channel}} when {{now}}\" > example.txt",
            "priority" : 4
          },
          {
            "url" : "dashs://my.server/my/stream.m3u8",  // dash或dashs（TLS加密）
            "priority" : 5
          },
          {
            "url" : "rtmp://my.server/rtmp/live",
            "priority" : 6
          },
          {
            "url" : "pipe://raspivid -o - -t 0 -fps 25 -g 50 -rot 180 -n -a 12 -b 6000000",  // 处理进程输入流
            "priority" : 7
          }    
      ]
    }
]

图标说明：图标可通过logoFile（本地路径）或logoURL（远程URL）指定，logoURL会被缓存，客户端将从proxylive请求图标。使用Git源时，图标需存放于仓库根目录。

详细配置说明

需在运行目录（Docker环境下为/app/）创建application.yaml配置文件，主要配置项如下：

基础配置

yaml
source:
    # 源连接重试间隔（秒），可选
    reconnectTimeout: 10
    # EPG配置（可选）
    epg:
        url: http://tvheadend:9981/xmltv/channels  # EPG数据URL
        refresh: 600  # 刷新间隔（秒，默认10分钟）
    channels:  # 频道源配置，详见“频道源类型”
        # ...（根据源类型配置）
# 连接后端HTTP(S)流时使用的User-Agent
userAgent: "Proxylive"
# 流超时时间（秒）：后端无数据传输时关闭客户端连接
streamTimeout: 60

FFmpeg配置

用于定义转码路径及转码配置文件（profiles）：

yaml
ffmpeg:
    # FFmpeg可执行文件路径
    path: '/usr/bin/ffmpeg'
    
    # 转码配置文件（profiles），alias用于URL中的profile参数
    profiles:
        -
            alias: "aac"  # 音频转码示例
            parameters: "-i {input} {channelParameters} -sn -ac 2 -c:a aac -b:a 320k -c:v copy"
        -
            alias: "240p"  # 240p视频转码示例
            parameters: "-i {input} {channelParameters} -sn -c:a:0 aac -ac 2 -b:a 64k -c:v libx264 -tune zerolatency -g 10 -vprofile high -level 4.0 -crf 18 -movflags +faststart -bufsize 15000k -maxrate 300k  -preset veryslow -vf scale=-1:244,yadif=0"
        # 更多配置文件（360p、480p、720p、1080p等）...

    # MPEG-TS输出参数（非“raw”配置文件时生效）
    mpegTS:
        parameters: "-threads 0 -f mpegts -mpegts_m2ts_mode 1 -mpegts_copyts 1 -mpegts_flags +resend_headers"
    
    # HLS输出配置（默认禁用）
    hls:
        enabled: false  # 是否启用HLS
        tempPath: "/tmp"  # HLS分片文件存储路径
        parameters: "-flags -global_header -avoid_negative_ts disabled -map_metadata -1 -start_at_zero -copyts -flags -global_header -vsync cfr -y -nostats -f hls -hls_time 2 -hls_list_size 10 -hls_wrap 20 -hls_allow_cache 0 -hls_flags +append_list -hls_flags +discont_start -hls_flags +delete_segments"
        timeout: 30  # 用户断开后保留转码的超时时间（秒）

缓冲区配置

yaml
buffers:
    # 单次读取流的最大字节数，默认1MB
    chunkSize: 1048576
    # 广播缓冲区大小，默认50MB（ larger buffer更稳定但延迟更高）
    broadcastBufferSize: 52428800

认证配置

支持Plex认证（LDAP暂未实现），配置示例：

yaml
authentication:
    # Plex认证
    plex:
        refresh: 10800  # 用户列表刷新间隔（秒，默认3小时）
        adminUser: "plexOwnerUser"  # Plex管理员用户名
        adminPass: "plexOwnerPass"  # Plex管理员密码
        serverName: "MyPlexServerName"  # Plex服务器名称（仅允许管理员授权的用户访问）

    # LDAP认证（未实现）
    # ldap:
    #     server: "ldap://server:389"
    #     username: "user"
    #     pass: "pass"
    #     searchBase: "dc=ad,dc=my-domain,dc=com"

客户端连接示例（带认证参数）：

http://localhost:8080/channel/list/mpeg/1080p?user=myplexuser&pass=myplexpass

URL定义

获取直播流

http://{server}:8080/view/{profile}/{channelID}

• server：proxylive服务IP/域名
• profile：转码配置文件别名（如1080p、aac，定义于ffmpeg.profiles）
• channelID：频道唯一标识（Tvheadend源为streamID，自定义JSON源为id字段）

获取频道播放列表

http://{server}:8080/channel/list/{format}/{profile}?user={user}&pass={pass}  # 带认证
http://{server}:8080/channel/list/{format}/{profile}  # 无认证

• format：输出格式，支持mpeg（MPEG-TS）或hls（HLS）

获取EPG数据

http://{server}:8080/epg

使用场景

• 家庭媒体中心：将Tvheadend等源的直播流分发给多台设备（如电视、手机），按需转码适配设备性能。
• 小型直播分发：企业或组织内部直播，通过认证控制访问权限，降低后端源带宽压力。

部署与运行

环境要求

• Docker（推荐）或JRE 8+
• FFmpeg已安装（容器内默认包含，本地运行需自行安装）

Docker部署示例

bash
docker run --name=proxylive -p 8080:8080 --restart=always -d -v /path/to/your/application.yml:/app/application.yml:ro segator/proxylive

• -p 8080:8080：映射服务端口（容器内默认8080）
• -v /path/to/your/application.yml:/app/application.yml:ro：挂载本地配置文件（只读）
• --restart=always：容器退出时自动重启

本地运行（非Docker）

1. 准备application.yaml配置文件
2. 执行命令：java -jar proxylive.jar（需JRE 8+及FFmpeg）

核心优势

• 资源优化：多客户端共享单源连接，相同转码配置的流仅转码一次，降低CPU/带宽占用。
• 高可用性：多源故障自动切换，保障流服务不中断。
• 灵活适配：自定义转码配置文件，支持不同分辨率、码率需求。