← 返回文章列表

国内直连 IPTV 直播源:这个开源项目怎么用

分享 vbskycn/iptv 开源直播源项目,整理国内直连订阅入口、M3U/TXT 格式选择、导入步骤与故障排查,并说明 IPv6 当前列表状态及实际播放的验证边界。

文章封面

想在电脑、手机或电视盒子上看直播,往往先卡在“直播源去哪里找”。找到的地址零散,播放器导入方式又不一样,过一段时间还可能失效。

这次分享一个把直播源整理成订阅列表的 GitHub 项目:vbskycn/iptv。它以“国内可直连”为主要定位,提供可以交给兼容播放器使用的直播源文件。对普通用户来说,最实用的部分是现成的列表入口,以及后续重新获取更新的便利。项目主页

先说当前值得注意的情况:截至 2026 年 9 月 29 日本次核验,IPv4 列表有内容,IPv6 列表暂时只有更新时间占位项。第一次使用,建议从 IPv4 的 M3U 地址开始。这里核验了列表文件,未逐台测试播放,也未做不同地区、不同运营商的连通性测试。

项目提供什么?

可以把直播源列表理解成一份“频道通讯录”:播放器读取频道名称和对应地址,再连接到实际的视频服务。列表方便整理入口,播放质量仍取决于对应源和你的网络。

该项目提供 IPv4、IPv6 两类入口,各有 M3U 和 TXT 两种格式。普通使用不需要部署服务器,也不必先 Fork 仓库;选择兼容播放器能识别的格式即可。项目使用说明

本次读取的 IPv4 M3U 包含 CCTV、卫视频道等名称,以及分组、台标地址和节目单地址等信息。需要留意:文件里写有一个频道名称,不代表已经验证实际播放内容与名称一致。IPv4 列表原文件

直播源列表与多种播放设备的概念示意

AI 生成概念配图,不是项目或播放器的真实界面截图。

先收藏这几个入口

类型

M3U 订阅地址

TXT 列表地址

IPv4,建议先尝试

iptv4.m3u

iptv4.txt

IPv6,等待实际频道恢复后再尝试

iptv6.m3u

iptv6.txt

可直接复制的 IPv4 M3U 地址:

https://live.zbds.top/tv/iptv4.m3u

以上入口来自项目 README。若以后地址变化,应回到项目主页查看最新说明。

M3U 和 TXT 怎么选?先看播放器的导入要求。本次 M3U 文件包含频道分组、台标和 EPG 引用,支持这些字段的播放器可以利用它们展示列表。若播放器明确要求 TXT,就使用对应的 TXT 文件;不能仅通过修改扩展名来假定格式已经转换。

导入使用,按这三个步骤来

第一步,确认播放器支持外部直播源。在已有播放器中寻找“添加播放列表”“订阅地址”“网络串流”或“导入直播源”等入口。不同应用的名称和支持格式不同,以应用自己的说明为准。

第二步,添加上面的 IPv4 M3U 地址。如果播放器支持订阅 URL,粘贴地址并刷新列表;如果只支持本地文件,可以先下载列表,再从播放器的文件导入入口打开。

第三步,挑常看的几个频道试播。先确认列表能显示,再看视频能否正常开始播放、声音是否正常、切台是否顺畅。测试通过后再整理收藏,比一次性整理全部条目更省时间。

浏览器点开链接后出现下载提示,并不代表源失效;它可能只是把 M3U 当成文件下载。也要区分两件事:列表加载成功,说明播放器拿到了入口;某个频道能播放,才说明这条媒体地址在当前环境下可用。

如果播放器有订阅刷新功能,按其设置更新;使用本地文件时,需要重新下载、导入才能拿到新版列表。

“国内可直连”,也要看当前网络和源的状态

项目的定位是国内直连,但 README 同时提示部分网络可能无法访问项目域名,第三方直播源也可能失效。因此,更合适的理解是:它提供了值得尝试的直连入口,实际效果需要在自己的设备和宽带上确认。项目说明与可用性提示

两种网络连接与可用性检查的概念示意

AI 生成概念配图,连线仅表达可用性可能不同,不代表 IPv4 或 IPv6 固定更优。

这次对项目站点和 GitHub 原始文件的检查结果如下:

核验对象

2026 年 9 月 29 日本次读取结果

IPv4 M3U

两个入口均成功返回文件,内容一致;共有 544 条 #EXTINF 记录,含更新时间和支持作者条目,不能写成“544 个可用频道”

IPv6 M3U

两个入口均成功返回文件,内容一致;仅有 1 条更新时间占位记录,没有实际频道条目

单个频道的播放情况

未逐台测试,不据此承诺流畅度、清晰度或长期有效

可复核文件:IPv4 M3U、IPv6 M3U。文件会随项目更新,本表只记录本次检查时的状态。

如果打不开,先判断问题发生在哪一步:

  • 列表地址都打不开:先确认地址和网络访问情况,再查看项目主页的最新入口。

  • 能看到频道,但个别频道黑屏:换一个频道对照,并刷新列表;单条源的问题不能代表整个列表不可用。

  • IPv6 导入后没有正常频道:本次文件本身就没有实际频道条目,不必反复重装播放器,先使用 IPv4 列表。

  • 能播放,但台标或节目单缺失:这些资源通过另外的地址加载,需要单独检查,不能与视频播放混为一谈。

关于更新和节目单,再补充两点

README 介绍了 Fork 后开启 Actions、每 6 小时同步上游的方式。这是仓库同步安排,不能等同于每个频道每 6 小时都完成了一次可用性验证。普通观看用户直接获取列表即可,需要维护副本时再研究自动同步。仓库同步说明

节目单也要区分“文件里有引用”和“项目自己提供服务”。当前 M3U 文件头仍包含第三方 EPG 地址;README 的历史更新记录则写明,项目已于 2025 年 5 月 20 日停止提供 EPG 服务。因此,不宜宣传为项目持续自营、保证可用的节目单服务。M3U 文件头 · 项目更新记录

这个项目适合想尝试外部直播源、愿意做少量导入和维护的用户。可以先收藏主页,用 IPv4 M3U 测几个常看频道,再决定是否长期保留。项目说明其链接来自第三方公开资源,不存储流媒体内容,并声明仅供学习交流、禁止商业用途;使用时应尊重内容权利与相关服务规则。项目声明

项目地址:github.com/vbskycn/iptv

核验日期:2026 年 9 月 29 日。封面和正文插图均由 AI 生成。

一起聊聊

留下你的想法,评论审核通过后展示。