3步跑起 iptv-checker：让几百个IPTV频道按点自动完成有效性检测
【免费下载链接】iptv-checkerIPTV checker tool for Docker && CMD, check your playlist is available项目地址: https://gitcode.com/GitHub_Trending/ip/iptv-checker
深夜想打开IPTV看场球赛，常看的那个频道却弹出 403——几百个链接的播放列表，到底哪些还能播，没人说得清。iptv-checker 干的就是这一件事：批量校验 M3U / M3U8 / TXT 播放列表，一轮检测告诉你哪些频道可用，再把可用清单直接导出。
iptv-checker 英文界面：左侧导航包含后台任务、收藏频道与设置入口
为什么需要IPTV播放列表批量检测器
- 一套工具覆盖 3 种播放列表格式（M3U、M3U8、TXT），检测结果还能按 IPv4 / IPv6 拆成两份频道列表，一次检测两用。
- 相比只看 HTTP 响应码，iptv-checker 多了一层 FFmpeg 强制检测（FFmpeg 是开源音视频处理工具，强制检测模式会真实拉流试探），把"接口有响应、流实际播不了"的假活频道过滤掉。
- 5.0.0 版本给单源检查加了强制超时，任务运行超过 2 小时自动复位——一条死链卡住整条检测队列、后面全不跑的情况从此结束。
Docker Compose 三步部署 iptv-checker
- 获取项目代码
git clone https://gitcode.com/GitHub_Trending/ip/iptv-checker cd iptv-checker- 启动服务容器（仓库自带配置好的 docker-compose.yaml，把宿主机 8081 端口映射进容器）
docker-compose up -d💡 小贴士：首次运行会自动拉取 zmisgod/iptvchecker 镜像，建议挑网络稳定的时间窗操作，避免拉一半失败。
- 验证服务并打开管理界面
curl -I http://127.0.0.1:8081能看到 HTTP 响应头后，浏览器打开同一地址即可进入 iptv-checker 的 Web 管理后台。
中文管理界面：首页提供定时检查任务、想看频道、设置三大入口
iptv-checker核心玩法：建任务、导结果、挂定时
新建检测任务：粘链接或传文件
- 在任务管理页点"新增"，粘贴 M3U / M3U8 列表链接，或上传本地播放列表文件
- 设置检测超时（秒）与并发数量：并发越高跑完越快，但吃掉的带宽也越多
- 任务支持导入导出，同一套配置可以直接复用到另一台机器
查看并导出结果：M3U 直接播、TXT 留底
- 任务完成后导出 M3U 文件，可直接导入播放器
- 同步导出 TXT 报告，逐条记录每个频道的检测状态，方便排查
- 可用频道列表可按 IPv4 / IPv6 分别输出，双栈网络不混线
定时任务 + GitHub Token 自动跑起来
- 侧边栏创建定时检查任务，到点自动执行，不用每次手动触发
- 在"设置 → 基础配置"填入 GitHub Token（一串用于身份认证的密钥），拉取 GitHub 仓库内列表的 API 限额从 60 次/小时提升到 5000 次/小时，保存时系统会自动验证有效性
- 同一设置页还能管理 EPG（电子节目单）数据源、做频道分组映射，详细演进记录见 CHANGELOG.md
两个真实场景：检测耗时砍掉大半
- 家庭服务器管理员，200 个左右频道：以前每周末手动逐条试播，一轮下来一个半小时起步；现在每周日定时任务自动跑完并生成新 M3U 列表，他只负责导入共享列表，每周维护时间从约 1.5 小时降到 10 分钟以内。
- 小型IPTV服务商运维，几十个核心源站：以前发现链接失效靠用户报障，通常是第二天；现在定时任务每天早晨出 TXT 报告，失败链接逐条列明，平均发现时间从"次日"提前到"当天上午"。
IPTV检测工具的更多适用领域
- 在 CI/CD 流水线中周期性校验播放列表质量，坏源提前拦截
- 小型 IPTV 服务商的源站可用性监控
- 学校、社区共享电视的频道清单维护
- 智能电视应用开发中的频道校验环节
你的播放列表里真正能播的链接占几成？欢迎在评论区聊聊你的频道维护习惯，或者你给检测设置的超时秒数。
【免费下载链接】iptv-checkerIPTV checker tool for Docker && CMD, check your playlist is available项目地址: https://gitcode.com/GitHub_Trending/ip/iptv-checker
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
