☰
iptv-checker 部署指南:5 分钟给 IPTV 播放列表做次全面体检
2026/10/23 6:20:08 网站建设 项目流程

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),仅供参考

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

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

立即咨询