电视直播神器推荐：IPTV-API，一台NAS实现直播自由

如何实现电视直播自由？无需机顶盒，一台NAS或软路由就能看4K比赛，内附保姆级教程

你是否也曾有过这样的经历：家里没有电视机，只能靠手机看比赛直播，可手机上的直播APP要么广告满天飞，要么源卡顿得根本没法看；想自己动手找源吧，打开浏览器翻遍各种论坛和网站，找到一个能用的刚高兴没两分钟，看完半场球就彻底失效了，下回还得重头再来。每次想看场球赛或重要比赛，光找流畅的直播源就得折腾半小时以上，好好的观赛心情全被消磨光了。

其实完全可以用自动化工具解决——开源的 IPTV-API 项目能自动从全网抓取、验证并合并最新的有效直播源，每2小时更新一次，你只需将生成的订阅地址填入任意支持自定义源的播放器，从此再也不用四处搜源，彻底告别“找源半小时，看球十分钟”的烦恼。

IPTV-API 是什么？

IPTV-API：一套开源轻量接口服务工具

核心作用是聚合、整理、转换各类网络直播源，对外输出标准化 IPTV 播放接口，适配电视盒子、播放器、NAS、媒体管理系统等多终端。它支持自动抓取公开直播源、去重校验、分类整理央视 / 卫视 / 地方台 / 影视轮播频道，可过滤失效链接、生成 M3U8、TXT、JSON 等通用播放清单；内置订阅源批量导入、定时更新、源测速筛选功能，还提供简易 Web 管理面板可视化管理频道，兼容 IPTV 播放器、Emby、Kodi 等主流媒体软件

适合：

✅ 体育赛事爱好者

✅ 海外华人看国内台

✅ 折腾党想要自建IPTV服务

✅ 追剧狂魔

iptv-api（完整版本）：

性能要求较高，更新速度较慢，稳定性、成功率高；修改配置 open_driver = False 可切换到 Lite 版本运行模式

iptv-api:lite（精简版本）：

轻量级，性能要求低，更新速度快，稳定性不确定

具体方案：

支持浏览器结合Jellyfin / Emby类似的多媒体页面应用，也可以通过PotPlayer加载网络 M3U 播放列表

1. Jellyfin / Emby：媒体服务器，搭配 xTeVe+IPTV-API 实现直播、时移、回看

2. 家用电视盒子：IPTV-API + TVBox

3. 电脑浏览器在线观看：IPTV-API + IPTVnator Web IPTVnator：含网页版、桌面客户端，浏览器不用装软件就能加载直播源

4. IPTV-API +PotPlayer（本地播放器） IPTV-API 输出标准 HTTP 在线 M3U 订阅链接，PotPlayer 原生支持加载网络 M3U 播放列表、解析 m3u8 直播流，二者是 Windows 电脑端自用看电视的经典组合； 区别：IPTV-API 负责聚合、测速、更新干净频道源，Jellyfin/PotPlayer 负责本地高清解码播放，互补搭配

相对爱优腾平台有哪些不同？

专注看电视直播、新闻

• 工具本身开源免费，仅需一台服务器 / NAS 部署 Docker

• 无会员、无广告，但第三方直播源经常失效、卡顿、防盗链黑屏

• 自定义自由度极高：可合并运营商组播源、自建中转流、搭配任意播放器

M3U8是什么？

M3U8 是文本格式的播放清单文件，后缀 .m3u8，专门用来存放视频 / 直播分片地址，是现在网页、IPTV、播放器通用的流媒体标准

• 纯文本，里面不存视频画面，只存一堆小段视频地址；

• 编码为 UTF-8，所以后缀带 8；

• 几乎所有播放器（PotPlayer、VLC、TVBox、浏览器）都支持解析

直播视频不会一次性完整传输，服务器会把视频切成几秒一小段的 TS 分片

M3U8 文件里记录：

1. 分片顺序

2. 每个分片的网络地址

3. 码率、分辨率、加密信息

播放器读取 m3u8 → 按顺序下载小段视频 → 连续播放，实现直播 / 点播

你用的 IPTV-API 输出两种清单：

1. M3U：通用频道列表，里面每条记录指向一个 m3u8 直播地址

2. M3U8：单路直播的分片索引文件，打开就是单一电视台画面

功能清单：

• 多渠道直播源批量订阅导入，支持网络订阅链接、本地文件导入

• 自动抓取、解析各类公开 IPTV 直播源数据

• 直播链接有效性检测、测速、自动剔除失效卡顿源

• 频道去重、重命名、分组分类（央视 / 卫视 / 地方台 / 轮播等）

• 定时任务自动刷新更新全部直播源，无需手动操作

• 多格式清单输出：M3U、M3U8、TXT、JSON 标准播放列表

• 可视化 Web 管理面板，可视化编辑、排序、隐藏频道

• 自定义频道分组、自定义频道图标、频道备注配置

• Docker 一键容器部署，低内存低 CPU 占用，适配 NAS / 小主机

• 接口对外提供标准化 API，可对接 Kodi、Emby、播放器、电视盒子

• 支持源优先级排序，自动切换流畅备用播放地址

• 黑白名单过滤，可屏蔽广告台、无效频道、特定频道

• 访问权限控制，支持接口密钥防他人盗用订阅

• 日志记录，查看源抓取、测速、访问请求记录

项目地址：https://github.com/HerbertHe/IPTV-API

IPTV-API 部署

1、创建本地文件目录

用于存储配置，数据持久化

mkdir /opt/iptv-api /opt/iptv-api/config /opt/iptv-api/output cd /opt/IPTV-API

2、Docker Compose配置

services: iptv-api: image: guovern/iptv-api:latest container_name: iptv-api restart: unless-stopped ports: - "8577:8080" # 容器内HTTP服务端口，冒号前面不要冲突 volumes: - ./config:/iptv-api/config - ./output:/iptv-api/output

3、Docker命令方式

下载Docker镜像：

docker pull guovern/iptv-api:latest

运行命令并启动容器：

docker run -d --name iptv-api --restart unless-stopped -p 8577:8080 -v ./config:/iptv-api/config -v ./output:/iptv-api/output guovern/iptv-api:latest

IPTV-API 使用教程

1、搭配Jellyfin一起用

使用Docker部署后的后台长这样，通过容器查看电视抓取情况

image-20260701112126413

对电视频道进行测速：

image-20260701113620856

网页输入web地址查看有效电源源：

image-20260701113527778

手动增加订阅源：

自带央视平台+地方电视台

添加订阅：

打开subscribe.txt，手动添加订阅源，可结合ip-sources一起用

image-20260701115348820

1. Jellyfin后台设置-电视直播-添加M3U电视源

1）添加调谐器设备

image-20260630165913342

调谐器类型：选择M3U Tuner

image-20260701111425602

3. 刷新XML TV视频列表

   第一次后台读取电视源源有些慢，确定地址没问题后，稍晚些打卡

点击刷新指南数据按钮

2、搭配potplay播放器使用

打开 PotPlayer，按 F6 调出右侧播放列表

image-20260630170117718

播放列表界面

播放列表底部点【添加】→【添加链接】

粘贴你的 IPTV-API 订阅地址：http://服务器IP:8577/m3u

image-20260630170131506

填入M3U地址

勾选「保存到列表」，确定后加载全部频道，双击即可播放

3、通过Jellyfin看电视直播

打开Jellyfin-电视直播页面，可看到电视台频道列表、节目清单

image-20260701112535992

电视时间表：

image-20260701112553863

自动筛选的电视网速还是很快：

image-20260701114952252

作者声明本文无利益相关，欢迎值友理性交流，和谐讨论～