企业官网建设流程全解析

如何用 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 圈子里太常见了。iptv-checker 就是为这个场景而生的开源工具：它支持 Docker 部署和桌面端两种形态，能批量验证 M3U / M3U8 / TXT 格式播放列表里的频道是否还活着，并把结果导出成干净可用的新列表。后端用 Rust 编写，检查走 HTTP 探测 + FFmpeg 双重校验，配合 Web 管理后台，定时任务、结果导出都可视化操作，一个人维护几个常用源完全够用。

播放源可用性检查解决什么问题

📺 先看看这个工具对应的真实使用场景：

工具本身不做播放，它只做一件事：给每个频道 URL 发请求、必要时让 FFmpeg 拉流验证，然后告诉你哪些能用、哪些该扔掉。

Docker 一键部署 iptv-checker 管理后台

镜像托管在 Docker Hub，拉取后直接启动：

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

-p 8081:8089的含义是容器内服务默认监听 8089（由WEB_PORT环境变量控制），映射到本机 8081。启动后浏览器访问http://127.0.0.1:8081就能进入 Web 管理界面，左侧导航、右侧操作区，任务、播放、设置三大板块一目了然。

更省事的方式是用 Compose 文件，仓库自带的 docker-compose.yaml 只有 7 行，内容就是拉取镜像、映射 8081 端口并设置开机自启：

docker-compose up -d

这样容器重启、机器重启后服务都会自动恢复，适合当作长期跑的家庭服务。

自定义端口与结果持久化

如果 8081 被占用了，或者想把检查结果保存到容器外防止数据丢失，可以在启动时多带两个参数：

docker run -d -p 8081:10001 -e WEB_PORT=10001 \ -v ~/icStatic/output:/app/static/output --name iptv-checker zmisgod/iptvchecker

WEB_PORT=10001改变的是容器内部监听端口，所以-p右侧也要写成 10001，保持两边一致；-v把容器的输出目录挂载到宿主机，导出的 M3U / TXT 文件就会直接落在~/icStatic/output里，删容器也不丢结果。

Web 后台里检查任务怎么用

登录后台后，左侧点「本地任务」进入任务管理页。创建一个新任务的流程很直接：

• 建任务：点+ NEW（中文界面为+ 新增），填上播放列表的 URL 或上传本地文件，选择检查方式；
• 看进度：任务列表实时显示任务 ID、创建时间和运行状态，检查是并发执行的，大列表也不用干等；
• 复跑：过一段时间想再验证一次，点任务上的CHECK AGAIN即可，不用重新配置；
• 导结果：检查完成后，把可用频道下载为 M3U 或 TXT，IPv4 / IPv6 还能分开导出。

界面支持完整的中英文切换，功能完全一致，英文界面在任务页顶部就能看到 NEW / CHECK AGAIN 等对应按钮。检查设置里还可以调整超时时间、勾选关键词匹配、按网速最快排序，甚至开启 FFmpeg 强制校验——对链接通但实际播不出画面的"假活"频道，这一项能帮你筛掉。

检查机制是怎么判断频道可用的

工具对每个频道 URL 分两层做验证。第一层是 HTTP 探测：直接请求源地址，看状态码和响应头，这一步快，适合大批量初筛。第二层是 FFmpeg 强制检测：真正用 FFmpeg 去拉一段流，确认能解码出画面才算通过，这一层更准但更耗时，按需开启。

两个细节值得一提：

• 结果可复核：导出文件保留tvg-name、group-title、x-tvg-url等标签，EPG 数据还能在设置里单独配置和同步，导出的列表可以直接丢进播放器使用；
• 安全边界：4.7.0 版本起加入了 SSRF 防护，拦截内网 IP 和危险协议，避免检查任务被恶意列表利用去探测内网设备。

更多版本细节可以看仓库里的 更新日志。

进阶用法与实用建议

几个长期使用的经验，供参考：

1. 配 GitHub Token：如果要从 GitHub 仓库直接拉公共订阅源，未认证请求每小时只有 60 次额度。到 GitHub 的 token 设置页生成一个只读 fine-grained token，填入 Web 后台「系统配置 → 基础配置」的github_token字段，额度提升到 5000 次/小时，保存时系统会自动验证有效性；
2. 网络参数单独调：4.7.0 之后代理、自定义 headers、User-Agent 从基础配置拆到了独立 network.json 里，网络条件差时给检查任务配上代理和更长的超时，成功率会明显改善；
3. 定时任务 + 配置导出：把常用源建成长期任务后开启定时检查，再定期用「配置导入导出」功能把整套设置打包备份，换机器时一条 ZIP 就能恢复；
4. 桌面端补充：不想开容器的话，也可以从项目发布页下载 Windows / macOS / Linux 的二进制文件直接运行，适合只想快速测一个列表的场景。

把检查任务挂上定时执行、每周扫一遍，播放源的质量就始终掌握在自己手里了。

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