从播放列表地址开始
iptv-org/iptv 把公开电视直播链接整理成 M3U 播放列表。复制列表地址,粘贴到 VLC 等兼容播放器即可使用。下面是全量列表;如果已经知道想看什么语言,可以先选语言列表。
https://iptv-org.github.io/iptv/index.m3u
视频由各自的提供方托管,可用性取决于提供方和你所在的位置。频道出现在列表里,也可能无法在你的设备上播放。
本指南于 2026 年 9 月 7 日对照项目文档核查。下面的检查只验证列表文件能下载、能解析,未逐个测试频道播放。
应该选择哪个 iptv-org 播放列表?
官方 PLAYLISTS.md 目录 提供分组地址,下面几个示例均来自该目录。
| 入口 | 播放列表地址 | 适合什么情况 |
|---|---|---|
| 全部频道 | https://iptv-org.github.io/iptv/index.m3u | 广泛浏览,或测试播放器处理列表的能力 |
| 英语 | https://iptv-org.github.io/iptv/languages/eng.m3u | 按播出语言缩小范围 |
| 中文 | https://iptv-org.github.io/iptv/languages/zho.m3u | 先看被归为 Chinese 的频道 |
| 新闻 | https://iptv-org.github.io/iptv/categories/news.m3u | 跨语言浏览同一种节目类别 |
语言分组和国家分组回答的问题不同。想听懂节目,先选语言;在意播出方所在国家,再看国家目录。目录把 Chinese 和 Mandarin Chinese 分开列出,使用前应核对标签,别默认一个列表包含所有相关频道。
排错时建议从较小的列表开始。频道少一些,更容易分清是整个列表没加载,还是某一个频道不可用。确认播放器能正常工作后,再切回全量列表。
在 VLC 中打开 M3U 列表
VideoLAN 桌面文档 给出了 Windows/Linux 界面的操作入口:
- 打开 Media → Open Network Stream,中文界面通常对应“媒体 → 打开网络串流”。
- 在 Network 标签页粘贴完整的播放列表地址。
- 点击 Play,然后在播放器的播放列表里选择频道。
不同平台的菜单名称会有差异,请使用播放器打开网络地址的入口。把地址粘进浏览器,可能只会显示或下载文本文件。GitHub 上含有 blob/master/PLAYLISTS.md 的地址是目录网页,需要复制其中实际以 .m3u 结尾的地址。
这种观看方式不需要克隆代码仓,也不需要安装项目的开发依赖。仓库里的脚本用于维护和检查直播源数据。
列表加载成功,还要单独检查频道
2026 年 9 月 7 日,GhTrends 抓取了上面四个地址,核对了 #EXTM3U 文件头与频道条目。下载成功只能说明列表文件可以访问,视频请求还会访问其他主机。
播放失败时,可以按下面的顺序缩小问题范围。
| 现象 | 下一步检查 |
|---|---|
| 一个频道都没加载出来 | 核对完整的 .m3u 地址,以及播放器是否能下载它 |
| 能看到频道,但某一个始终黑屏 | 换一个条目测试,再检查失败频道的错误信息 |
| 播放片刻就停止 | 按项目要求观察至少一分钟,并重新打开测试 |
| 提供方网页能播,播放器不能播 | 阅读项目测试文档中关于 HTTP 请求头的说明 |
| 数据库网站列出了频道,播放列表却找不到 | 检查数据库是否有该频道的有效直播链接 |
官方测试指南 在其演示的 VLC 界面中使用 Tools → Messages 查看错误。修改设置前,先保存失败的完整链接和错误信息,方便区分源地址过期与本地播放问题。
该指南也说明了部分源依赖 User-Agent 或 Referer 信息的情况。应先确认提供方的访问要求;更换播放器无法保证受限或不可用的节目能播放。项目另有地区可用性说明。
缺频道、名称错误、缺 EPG,分别去哪查?
这些问题由不同的项目资料处理。
| 问题 | 对应资料 |
|---|---|
| 列表中的直播源失效 | iptv 贡献指南 |
| 频道信息本身错误 | iptv-org/database |
| 需要节目时间表 | iptv-org/epg |
| 需要程序可读的目录数据 | iptv-org/api |
直播源使用了错误的 ID,也会把错误的描述关联到有效的源。贡献指南区分了这个问题与数据库信息错误。报告频道名称问题前,先核对源使用的 ID。
官方 FAQ 解释了“网站有频道,列表却没有”的原因:目录也收录尚无有效直播链接的频道。它建议在目录网站搜索 streams:>0,筛出带直播源的频道。EPG 单独维护;导入 M3U 列表后,还需要确认播放器是否配置了节目指南数据。
采用前需要核对的限制
如果能接受频道可用性变化,这份列表可用于个人观看或播放器测试。需要承诺特定频道、连续可用时间的服务,则要自行安排稳定来源与使用权利。
仓库材料采用 Unlicense,节目传播权需要另行确认。项目的法律声明 介绍了用户提交公开链接及移除请求流程,并未授予所有链接节目的再传播许可。请按自己的使用方式核对节目提供方的条款。
报告失效链接时,先确认这个完整 URL 仍在当前仓库中,并在报告里附上它。贡献指南要求区分直播源故障与地区限制。FAQ 也明确排除了 VOD,并解释了不接收易失效 Xtream Codes 链接的原因。
常见问题
iptv-org 的 M3U 地址是什么? 全量列表是 https://iptv-org.github.io/iptv/index.m3u,官方目录也提供语言和类别列表。
为什么 iptv-org 列表能加载,却没有画面? 下载列表与请求视频是两次独立访问。应单独测试频道并查看错误,列表下载成功不能确认视频源可用。
iptv-org 提供点播电影吗? 项目 FAQ 明确说 VOD 不在播放列表范围内。
EPG 在哪里? 从 iptv-org/epg 及播放器的节目指南配置开始。频道元数据与直播链接由其他仓库维护。
网站里列出的频道都能看吗? 目录中也有尚无有效直播源的条目。可用 FAQ 提供的筛选条件,再检查实际可用性。
另一个持续维护的数据目录可以看 public-apis。每日归档 则保留了本站项目发现列表所依据的 GitHub 活动日期。