iptv-org/iptv：让 IPTV 频道列表不再神秘

如果你折腾过家庭影音，迟早会遇到一个尴尬时刻：买了个电视盒子 / 装了个 Kodi / 弄了个播放器，输入了频道 URL 之后看到的全是「Loading…」「无法播放」「401 Unauthorized」。问题往往不在你的设备，而在频道源本身——地址过期、地区限制、清晰度参差不齐、节目单（EPG）对不上号。

这时候你大概率会被指到同一个地方：iptv-org/iptv。

它不是播放器，也不是付费订阅服务。它是 GitHub 上一个维护了十多年、目前 12 万 star 的频道源合集项目——收录了来自全世界的公开 IPTV 频道、节目单、M3U 播放列表，以及一整套分类、合并、过滤工具。今天我们花几分钟把它讲清楚。

项目背景

iptv-org 最初是一群喜欢折腾的家庭影音玩家维护的频道源仓库，后来发展成一个非营利组织，主仓库就是 iptv-org/iptv。每天有几百个 PR 进来，志愿者帮忙验证、合并、清洗频道源。截止到今天，它在 GitHub Trending 当日榜稳居第一，本周新增一千多颗星。

仓库的核心理念一句话总结：「IPTV 频道应该像开源软件一样可被审计、可被复用、可被改进」。

所以它不托管任何流媒体服务器，不存储任何视频内容，只负责把互联网上已经公开的频道地址、HLS / M3U8 链接、节目表数据收集起来，并提供统一的格式给下游使用。

能做什么

打开仓库你会看到几个核心产物：

1. M3U 播放列表

streams/ 目录下有按国家、语言、分类切割好的 M3U 文件，比如：

- streams/cn.m3u — 中国大陆频道
- streams/usa.m3u — 美国频道
- streams/news.m3u — 纯新闻频道
- streams/sports.m3u — 体育频道
- streams/all.m3u — 全部加起来，目前超过 10 万条

直接拖进 VLC、Tivimate、IPTV Pro、Kodi 就能用。

2. EPG 节目单

epg/ 目录下是 XMLTV 格式的节目预告。配合播放列表，频道就有完整的「19:00 财经新闻 / 20:00 天气预报」这种时间表了。

3. 频道元数据库

channels/ 目录是频道的「元数据」，包括名称、Logo、国家、语言、官网、分类、社交账号、是否需要地理限制等等。这是一份「频道维基」。

4. 在线 API

iptv-org 团队运行了一个公开 API（iptv-org.github.io），支持按国家、语言、频道 ID、分类查询频道和节目表。文档是 OpenAPI 格式的，可以直接导入 Postman / Insomnia。

5. 配套工具

仓库里还有几个 Go 写的命令行工具：iptv-checker（批量验证频道有效性）、m3u-filter（过滤 / 合并播放列表）等等。社区还有大量基于这些数据的衍生项目——自建 IPTV 代理、做家庭影音中心、聚合多源频道等等。

为什么值得

在大量「IPTV 源」「免费看电视」的野鸡网站和 Telegram 频道里，iptv-org 是少数几个能让你信任数据来源的地方：

- 透明：每个频道 PR 都有来源链接、可信度评分
- 及时：失效的频道会很快被标记 / 移除
- 可重现：所有数据都在 Git 上，你可以 fork 一份自己改
- 活跃：每天几十上百个 PR，issues 区也活跃

更重要的是，它给你一个起点。比起随手在网上下载一个 iptv.m3u 然后用两天发现一半地址都挂了，从 iptv-org 拉一份回来自己用 iptv-checker 验证一遍，过滤掉失效的，按自己的喜好（高清优先 / 国内优先 / 体育优先）重组一份，是更可持续的玩法。

快速上手

最直接的玩法是直接拉播放列表。仓库不提供 Docker 镜像（它本身只是数据），但配套的 iptv-checker 等工具有 Docker 镜像，iptv-org API 也有官方 Docker 镜像。下面是三个最常用的命令。

1. 下载 M3U 播放列表（直接用）

curl -o channels.m3u "https://iptv-org.github.io/iptv/index.m3u"

或者只拉中国的：

curl -o cn.m3u "https://iptv-org.github.io/iptv/cn.m3u"

把这个文件丢进播放器就行。

2. 跑 iptv-checker 验证有效性

docker run --rm -it \
  -v $(pwd)/check:/app/data \
  ghcr.io/iptv-org/iptv-checker \
  check --playlist streams/all.m3u --output /app/data/checked.m3u

跑完会输出一份「验证过还能播」的播放列表。

3. 自建 iptv-org API（如果你想内网部署）

docker run -d --name iptv-api \
  -p 8080:8080 \
  ghcr.io/iptv-org/api:latest

启动后访问 http://localhost:8080 就能看到 OpenAPI 文档，可以在内网搭建自己的 IPTV 聚合服务了。

适合谁

- 折腾家庭影音的极客：手里有盒子 / NAS / 树莓派，想搞个「自建 IPTV」
- 全栈 / 后端工程师：想研究流媒体协议、HLS、M3U8 解析，iptv-org 是个非常干净的开源数据集
- 数据 / 内容运营：需要批量管理频道元数据、做分类、清洗数据
- 对「付费 IPTV 订阅」不放心的人：想自己掌控频道源的人

不适合纯小白直接「打开就用」——iptv-org 只是数据源，播放器、EPG 解析、遥控器交互这些还得你额外折腾。

链接

- 仓库：https://github.com/iptv-org/iptv
- API 文档：https://iptv-org.github.io/
- 频道查询：https://iptv-org.github.io/iptv/channels/
- 配套工具 iptv-checker：https://github.com/iptv-org/iptv-checker
- 许可证：CC0（频道元数据）+ 各频道源遵循原始协议

一句话总结

iptv-org/iptv 不是「免费看电视」的神器，它是频道源的维基百科 + 公共数据集。拿它当起点，自己用 checker 验证、按需过滤、丢进你喜欢的播放器——这才是正经玩法。GitHub 当日 Trending 第一，12 万 star，实至名归。