想看某个国家的新闻频道,搜了半天找不到靠谱的直播源?好不容易找到一个,用了两天就挂了?
iptv-org/iptv 解决的就是这个问题。它把全球公开可用的 IPTV 直播链接整理成标准的 M3U 播放列表,按国家、类别、语言分门别类,每天自动更新。粘贴一个链接到播放器,就能看全球上万个频道。里面有什么?
streams 目录下有 324 个 .m3u 文件,每个对应一个国家或地区。cn.m3u 里有 CCTV、北京卫视、各地卫视;us.m3u 里有 ABC、CBS、NBC;jp.m3u 里有 NHK、富士电视台。https://wxa.wxs.qq.com/tmpl/pu/base_tmpl.html
每个频道都有标准化的 ID(比如 CCTV-1 对应 CCTV1.cn@HD),分辨率标注(720p、1080p),地理限制标记([Geo-blocked])。GitHub Actions 每天凌晨自动检查链接有效性,移除失效的,添加新发现的。怎么用?
最简单的用法:复制播放列表链接,粘贴到支持直播的播放器里。
电脑端:VLC 播放器 → 媒体 → 打开网络串流 → 粘贴链接
https://iptv-org.github.io/iptv/index.m3u
这个链接包含所有频道,总共上万个。如果你只想看某个国家的,比如中国频道:
https://iptv-org.github.io/iptv/countries/cn.m3u
手机端:IPTV Smarters、GSE Smart IPTV、VLC 移动版都支持。操作方式类似,添加播放列表 URL 即可。
按兴趣筛选:如果你只想看体育频道:
https://iptv-org.github.io/iptv/categories/sports.m3u
想看新闻频道:
https://iptv-org.github.io/iptv/categories/news.m3u
支持的分类包括:动画、汽车、商业、喜剧、烹饪、文化、纪录片、教育、娱乐、家庭、儿童、生活方式、电影、音乐、新闻、户外、宗教、科学、体育、旅行、天气等 30 多个类别。对开发者有什么用?
不只是看直播。这个项目对开发者来说,有几个实际价值:
1. 标准化的数据源
每个频道都有唯一的 ID、标准化的元数据(类别、语言、国家、分辨率)。这些数据来自 iptv-org/database 仓库,可以通过 API 访问。如果你在做一个需要电视直播数据的应用,不用自己去爬取和清洗。
2. 自动化的工作流
仓库里的 TypeScript 脚本展示了如何用 GitHub Actions 实现每日自动更新:检查链接有效性、生成多种格式的播放列表、部署到 GitHub Pages。这套工作流可以直接复用到其他需要定期更新数据的项目。
3. 多维度的数据组织
同一个频道可以按国家、类别、语言、地区、城市等多种维度组织。这种设计思路对任何需要多维度分类的数据项目都有参考价值。和其他 IPTV 资源有什么不同?
网上 IPTV 直播源很多,但大多数是个人收集的列表,更新不稳定,格式不统一。iptv-org/iptv 的区别在于:
- 规模:324 个国家/地区,上万个频道,远超个人收集的列表
- 标准化:统一的频道 ID 和元数据格式,不是随便拼凑的链接
- 自动化:每日自动更新验证,不用手动维护
- 社区:6.6k Fork,任何人都可以贡献,不是一个人在维护
边界和注意事项
用之前,有几件事得知道:
合法性:仓库不存储任何视频文件,只收集公开可用的直播链接。发现侵权可以通过 issue 报告移除,但仓库方对链接指向的内容没有控制权。
稳定性:IPTV 直播源本身就不稳定。有些频道可能今天能看明天就挂了,这是 IPTV 的本质问题,不是这个项目的锅。
地理限制:标记了 [Geo-blocked] 的频道可能需要 VPN 才能观看。https://wxa.wxs.qq.com/tmpl/pu/base_tmpl.html
不支持点播:只收集直播频道,不提供视频点播(VOD)内容。
拒绝 Xtream Codes:这类链接通常不稳定,很快就失效,项目直接排除了。为什么值得关注?
12 万 Star 不是白来的。这个项目用 7 年时间证明了:一个好的数据聚合项目,核心竞争力不是数据量,而是数据质量、更新机制和组织方式。
对于想看全球电视节目的用户,这是最全面的免费资源。对于开发者,这是一个展示如何用 GitHub Actions 管理大规模数据集的优秀案例。
如果你想继续看这类 AI 工具拆解,我会把上手路径、关键限制和可复用配置整理成清单,方便你直接判断值不值得试。
引用链接
[1]iptv-org/iptv: https://github.com/iptv-org/iptv