📺 ysptp CCTV 直播代理 · Docker 部署文档
📢 重点说明
『IPTV研究所』 ✈️ TG 频道：https://t.me/GPT_858 欢迎各位加入交流
『IPTV直播源总部』 ✈️ TG 频道： https://t.me/iptvorganization 欢迎各位加入交流！
| 项目 | 内容 |
|---|---|
| 镜像地址 | instituteiptv/ysptp-yang:latest |
| 固定版本（推荐生产用） | instituteiptv/ysptp-yang:0.0.1 |
| 支持架构 | linux/amd64 · linux/arm64 · linux/arm/v7（自动匹配） |
| 默认端口 | 8766 |
docker run -d --name ysptp --restart unless-stopped \
-p 8766:8766 \
-v /opt/ysptp/data:/data \
instituteiptv/ysptp-yang:latest
参数说明
| 参数 | 说明 |
|---|---|
-d | 后台运行 |
--name ysptp | 容器名称 |
--restart unless-stopped | 开机自启，异常退出自动重启 |
-p 8766:8766 | 端口映射（宿主机端口:容器端口） |
-v /opt/ysptp/data:/data | 🔒 状态持久化：设备身份（device-state-rs.json）和频道缓存（proxy-cache-state-rs.json）保存在宿主机，重建容器不丢失 |
🔧 改端口示例（宿主机用 8080，容器内固定 8766，只改冒号左边）：
docker run -d --name ysptp --restart unless-stopped \
-p 8080:8766 \
-v /opt/ysptp/data:/data \
instituteiptv/ysptp-yang:latest
docker-compose.yml
services:
ysptp:
image: instituteiptv/ysptp-yang:latest
container_name: ysptp
restart: unless-stopped
ports:
- "8766:8766"
volumes:
- /opt/ysptp/data:/data
常用命令
docker compose up -d # ▶️ 启动
docker compose logs -f # 📋 实时看日志（Ctrl+C 退出）
docker compose restart # 🔄 重启
docker compose down # ⏹️ 停止并删除容器（/opt/ysptp/data 数据保留）
⬆️ 更新到新版镜像
docker compose pull # 拉取新版
docker compose up -d # 重新创建容器完成更新
docker logs -f ysptp
看到以下日志说明服务正常：
程序初始化中
程序获取直播源中
程序已成功获取cctv5的直播源
浏览器打开 http://服务器IP:8766/4kfifa.m3u，能下载到播放列表即成功 ✅
📡 频道地址（把 服务器IP 换成实际 IP）：
| 用途 | 地址 |
|---|---|
| 全频道合集 | http://服务器IP:8766/4kfifa.m3u |
| 单频道 | http://服务器IP:8766/cctv5（可加 .m3u8 后缀） |
| 可选频道 | cctv5 · cctv5p · cctv164k · cctv4k · cctv8k |
| 状态查看 | http://服务器IP:8766/status?token=GPT_858 |
| 广告开关 | http://服务器IP:8766/switch?token=GPT_858&ad=display|nodisplay |
把地址填进 VLC / PotPlayer / TiviMate / IPTV Pro 即可播放 ▶️
服务器上如果还跑着 systemd + 二进制的老版本，先停掉，避免端口冲突：
sudo systemctl stop ysptp
sudo systemctl disable ysptp
想保留已注册好的设备身份，把老二进制旁边的 device-state-rs.json
复制到 /opt/ysptp/data/ 再启动容器；不复制则容器会自动生成一套新的。
先本机测试：curl -s http://127.0.0.1:8766/4kfifa.m3u | head。
本机通、外面不通 → 云服务器安全组 / 防火墙没放行 8766。
去控制台加一条 TCP 8766 入站规则；本机 ufw 开了的话：sudo ufw allow 8766/tcp。
正常现象。程序正在向上游实时获取直播源（日志显示"程序获取直播源中"）， 成功后走缓存就快了。
看 docker logs ysptp 里的错误信息，多半是上游限流。
等几分钟，或删除 /opt/ysptp/data/device-state-rs.json 后重启容器换一套设备身份。
rm /opt/ysptp/data/device-state-rs.json /opt/ysptp/data/proxy-cache-state-rs.json
docker restart ysptp
📢 本源码由『IPTV直播源总部』提供 ✈️ TG：https://t.me/iptvorganization —— 欢迎各位加入！
Content type
Image
Digest
sha256:a7c1e8c09…
Size
34.7 MB
Last updated
13 days ago
docker pull instituteiptv/ysptp-yang