企业官网建设流程全解析

如何批量检测 IPTV 播放列表可用性：iptv-checker 完整介绍

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

昨晚你想看一部电影，IPTV 应用里的频道却转圈不动。刷新几次还是不行，怀疑播放源挂了，可列表里有上千个频道，逐个手动试显然不现实。iptv-checker 就是为这种场景做的工具：给它一个播放列表，它逐个频道检查可用性，直接标出哪些频道还活着、哪些已经失效。

这个工具是干什么的

iptv-checker 是一款高性能的 IPTV 播放列表检测工具，支持 Docker 部署和命令行二进制两种用法，并带有一个 Web 管理后台。它负责验证 M3U / M3U8 / TXT 格式播放列表的可用性，检测结果可以导出为新的列表文件。

核心能力一览：

三种使用场景，各选一种部署方式

只想快速验证一次：CLI 二进制

不用常驻服务，从项目 Releases 页下载对应平台的二进制文件，在命令行直接运行即可。适合临时验证一个链接、或者在脚本里触发一次检测的场景。

想在服务器上长期挂着：Docker 单容器 🐳

拉取镜像后一条命令启动，端口做映射：

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

然后浏览器打开http://127.0.0.1:8081就是管理界面。容器内部监听 8089，宿主机端口可以随意改。

需要和其他服务一起跑：Compose 编排

机器上已经跑了不少容器时，用 Compose 统一维护更省心。项目自带的示例文件 docker-compose.yaml 内容很简：

services: iptv-checker: image: zmisgod/iptvchecker ports: - "8081:8089" restart: always

docker-compose up -d启动后，restart: always会保证断电或重启后服务自动恢复。

从导入到导出，四步跑通首次检测

1. 创建检测任务：在后台粘贴播放列表 URL，或上传本地 M3U / TXT 文件。
2. 执行检测：默认走 HTTP 检测；怀疑结果不准时开启 FFmpeg 强制检测，会更接近真实播放效果。
3. 读取检测结果：可用与失效频道分开标记，逐个频道能看到响应情况。
4. 导出可用频道：生成新的 M3U 或 TXT 文件，IPv4 / IPv6 还能分开导出，拿去替换原列表。

影响检测结果的几个细节 💡

有些频道不是死了，只是慢。弱网环境下默认超时可能把慢频道误判为失效，适当调长超时时间会更稳。

如果播放列表托管在 GitHub 上，注意 API 限流：不配 token 时每小时只有 60 次请求额度，配置后能提到 5000 次。没配 token 的系统在触发限流后会自动降级为 HTML 解析，能用但速度明显变慢。token 在 Web 后台的系统配置页填入，保存时会自动验证有效性。

另外，RTMP 这类非 HTTP 源做不了 HTTP 检测，后台任务支持直接跳过它们，不用手动从列表里剔掉。

让检测更省事的节奏建议

• 大型列表分批检测，并发数别拉满，避免把检测机打满。
• 用定时任务每周自动跑一轮，源站掉线时能第一时间发现。
• 每次检测完导出结果留一份备份，多轮对比能看出哪些源长期稳定。
• 配合关键词匹配、网速最快筛选和自定义排序，可以进一步筛出更稳的一批源。
• 检测机尽量用有线网络，结果更可复现。

版本现状与更新节奏

当前最新版本是 5.0.1：播放器统一了频道列表，把「已检查」和「已收藏」合并去重，并修复了定时检查配置页的报错。5.0.0 则带来了频道图标自动取数、定时任务卡死修复等改动。

再往前看，4.7 系列把网络配置拆成独立文件，新增 EPG 源管理与频道分组映射，还补上了 SSRF 防护和 URL 合法性校验。项目更新频率不低，近期主线集中在任务系统稳定性和数据能力上，完整记录见 更新日志，镜像与构建细节可参考 dockerfile 和 README.md。

要点速览

• iptv-checker 用于批量检测 M3U / M3U8 / TXT 播放列表的频道可用性，支持 HTTP 与 FFmpeg 双检测模式
• 三种用法对号入座：一次验证用 CLI 二进制，长期运行用 Docker，多服务编排用 Compose
• 完整流程四步：创建任务 → 执行检测 → 读取结果 → 导出可用频道
• 超时时间、并发数、GitHub token 是影响检测质量的关键参数
• 当前版本 5.0.1，近期更新集中在定时任务稳定性、EPG 管理与安全防护

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