instituteiptv/ysp-yang repository overview

⁠ysp-live v3 — 央视频全频道直播代理（Docker 版）

63 路央视频直播频道的 HLS 代理服务：JCE 主协议 + bkliveinfo 备用双通道取流， 纯 Python 标准库实现，经 Cython 编译为 .so（镜像内无任何 .py 源码）。 真 4K 后端（ysptp-project，gsnw 设备注册协议）已按架构内置，开箱即用。

⁠快速开始

docker pull instituteiptv/ysp-yang:latest

docker run -d --pull always --name ysp-live --restart unless-stopped \
  -p 8767:8767 instituteiptv/ysp-yang:latest

浏览器打开 http://服务器IP:8767/ 即可看到 63 路频道列表。

⁠访问地址

⁠自定义端口

# 用 8888 端口：-p 映射与启动参数保持一致
docker run -d --pull always --name ysp-live --restart unless-stopped \
  -p 8888:8888 instituteiptv/ysp-yang:latest 8888

⁠纯 1080p 模式（关闭 4K 后端）

docker run -d --pull always --name ysp-live --restart unless-stopped \
  -p 8767:8767 instituteiptv/ysp-yang:latest --no-4k

⁠docker compose

services:
  ysp-live:
    image: instituteiptv/ysp-yang:latest
    container_name: ysp-live
    ports:
      - "8767:8767"
    restart: unless-stopped
    # command: ["--no-4k"]   # 需要纯 1080p 模式时取消注释

⁠多架构支持

一次推送包含三个架构，docker pull 会按机器自动选择：

每个架构的镜像都内置了对应架构的真 4K 后端，无需额外配置。

⁠真 4K 说明

5 路设备协议频道（cctv5 / cctv5+ / cctv4k / cctv8k / cctv164k） 由内置后端提供真 4K 流；其余 58 路频道上游本身只提供 1080p， 这是源站限制，与本镜像无关。

⁠常见问题

• 更新后跑起来的还是旧版本：docker run 默认优先用本机缓存的镜像。 删掉旧容器和旧镜像再重跑，或直接在 docker run 里加 --pull always：

  docker stop ysp-live && docker rm ysp-live
  docker rmi instituteiptv/ysp-yang:latest
  docker run -d --pull always --name ysp-live --restart unless-stopped \
    -p 8767:8767 instituteiptv/ysp-yang:latest
  

  Copy

  验证是否最新：docker logs ysp-live 看启动日志，或打开 http://IP:8767/diag 确认服务正常。

• 某频道返回 503：上游取流超时，服务会自动降级并在后台重试， 稍后刷新即可，不是容器故障。

• 首次启动某频道较慢：JCE 协议需要握手建连，之后会缓存复用。

• 日志里看到 4K 后端探测信息：正常启动流程，不影响使用； 不想看到可加 --no-4k 参数。

⁠安全提示

服务监听 0.0.0.0 且无鉴权，请仅在可信内网使用。 如需暴露到公网，务必在前面加反向代理（Nginx / Caddy）并自行配置鉴权。

⁠免责声明

本镜像仅供技术学习交流，直播流版权归属央视频及各频道方。 请遵守当地法律法规，勿用于商业用途。