IPTV 播放列表检测工具 iptv-checker：500 个频道，5 分钟验证完

IPTV 播放列表检测工具 iptv-checker：500 个频道，5 分钟验证完

【免费下载链接】iptv-checkerIPTV checker tool for Docker && CMD, check your playlist is available项目地址: https://gitcode.com/GitHub_Trending/ip/iptv-checker

你肯定遇到过这种时刻：周末想看点球赛，打开播放列表，一屏频道里一半转圈、一半黑屏。逐个点开排查？一份 500 个频道的 M3U 列表，手测下来就是半天时间。iptv-checker 干的事很简单——把你的 IPTV 播放列表丢给它，它批量检测每个频道是否可用，再帮你把还能用的导出成新列表。

项目速览：它是什么

iptv-checker 是一款开源的 IPTV 频道检测工具，支持 M3U、M3U8、TXT 三种播放列表格式，能并发验证所有频道链接的有效性。

它提供 Web 管理界面和命令行两种使用方式：Docker 跑起来之后，在浏览器里管理检测任务、查看结果、导出可用列表；也可以直接下二进制文件在终端里跑。

左侧菜单就四个入口：欢迎页、定时检查任务、想看的频道、设置。第一次点进去，功能边界一眼就能看明白。

部署与验证：一条命令启动

最省事的方式是 Docker，仓库自带的 docker-compose.yaml 已经把端口映射配好了：

docker pull zmisgod/iptvchecker docker run -d -p 8081:8089 --name iptv-checker zmisgod/iptvchecker

-p 8081:8089是把宿主机 8081 端口映射到容器内的 8089 服务端口。

启动后浏览器访问http://127.0.0.1:8081，看到"欢迎使用 iptv-checker"页面即部署成功。如果你要把检测任务挂在 NAS 或 VPS 上长期跑，直接改一下端口映射即可。

核心功能实战

定时检查任务：让列表自己保鲜

场景：IPTV 源有失效周期，今天能播的链接下周可能就 404 了，手动复查既枯燥又容易忘。

操作：进入"定时检查任务"页面，把 M3U 列表的 URL 或文件粘进去创建任务，设置检测周期（比如每天凌晨 2 点），保存后任务就会进入调度队列。想立刻要结果的话，等距下次运行超过 3 分钟时，页面上会出现"立即执行"按钮。

效果：检测完成后每个频道都有明确状态，可用与失效一目了然。失效源多了，说明这份列表该换血了——这个信号比你自己挨个点开试来得快得多。

想看的频道：顺手把收藏管起来

场景：你只关心十几个台，但每次检测完还是要在几百行结果里翻。

操作：进入"想看频道"页面，把目标频道名填进收藏列表，支持完全匹配和关键词包含匹配（比如填CCTV命中所有央视频道）。

效果：后续检测结果里可以按收藏筛选，打开播放器时收藏频道单独成组，不用在一整页频道卡片里大海捞针。

导出与二次筛选

检测完的结果不必原样用。它支持 M3U / TXT 两种格式导出，还可以按 IPv4 / IPv6 分别输出——家宽环境拿 IPv4 列表，有双栈网络的话单独留一份 IPv6 的。配合关键词匹配和"网速最快筛选"，导出前就能把列表精简到只剩想要的频道。

技巧 & 避坑

别跳过的一点：如果你在任务里用了 GitHub 上的公共播放列表，去"设置 → 基础配置"里填上github_token，保存时会实时验证有效性，配好之后爬取和同步体验完全是两回事。

换环境或重装系统之前，记得用配置导出功能把任务、规则打包备份一份，新环境导入即可恢复。

谁在用它

家庭用户：把验证过的列表同步到 NAS，电视、盒子、手机共用同一份干净源。

小运营商/机房维护者：设置每 2 小时自动检测，失效频道在结果里直接现形，及时补源或换源。

收尾

iptv-checker 把"播放列表还能不能用"这件烦心事压缩成一次点击加几分钟等待，功能克制但覆盖检测、管理、导出全链路。

想上手的话，先docker pull zmisgod/iptvchecker跑起来，更多配置细节可以看仓库里的 README.md，版本演进记录在 CHANGELOG.md。上手很快，值得试一下。

【免费下载链接】iptv-checkerIPTV checker tool for Docker && CMD, check your playlist is available项目地址: https://gitcode.com/GitHub_Trending/ip/iptv-checker