LunaTV 直播M3U 订阅一键变高清频道列表的完整实战指南【免费下载链接】LunaTV本项目采用 CC BY-NC-SA 协议禁止任何商业化行为任何衍生项目必须保留本项目地址并以相同协议开源项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTV收藏夹里躺着一堆 M3U 订阅链接想找个能稳定开播、还带节目单的播放器总是不得劲LunaTV 的直播功能就是干这个的把一条 M3U 订阅地址变成可分组、带节目单EPG的频道列表在线直接看。这篇走一遍从部署到开播的完整路径顺带讲讲里面几个容易忽略的机制和踩坑解法。先把它跑起来部署和添加 M3U 订阅的方法LunaTV 仅支持 Docker或基于 Docker 的平台部署按 README.md 里的 compose 配置拉起来即可一行命令git clone https://gitcode.com/GitHub_Trending/lu/LunaTV有个心理预期要提前打好部署完是个空壳不内置任何直播源订阅得自己收集。然后进入管理页的直播源配置把下面四个字段填好点刷新直播源系统拉取频道列表并自动回填频道数字段作用填写建议M3U 订阅链接频道列表的来源支持 http/https 两种格式EPG 地址XMLTV 节目单M3U 头部带 x-tvg-url 时可留空会自动识别User-Agent模拟播放器身份部分源有防盗链校验保持默认即可频道数量刷新后自动回填显示 0 说明这次拉取失败核心解析逻辑在 src/lib/live.ts拉完 M3U 后解析频道与分组再按 tvg-id 去匹配 EPG 里的节目。开播体验选源、分组浏览、节目单自动跟播进入直播页先选一个源频道按 M3U 里的分组归类展示点任意频道即播。下方有一条节目单滚动条会自动滚到当前正在播出的节目位置不用自己翻。想换另一个源时页面里有专门的直播源面板列出每个源的名称和频道数点一下就能整体切换当前用的源会有标记页面实现在 src/app/live/page.tsx。进阶缓存、流式解析和换源三个隐藏能力频道列表缓存频道列表首次访问后被缓存之后切换分组、刷新页面都是秒开不会重复拉订阅。源变动后到管理页手动刷新即可入口在 src/app/api/admin/live/route.ts。节目单流式解析EPG 的 XML 往往体积很大LunaTV 采用逐行流式读取只保留订阅里实际出现的 tvg-id 对应的节目避免撑爆内存接口实现在 src/app/api/live/epg/route.ts。播放器换源播放器基于 ArtPlayer 与 HLS.js右侧面板列出各资源的带宽与延迟哪个快切哪个。播不出来对照这三条排障现象原因解法频道列表为空订阅源失效或需要特定 UA换一个有效订阅或调整 UA 后重新刷新没有节目单EPG 地址填错或 EPG 与 M3U 里的 tvg-id 对不上核对两个文件里同一频道的 tvg-id 字段是否一致部分频道无法播放源本身失效与 LunaTV 无关换源或把能用的收藏备用一句话收尾手头有 M3U 订阅、想要开箱即看直播的用户直接按上面的步骤走就行下一步建议把常用频道加入收藏切换起来更省事。【免费下载链接】LunaTV本项目采用 CC BY-NC-SA 协议禁止任何商业化行为任何衍生项目必须保留本项目地址并以相同协议开源项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTV创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考