iptv-checker 快速上手：3 分钟自动检测一份 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-checker 能做什么：四件核心事
它做的事其实就四件，先建立个心智模型：
- 批量有效性检测：读取 M3U / M3U8 / TXT 列表，逐个探测每个频道源是否可达
- FFmpeg 深度检测：不止发 HTTP 请求，还能让 FFmpeg 真的"听"一段流，结果更准
- 过滤导出：检测完只把可用频道导成新列表，还支持 IPv4 / IPv6 分开导出
- 定时后台跑：配置成后台定时任务，到点自动检测，不用你盯着
⚡ Docker 部署：3 条命令跑起 IPTV 源检测
最推荐的路径就是 Docker，项目里还自带了一份现成的 docker-compose.yaml，想用 Compose 直接docker-compose up -d就行。手动启动更直观：
docker pull zmisgod/iptvchecker docker run -d -p 8081:8089 --name iptv-checker zmisgod/iptvchecker接着打开浏览器访问http://127.0.0.1:8081，管理界面就出来了：在首页粘贴播放列表链接或上传本地文件，点开始检测，等着看绿红两色的结果表格即可。桌面版和命令行二进制这两种方式，照着 README.md 里的说明走，一句话带过即可。
🕑 真实工作流：从凌晨定时任务到换播放器列表
周一早上打开电脑，昨晚凌晨 2 点那个定时任务早就跑完了。检测结果表里绿色是活的、红色是死的，一眼扫过去就知道昨晚哪个源崩了。点"导出可用列表"，把新 M3U 塞进播放器，今天一整天都不用管它。
周中朋友说某个体育频道打不开，你在搜索框里敲*体育*，同类型频道全部列出来，对着状态列挨个确认，坏的那个直接从导出列表里剔掉。
周末来一次大检测，勾选 IPv4 / IPv6 分开导出，一份给你自己的路由器用，一份发给家里那台只支持 IPv4 的旧盒子。到这里你会发现，"维护播放源"这件事已经从周末工程变成了一眼就能扫完的表格。
🔧 常见症状与参数调优
| 参数 | 建议值 | 说明 |
|---|---|---|
| 并发数 | 3-5（大量列表）/ 10（少量列表） | 太高会压垮慢源，也显得"假死" |
| 超时时间 | 5-15 秒 | 源响应慢就往上加 |
| FFmpeg 深度检测 | 小列表开，大列表关 | 准确率换速度，按需取舍 |
- 部分频道长时间停在"检测中"→ 源响应慢，不是卡死 → 超时拉到 15 秒，打开"跳过非 HTTP 源"过滤 RTMP 之类的，并发调低
- 大批量检测进度慢得难受→ 开了 FFmpeg 深度检测 → 先用 HTTP 快检筛掉死链，剩下的再精细检测
- 导出的列表在播放器里放不出来→ 扩展标签格式播放器不认 → 换"简化导出"，去掉扩展信息
- 容器起来了但页面打不开→ 端口映射写错 → 用
docker logs iptv-checker确认服务活着，核对 8081 的映射 - 从 GitHub 爬取列表特别慢→ 未认证 API 限流只有 60 次/小时 → 在系统配置里填入
github_token，上限提到 5000 次/小时
🌙 下一步：今晚就能做的一件事
今晚就两件事：一条docker run把它跑起来，拿你最近在用的那份列表跑一次检测，看看实际活着的频道有多少。大概率会比你想象的少——到时候给它加一个定时任务，检测交给它，你只负责把导出的列表拿走。
【免费下载链接】iptv-checkerIPTV checker tool for Docker && CMD, check your playlist is available项目地址: https://gitcode.com/GitHub_Trending/ip/iptv-checker
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
