批量检测 IPTV 播放列表源可用性：iptv-checker 快速上手
【免费下载链接】iptv-checkerIPTV checker tool for Docker && CMD, check your playlist is available项目地址: https://gitcode.com/GitHub_Trending/ip/iptv-checker
iptv-checker 是一款开源的 IPTV 播放列表检测工具，能批量验证 M3U / M3U8 / TXT 播放列表里的频道链接是否可用，支持 Docker 与命令行两种运行方式。假设你手里有一份几百个频道的订阅列表，想搞清楚哪些还能播、哪些已经失效，用它一键提交就能拿到结果。
先看它帮你省了多少
| 对比项 | 手动逐个测试 | iptv-checker |
|---|---|---|
| 操作方式 | 在播放器里逐个点开频道 | 整个列表提交给后台任务批量检测 |
| 时间成本 | 随频道数线性增长，几百个频道要翻很久 | 一个后台任务跑完，可 7×24 无人值守 |
| 覆盖面 | 容易漏测、凭印象判断 | 列表内每个频道逐一给出状态 |
| 后续处理 | 人工记录哪些失效，再手动整理 | 自动导出可用的 M3U / TXT 列表 |
几百个频道的列表，手动点测既慢又容易漏；iptv-checker 把整个列表交给后台任务，检测完直接导出去掉失效链接的可用列表，你只需要取走结果。
项目是什么：核心能力一览
iptv-checker 定位是"高性能的 IPTV 播放列表检测工具"，提供 Docker、Docker Compose、CLI 二进制三种部署形态，Web 管理后台内置其中。核心能力按"输入 → 处理 → 输出"排下来是这样：
- 播放列表输入：支持 M3U、M3U8、TXT 三种格式，可填在线链接，也可从 GitHub 公共源爬取频道数据
- 批量检测：HTTP 检测 + 可选 FFmpeg 强制检测，后台任务支持并发、定时执行、任务导入导出
- 结果导出：M3U / TXT 格式导出，支持 IPv4 / IPv6 结果分别单独输出
- EPG 与频道管理：EPG 源配置与同步、频道分组映射、自动规范化 tvg-name 并去除 4K 等质量后缀
- 配置管理：系统配置支持 ZIP 打包备份、导入恢复，换机器不用重新配
三步跑起来：Docker 部署
方式一：直接 docker run（最快）
docker pull zmisgod/iptvchecker docker run -d \ -p 8081:8089 \ --name iptv-checker \ zmisgod/iptvchecker方式二：Docker Compose
仓库里已带一份配置好的 docker-compose.yaml，拉到仓库后直接执行：
docker-compose up -d确认服务正常：启动后浏览器打开http://127.0.0.1:8081，看到"欢迎使用 iptv-checker"页面，左侧有"定时检查任务 / 想看的频道 / 设置"菜单，说明服务已就绪。
第一次使用完整走一遍
- 点击左侧"定时检查任务"，进入任务列表页，新建一个检测任务
- 填入播放列表地址（M3U / M3U8 / TXT 的在线链接），也可以配置从公共源爬取
- 按需设置并发数、超时时间，决定是否启用 FFmpeg 检测
- 执行任务，在任务详情页查看每个频道的检测状态
- 检测完成后，核对可用 / 失效频道数量
- 点击导出，把验证过的频道保存为 M3U 或 TXT 文件，IPv4 / IPv6 可分开导出
值得调的几个参数：检测任务怎么配置
不用碰所有配置，先调这三个对结果影响最大的：
| 参数 | 作用 | 什么时候调 |
|---|---|---|
| 并发数 | 同时检测多少个频道 | 频道量大、想缩短检测总时长时调高；网络带宽有限时别拉满 |
| 超时时间 | 单个频道等待响应的上限 | 慢速源频繁被判失效 → 调大；源普遍响应快 → 调小，省时间 |
| FFmpeg 强制检测 | 连接成功之外，再验证媒体流是否可解码 | 检测结果"可用"但播放器里黑屏、无画面时启用，过滤假阳性 |
这些人群最用得上
- 个人玩家：手里有几份几百频道的订阅列表，隔三差五就坏一片 → 配一个每天执行的定时任务，检测完直接导出可用列表同步到自己的播放器
- 小型 IPTV 服务提供者：要对客户提供长期可用的频道源 → 用后台任务 + 定时检测持续盯住源状态，失效的及时换掉
- 开发者 / CI 用户：需要自动化验证播放列表质量 → 用 CLI 二进制版本跑检测，接入 CI/CD 流程
容易踩的坑
- 从公共源获取频道数据失败、触发限流→ 未配置 token 时 GitHub API 只有 60 次/小时的限制 → 在 Web 后台"系统配置 → 基础配置"填入
github_token，限额提升到 5000 次/小时；不配置时系统会自动降级为 HTML 解析，但稳定性不如 API - 检测显示"可用"，播放器里却放不出来→ HTTP 检测只验证链接是否有响应，不验证流内容 → 开启 FFmpeg 强制检测，让工具实际拉一段流确认可播
- 后台任务里个别频道始终未检测→ 后台任务只对 HTTP 类源做检查，RTMP 等非 HTTP 协议会跳过 → 这类频道单独人工确认，或接受其在结果中缺省
写在最后
iptv-checker 把"源坏了不知道"变成"定时自动检测 + 自动导出可用列表"，你只管取结果。现在就可以用上面的命令起一个容器，跑第一次检测。仓库地址：git clone https://gitcode.com/GitHub_Trending/ip/iptv-checker，功能细节看 README.md，版本变化看 CHANGELOG.md。
【免费下载链接】iptv-checkerIPTV checker tool for Docker && CMD, check your playlist is available项目地址: https://gitcode.com/GitHub_Trending/ip/iptv-checker
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
