距离 v2.3 版本发布刚刚过去一周,我们兑现了当初的承诺!
在上一版本中,我们解决了订阅源格式转换和接口生成的难题。而在今天的 v2.5 版本中,我们补齐了最后几块拼图,让 UDP Stream 从一个单纯的“流媒体转发器”正式进化为一个功能完备的家庭 IPTV 媒体中心。
这次更新不仅让你的服务更安全(敢暴露公网了),还让你的观影体验更省心(自动同步更新)。
🚀 v2.5 核心内容更新
1. 安全鉴权机制
“终于可以放心地把端口映射出去了!”
很多用户一直不敢将服务暴露到公网,担心被扫描或盗用流量。v2.5 引入了严格的鉴权系统:
-
后台访问控制:现在,访问 /status(状态监控)和订阅管理页面时,必须输入账号密码。

-
Token 播放保护:你可以开启 Token 验证模式。开启后,生成的订阅链接会自动附带 &token=xxx参数。没有正确 Token 的连接请求会被直接拒绝,防止他人通过扫描端口偷走你的直播流。

2. 动态订阅同步
“源头变了,不用再手动重新生成一次。”
在旧版本中,如果上游的订阅源增加了新频道,你需要手动去 UDP Stream 里重新拉取生成。
v2.5 新增了动态订阅功能:

-
程序会自动检测上游源的变化。 -
一旦源头更新(增加/删除频道),你代理后的订阅链接内容也会自动同步更新。 -
配合 TiviMate 等播放器的“自动更新列表”功能,真正实现了“一次配置,永久托管”。
3. 在线播放器与 EPG 支持
“不用到处找播放器,浏览器就能看。”

新版本内置了一个轻量级但功能强大的 Web 播放器:
-
即开即看:直接在订阅页面点击 播放 即可播放,方便在电脑端临时观看或测试线路。 -
EPG 节目单:支持配置 EPG 接口,现在的播放页面不仅有画面,还能显示当前正在播放什么节目。
4. 可视化观众追踪
“谁在偷看我的电视?”
监控面板进一步升级,现在不仅能看到有多少人在看,还能看到是谁在看:

-
新增显示连接客户端的 IP 地址。 -
结合 IP 归属地查询,你可以清晰地知道是家里的哪个设备(内网 IP)或是哪位朋友(公网 IP)正在占用带宽。
5. 全局设置面板
告别繁琐的配置文件修改或 Docker 环境变量调整。v2.5 新增了 Settings 设置页面,你可以在网页端直接修改核心参数:
-
修改账号密码 / Token。 -
调整缓冲区大小、超时时间等高级参数。

🛠️ 部署与升级
镜像已推送到 GitHub,支持 x86 、 ARM64 和ARMv7。
Docker Run 命令(推荐):
请先停止并删除旧容器,然后运行以下命令:
docker pull ghcr.io/cqshushu/udp-stream:latest #拉去最新镜像
docker run -d \
--name udp-stream \
--restart=always \
-p 5000:5000 \
ghcr.nju.edu.cn/cqshushu/udp-stream:latest
-
默认端口:5000 -
默认后台账号/密码: admin/password(请务必在设置页面修改),首次部署进入会初始化设置自己的账号密码:

-
注意:本次更新涉及数据持久化,建议挂载以下目录: 设置目录:
-v [宿主机目录]:/app/config订阅目录:-v [宿主机目录]:/app/playlists如:
docker run -d \
--name udp-stream \
--restart=always \
-p 5000:5000 \
-v /etc/docker/udp-stream/config:/app/config \
-v /etc/docker/udp-stream/playlists:/app/playlists \
ghcr.nju.edu.cn/cqshushu/udp-stream:latest
-v 冒号前面为你自己的主机目录,当然也可以不设置,因为全部可以通过web界面管理
💡 为什么你应该升级到 v2.5?
| 功能 | v2.3 (旧版) | v2.5 (新版) |
|---|---|---|
| 安全性 | 无鉴权,公网裸奔有风险 | 账号+Token 双重鉴权,安全无忧 |
| 订阅维护 | 源更新后需手动重新生成 | 全自动同步,源变我也变 |
| 播放体验 | 需第三方播放器 | 内置 Web 播放器 + EPG 节目单 |
| 监控粒度 | 仅显示人数 | 精确显示客户端 IP |
| 配置方式 | 不可配置 | 可视化设置页面 |
结语: 从解决断流卡顿,到支持格式转换,再到如今的安全鉴权与动态同步。UDP Stream v2.5 已经不再是一个简单的工具,而是一个成熟的 IPTV 解决方案。
感谢大家的支持与反馈,Enjoy your secure stream! 🚀
不能断开连接 一晚跑了200多G