5 分钟跑通 iptv-checker：一次验证几百个 IPTV 频道

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

手里有一份几百个频道的 M3U 列表，怎么快速找出失效的那些？iptv-checker 是一个 IPTV 播放列表检测工具：把列表交给它，逐个频道检查，只保留可用的那部分。它带 Web 管理界面，用 Docker 部署，几分钟就能跑起来。

它是什么

一款高性能的播放列表检测工具，用于验证 M3U / M3U8 / TXT 列表里的频道是否还可用。支持 Docker 部署与命令行二进制两种用法，Web 后台可管理任务、编辑配置、导出结果。

• 批量验证播放列表：上百个频道一次查完，不用逐个手动试
• 双检测机制：HTTP 检测加 FFmpeg 强制检查，结果更可信
• 可视化任务管理：建任务、改配置、导结果都在浏览器里完成

三步跑起来

拿到仓库

git clone https://gitcode.com/GitHub_Trending/ip/iptv-checker && cd iptv-checker

把项目下载到本地并进入目录。仓库里自带一份可直接使用的 docker-compose.yaml。

启动服务

docker-compose up -d

自动拉取 zmisgod/iptvchecker 镜像并创建容器。Web 界面映射到本机 8081 端口，还配置了异常退出后自动重启。

确认状态

docker-compose ps

查看容器是否在运行。状态为 Up 后，浏览器打开http://127.0.0.1:8081就是管理界面。

遇到问题时，可以先翻 CHANGELOG.md 查看各版本的行为变更与修复记录。

🔍 功能拆解：iptables-checker 能帮你做什么

如何把 M3U 列表放进 iptv-checker

点界面右上角「新增」创建检测任务。源支持本地文件和网络链接，M3U、M3U8、TXT 格式都能识别。任务建好后可以立即执行，也可以排进后台队列。

如何让检测结果更准

默认走 HTTP 检测，确认地址是否响应。要求更高时开启FFmpeg 强制检查，会真实解码视频流再下结论。同时可调并发数和超时时间，大批量频道一起查时不容易把请求打挂。

如何导出能用的频道列表

检测完成后，可下载只含可用频道的M3U 文件，或导出TXT 报告。IPv4 与 IPv6 结果能分开导出，也支持按关键词和网速最快筛选，留下质量最好的源。

如何设置定时检测

任务支持定时任务，到点自动跑一轮检查，不用每次手动触发。任务还支持导入导出，整套检测配置可以原样迁移到另一台机器。

值得调的三个配置

• 超时时间：源所在网络不稳定、误判失败较多时，把超时放宽到 10–15 秒。避免正常频道被误判成失效。
• FFmpeg 检查：HTTP 检测结果存疑时开启。代价是耗时更长，换来的是真实解码确认后的准确结果。
• 并发数：服务器性能一般时调低。检测请求不会因为互相挤占而大面积卡住。

常见问题排查

• 8081 页面打不开→docker-compose logs -f看启动日志；端口被占用就改 docker-compose.yaml 里的宿主端口再重启。
• 容器没在跑→docker-compose ps确认状态，退出过的容器回到日志里定位原因。
• 失败率偏高→ 先确认机器到源的连通性，再放宽超时或开启 FFmpeg 检查。

维护大份源列表、验证新来的订阅，或者想给源做定时体检，iptv-checker 都能接住。现在就把它拉起来，跑第一轮检测。

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