iptv-checker 部署指南:5 分钟给 IPTV 播放列表做次全面体检
【免费下载链接】iptv-checkerIPTV checker tool for Docker && CMD, check your playlist is available项目地址: https://gitcode.com/GitHub_Trending/ip/iptv-checker
iptv-checker是一款免费开源的 IPTV 播放源检测工具,支持 Docker 一键部署与 Web 管理界面,帮你批量验证 M3U / M3U8 / TXT 列表里哪些频道还能看。
工具速览:先搞清楚它是什么
一句话定位:把整份播放列表自动"过筛"一遍,只留下真正能播的频道。
| 维度 | 说明 |
|---|---|
| 项目定位 | IPTV 播放列表可用性检查,HTTP 探测 + FFmpeg 强制检测双保险 |
| 适用人群 | IPTV 用户、Kodi / Jellyfin 等媒体中心玩家、需要自动化校验的技术用户 |
| 核心能力 | 批量并发检测、定时任务、EPG 节目单、按 IPv4 / IPv6 分组导出 M3U / TXT |
| 部署方式 | Docker、Docker Compose、命令行二进制 |
界面为中英双语,左侧是"定时检查任务""想看频道"等导航,右侧卡片直接对应核心操作,没有陡峭的学习曲线。
最快上手:一条 Docker 命令跑起来
推荐直接用 Docker 镜像,30 秒出结果,其余方式(Compose、CLI 二进制)文末一句话带过。
docker pull zmisgod/iptvchecker docker run -d -p 8081:8089 --name iptv-checker zmisgod/iptvchecker启动后打开http://localhost:8081,管理界面就出来了。
两个常用的小调整:
- 换端口:把
-p 8081:8089里的8081改成你想要的端口即可 - 存数据:想防止容器重建后配置丢失,加一行
-v ~/iptv-data:/app/static/output挂载数据卷
不想用 Docker 的话:仓库自带 docker-compose.yaml,直接docker-compose up -d就能跑;想接 CI/CD,也可以从 Release 页面下载对应平台的二进制文件在命令行里直接执行。
典型工作流:从导入到导出,三步跑完一轮体检
整条链路就是"配源 → 执行 → 导出",全程在 Web 界面点完即可。
第 1 步:录入播放源,配好检查策略
- 在"定时检查任务"里新建任务,粘贴 M3U / M3U8 的在线地址
- 勾选检测方式:默认 HTTP 探测即可追求速度;对误判敏感的源,开启 FFmpeg 强制检测,它会真的去解码,结果更准
- 顺手调三个参数:超时时间(网络差调到 10~15 秒)、并发数、重试次数
- 在"想看频道"里把你常看的台标为收藏,方便结果里优先查看
第 2 步:触发检测,交给后台跑
可以点"立即执行"马上跑一轮,也可以设成每天 / 每周定时自动检查。大列表(500 个频道以上)建议分批建任务,避免单次并发把带宽吃满。跑完后界面会给出可用频道数和平均响应时间,收藏的频道还能直接预览画面。
第 3 步:导出可用列表,喂回播放器
- 导出M3U:直接拖进 Kodi、Jellyfin 等播放器替换旧列表
- 导出TXT:留作备份或分享给别人
- 支持按 IPv4 / IPv6 分开输出,家里是双栈网络时很实用
小贴士:如果你要从 GitHub 公开仓库直接拉取列表,未配置 token 时 API 每小时只有 60 次额度,容易触发限流。在"设置 → 基础配置"里填一个细粒度只读
github_token,额度可提升到 5000 次/小时,保存时系统会自动帮你验证有效性。
避坑速查:遇到问题先对一下这张表
| 现象 | 可能原因 | 处理方式 |
|---|---|---|
| 容器起来了,但网页打不开 | 端口被占用或防火墙拦截 | netstat -tuln \| grep 8081查占用,放行端口;docker logs iptv-checker看容器日志 |
| 检测速度明显变慢 | 并发开太高导致网络拥堵 | 降低并发数,超时调到 10~15 秒,或改用本地列表文件 |
| 明明能播的台被判为失效 | 地域限制、ISP 屏蔽或请求头被拒 | 先用浏览器手动验证链接;检查网络环境;尝试更换 User-Agent |
| 从 GitHub 拉列表失败 / 被限流 | 未配置 token,匿名额度只有 60 次/小时 | 在基础配置里填入github_token,系统会自动降级为 HTML 解析兜底 |
| 定时任务长时间不执行 | 单源检查卡死或任务堆积 | 确认单源强制超时已生效;任务运行超 2 小时会自动复位 |
写在最后
iptv-checker 解决的其实是一个很朴素的问题:你的播放列表里,到底还有哪些频道是活的。Docker 一条命令部署,配上定时任务,坏掉的源会在你发现之前就被筛掉,播放器里永远只剩能用的频道。
现在就可以动手:拉镜像、建任务、跑第一轮检测,10 分钟后你会拿到一份干净利落的可用频道列表。
MIT 协议开源,项目地址:https://gitcode.com/GitHub_Trending/ip/iptv-checker(git clone后可查看 README.md 了解完整配置项)。
【免费下载链接】iptv-checkerIPTV checker tool for Docker && CMD, check your playlist is available项目地址: https://gitcode.com/GitHub_Trending/ip/iptv-checker
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考