☰
iptv-checker 快速批量检测 IPTV 播放列表:500 个频道几分钟跑完,Docker 一条命令部署
2026/10/23 4:31:07 网站建设 项目流程

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 结果还能拆成两个文件分别导出,不同网络环境各留一份。

界面分中英文两套,英文版如下。

完整操作流程

  1. 部署完成后,浏览器打开http://127.0.0.1:8081,进入「定时检查任务」模块
  2. 新建任务,粘贴播放列表链接或上传本地文件,设置并发数、超时时间等检测选项
  3. 点击执行,页面实时标记每个频道的检测状态,中途可以暂停和继续
  4. 检测完按表格查看结果,点导出,下载到的文件里只有验证过的可用频道

最后你得到一份干净的可用播放列表,直接交给任意播放器就能用。

效率对比

检测方式耗时(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-checker

IPTV 源维护是个长期活,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),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询