LunaTV 直播接入 IPTV用一条 M3U 订阅搭出分组的网页频道列表【免费下载链接】LunaTV本项目采用 CC BY-NC-SA 协议禁止任何商业化行为任何衍生项目必须保留本项目地址并以相同协议开源项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTV打开直播页频道按来源分组排好下方的节目单滚到正在播的位置点一下频道画面就出来了右侧还能看到每一路流的带宽和延迟。这套体验不需要自己写播放器——LunaTV 的直播模块负责把 M3U 订阅解析成网页上的 IPTV 频道列表再配上 XMLTV 节目单和 HLS 播放。 从克隆仓库到点开第一个频道5 步验收标准拿代码并部署。执行git clone https://gitcode.com/GitHub_Trending/lu/LunaTV然后按 README 走 Docker 部署。注意仓库里不附带任何直播源订阅得自己准备。✅ 验收浏览器能打开登录页并且登录成功。在管理页的直播源配置里新增一条订阅。填入 M3U 链接EPG 地址按需填写User-Agent 一般保持默认保存后点刷新直播源。✅ 验收频道数量字段回填出非 0 的数字。切到直播页开播。选中刚才这条源在分组之间切换浏览点击任意频道。✅ 验收画面能持续播放下方节目单条自动定位到今天正在播的节目。️ 管理页那 4 个字段各自管什么事M3U 订阅链接整个频道列表的出处http/https 都行。填错或源已下线时刷新后拿到的就是空列表这一步是其他一切的前提。EPG 地址指向一份 XMLTV 节目单。如果 M3U 头部的#EXTM3U行里带了x-tvg-url这一项可以留空解析逻辑会自动从头部取地址实现在 src/lib/live.ts。填错地址的后果是频道照常出现但节目单整片空白。User-Agent代替你的播放器向订阅方发请求。部分源对请求头做防盗链检查默认值通常够用换了 UA 再刷新无效时才需要动它。频道数量只读刷新后自动回填。它等于 0 不代表没有频道而是这一轮拉取失败了。 跑通之后三个机制决定了日常体验频道列表进内存缓存。某个源第一次被访问时才会真正去请求订阅之后切换分组、重新加载页面都直接读缓存不会再拉一遍 M3U源更新了回管理页点一次刷新缓存才会作废重建。EPG 走逐行流式解析。XMLTV 文件动辄几十 MB如果整体读进来再解析内存压力很大。LunaTV 的做法是边流边读并且只把订阅里实际出现过的 tvg-id 对应的节目记下来其余直接丢弃接口代码在 src/app/api/live/epg/route.ts。换源面板按实测数据选流。播放层是 ArtPlayer 加 HLS.js 的组合同一频道挂了多路地址时右侧面板会列出每一路的带宽与延迟实测更稳的那路点一下就能切过去常用频道也可以顺手加入收藏。 出问题时按这个顺序查现象刷新后频道数量是 0。→ 原因订阅链接已失效或该源要求特定的 User-Agent。→ 处理换一条能正常打开的 M3U或调整 UA 后重新刷新。现象频道都有但节目单空白。→ 原因EPG 地址填错或者节目单和 M3U 里同一频道的 tvg-id 对不上号。→ 处理打开两份文件逐字比对同一频道的 tvg-id 字段。现象个别频道点进去没有画面。→ 原因那一路流地址本身已经失效与 LunaTV 无关。→ 处理用换源面板切到其他地址或把能看的频道加入收藏备用。这套流程适合手里已经握有 M3U 订阅、想让直播在浏览器里即开即看的人下一步可以先把每天要看的几个频道加进收藏之后开播只需要两下点击。【免费下载链接】LunaTV本项目采用 CC BY-NC-SA 协议禁止任何商业化行为任何衍生项目必须保留本项目地址并以相同协议开源项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTV创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考