iptv-checker 快速批量检测 IPTV 播放列表:500 个频道几分钟跑完,Docker 一条命令部署
【免费下载链接】iptv-checkerIPTV checker tool for Docker && CMD, check your playlist is available项目地址: https://gitcode.com/GitHub_Trending/ip/iptv-checker
手头那份用了几个月的 IPTV 源突然放不出来,500 条频道的 M3U 列表挨个点一遍要一下午。iptv-checker 把这件事做成了流程:它逐条检测播放列表里的频道链接,标记出每个频道的状态,最后导出一份干净的播放列表。M3U、M3U8、TXT 三种格式都支持。
项目速览
- 开源的 IPTV 播放列表检测工具,MIT 协议,最新版本 5.0.1
- 支持 M3U / M3U8 / TXT 播放列表,结果可按 M3U / TXT 导出
- 部署方式有 Docker、Docker Compose 和 CLI 二进制
- Web 管理后台集成定时检查任务、FFmpeg 强制检测、IPv4/IPv6 分开导出,功能明细见 CHANGELOG.md
🐳 部署上手
最省事的路径是 Docker 镜像,两条命令:
docker pull zmisgod/iptvchecker docker run -d -p 8081:8089 --name iptv-checker zmisgod/iptvchecker仓库里预置了 docker-compose.yaml,直接docker-compose up -d效果相同;不想用容器就从项目 Releases 下载对应平台的二进制文件,终端里直接跑。
验证方式:浏览器打开http://127.0.0.1:8081,看到「定时检查任务、想看的频道、设置」三个模块的欢迎页,说明部署成功。
核心能力详解
批量播放列表检测
你想一次性知道大列表里哪些频道还活着。iptv-checker 对列表中的每个链接并发发出检测请求,默认用 HTTP 检测标记状态;遇到「能连通却播不了」的源,可以开启FFmpeg 强制检测,实际拉流验证,结果会准很多。
定时检测任务怎么设
你想让源定期被复查,不用手动惦记。在「定时检查任务」页新建任务,填好播放列表地址、执行频率和检测选项,服务就会按设定时间跑检测,最新结果留在任务列表里。任务本身支持导入导出,也可以安排并发执行,多个源一次配齐。
可用频道怎么导出
你只想要真正能播的频道,拿一份干净列表去喂播放器。检测完成后在任务详情里直接导出,格式可选 M3U 或 TXT;从 v4.4.0 起 IPv4、IPv6 结果还能拆成两个文件分别导出,不同网络环境各留一份。
界面分中英文两套,英文版如下。
完整操作流程
- 部署完成后,浏览器打开
http://127.0.0.1:8081,进入「定时检查任务」模块 - 新建任务,粘贴播放列表链接或上传本地文件,设置并发数、超时时间等检测选项
- 点击执行,页面实时标记每个频道的检测状态,中途可以暂停和继续
- 检测完按表格查看结果,点导出,下载到的文件里只有验证过的可用频道
最后你得到一份干净的可用播放列表,直接交给任意播放器就能用。
效率对比
| 检测方式 | 耗时(500 个频道) | 结果准确性 |
|---|---|---|
| 手动逐个点击测试 | 3~5 小时 | 靠肉眼,漏检多 |
| 单线程脚本 | 小时级 | 只判断能否连通 |
| iptv-checker 并发检测 | 几分钟 | HTTP 检测,逐频道状态明确 |
| iptv-checker + FFmpeg 检测 | 略慢于上一行 | 实际拉流,假阳性更少 |
核心优势是并发检测加逐频道状态:人工活从小时级压到分钟级,再叠加 FFmpeg 检测把「可连不可播」的源筛掉,配上定时任务之后基本不用再操心。
⚙️ 进阶配置
并发检测数—— 任务选项里的并发数决定同时检测多少个频道。并发越大整轮检测越快,家庭宽带建议适中的值,避免占满上行或被源端限流。
超时时间—— 单频道请求的超时上限。优质源设 3~5 秒,不稳定源放到 10 秒以上,防止一条死链接拖住整体进度。
FFmpeg 强制检测—— 开启后每个频道都实际拉流验证,而不是只看 HTTP 状态。速度慢一些,但能筛掉「可连不可播」的源,导出结果更干净。
常见问题
Q:支持哪些播放列表格式?A:检测输入支持 M3U、M3U8、TXT 三种,导出支持 M3U 和 TXT。
Q:定时检测怎么设?A:在「定时检查任务」页新建任务,填播放列表地址和执行频率,保存后服务到点自动执行。
Q:检测出来还有「能连上但播不了」的频道?A:在任务选项里开启 FFmpeg 强制检测,它会实际拉流,这类假阳性基本都能过滤掉。
Q:IPv4 和 IPv6 能分开导出吗?A:可以,v4.4.0 起支持同一份检测结果分别导出两个文件,IPv6 网络不用再混用 IPv4 列表。
Q:源码怎么获取?A:
git clone https://gitcode.com/GitHub_Trending/ip/iptv-checkerIPTV 源维护是个长期活,iptv-checker 把这份重复劳动变成一键的播放列表检测任务。clone 下来部署跑一轮,感受一下完整检测的速度。
【免费下载链接】iptv-checkerIPTV checker tool for Docker && CMD, check your playlist is available项目地址: https://gitcode.com/GitHub_Trending/ip/iptv-checker
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考