如何用 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 管理后台定时任务、结果导出都可视化操作一个人维护几个常用源完全够用。播放源可用性检查解决什么问题 先看看这个工具对应的真实使用场景场景手动做法用 iptv-checker 之后换源前先测一遍逐个频道点开试建一个检查任务后台并发跑完全部频道订阅源定期失效失效了才发现配置定时任务周期性自动体检把大列表瘦身肉眼比对直接导出只含可用频道的 M3U / TXT区分线路质量凭感觉按 IPv4 / IPv6 分别导出按需筛选工具本身不做播放它只做一件事给每个频道 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_PORT10001 \ -v ~/icStatic/output:/app/static/output --name iptv-checker zmisgod/iptvcheckerWEB_PORT10001改变的是容器内部监听端口所以-p右侧也要写成 10001保持两边一致-v把容器的输出目录挂载到宿主机导出的 M3U / TXT 文件就会直接落在~/icStatic/output里删容器也不丢结果。Web 后台里检查任务怎么用登录后台后左侧点「本地任务」进入任务管理页。创建一个新任务的流程很直接建任务点 NEW中文界面为 新增填上播放列表的 URL 或上传本地文件选择检查方式看进度任务列表实时显示任务 ID、创建时间和运行状态检查是并发执行的大列表也不用干等复跑过一段时间想再验证一次点任务上的CHECK AGAIN即可不用重新配置导结果检查完成后把可用频道下载为 M3U 或 TXTIPv4 / IPv6 还能分开导出。界面支持完整的中英文切换功能完全一致英文界面在任务页顶部就能看到 NEW / CHECK AGAIN 等对应按钮。检查设置里还可以调整超时时间、勾选关键词匹配、按网速最快排序甚至开启 FFmpeg 强制校验——对链接通但实际播不出画面的假活频道这一项能帮你筛掉。检查机制是怎么判断频道可用的工具对每个频道 URL 分两层做验证。第一层是 HTTP 探测直接请求源地址看状态码和响应头这一步快适合大批量初筛。第二层是 FFmpeg 强制检测真正用 FFmpeg 去拉一段流确认能解码出画面才算通过这一层更准但更耗时按需开启。两个细节值得一提结果可复核导出文件保留tvg-name、group-title、x-tvg-url等标签EPG 数据还能在设置里单独配置和同步导出的列表可以直接丢进播放器使用安全边界4.7.0 版本起加入了 SSRF 防护拦截内网 IP 和危险协议避免检查任务被恶意列表利用去探测内网设备。更多版本细节可以看仓库里的 更新日志。进阶用法与实用建议几个长期使用的经验供参考配 GitHub Token如果要从 GitHub 仓库直接拉公共订阅源未认证请求每小时只有 60 次额度。到 GitHub 的 token 设置页生成一个只读 fine-grained token填入 Web 后台「系统配置 → 基础配置」的github_token字段额度提升到 5000 次/小时保存时系统会自动验证有效性网络参数单独调4.7.0 之后代理、自定义 headers、User-Agent 从基础配置拆到了独立 network.json 里网络条件差时给检查任务配上代理和更长的超时成功率会明显改善定时任务 配置导出把常用源建成长期任务后开启定时检查再定期用「配置导入导出」功能把整套设置打包备份换机器时一条 ZIP 就能恢复桌面端补充不想开容器的话也可以从项目发布页下载 Windows / macOS / Linux 的二进制文件直接运行适合只想快速测一个列表的场景。把检查任务挂上定时执行、每周扫一遍播放源的质量就始终掌握在自己手里了。【免费下载链接】iptv-checkerIPTV checker tool for Docker CMD, check your playlist is available项目地址: https://gitcode.com/GitHub_Trending/ip/iptv-checker创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
长河君 · 2026/10/23 2:09:03 · 阅读 1.2k 如何用 iptv-checker 批量检查 IPTV 播放源是否可用：完整部署与使用指南
如何用 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 管理后台定时任务、结果导出都可视化操作一个人维护几个常用源完全够用。播放源可用性检查解决什么问题 先看看这个工具对应的真实使用场景场景手动做法用 iptv-checker 之后换源前先测一遍逐个频道点开试建一个检查任务后台并发跑完全部频道订阅源定期失效失效了才发现配置定时任务周期性自动体检把大列表瘦身肉眼比对直接导出只含可用频道的 M3U / TXT区分线路质量凭感觉按 IPv4 / IPv6 分别导出按需筛选工具本身不做播放它只做一件事给每个频道 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_PORT10001 \ -v ~/icStatic/output:/app/static/output --name iptv-checker zmisgod/iptvcheckerWEB_PORT10001改变的是容器内部监听端口所以-p右侧也要写成 10001保持两边一致-v把容器的输出目录挂载到宿主机导出的 M3U / TXT 文件就会直接落在~/icStatic/output里删容器也不丢结果。Web 后台里检查任务怎么用登录后台后左侧点「本地任务」进入任务管理页。创建一个新任务的流程很直接建任务点 NEW中文界面为 新增填上播放列表的 URL 或上传本地文件选择检查方式看进度任务列表实时显示任务 ID、创建时间和运行状态检查是并发执行的大列表也不用干等复跑过一段时间想再验证一次点任务上的CHECK AGAIN即可不用重新配置导结果检查完成后把可用频道下载为 M3U 或 TXTIPv4 / IPv6 还能分开导出。界面支持完整的中英文切换功能完全一致英文界面在任务页顶部就能看到 NEW / CHECK AGAIN 等对应按钮。检查设置里还可以调整超时时间、勾选关键词匹配、按网速最快排序甚至开启 FFmpeg 强制校验——对链接通但实际播不出画面的假活频道这一项能帮你筛掉。检查机制是怎么判断频道可用的工具对每个频道 URL 分两层做验证。第一层是 HTTP 探测直接请求源地址看状态码和响应头这一步快适合大批量初筛。第二层是 FFmpeg 强制检测真正用 FFmpeg 去拉一段流确认能解码出画面才算通过这一层更准但更耗时按需开启。两个细节值得一提结果可复核导出文件保留tvg-name、group-title、x-tvg-url等标签EPG 数据还能在设置里单独配置和同步导出的列表可以直接丢进播放器使用安全边界4.7.0 版本起加入了 SSRF 防护拦截内网 IP 和危险协议避免检查任务被恶意列表利用去探测内网设备。更多版本细节可以看仓库里的 更新日志。进阶用法与实用建议几个长期使用的经验供参考配 GitHub Token如果要从 GitHub 仓库直接拉公共订阅源未认证请求每小时只有 60 次额度。到 GitHub 的 token 设置页生成一个只读 fine-grained token填入 Web 后台「系统配置 → 基础配置」的github_token字段额度提升到 5000 次/小时保存时系统会自动验证有效性网络参数单独调4.7.0 之后代理、自定义 headers、User-Agent 从基础配置拆到了独立 network.json 里网络条件差时给检查任务配上代理和更长的超时成功率会明显改善定时任务 配置导出把常用源建成长期任务后开启定时检查再定期用「配置导入导出」功能把整套设置打包备份换机器时一条 ZIP 就能恢复桌面端补充不想开容器的话也可以从项目发布页下载 Windows / macOS / Linux 的二进制文件直接运行适合只想快速测一个列表的场景。把检查任务挂上定时执行、每周扫一遍播放源的质量就始终掌握在自己手里了。【免费下载链接】iptv-checkerIPTV checker tool for Docker CMD, check your playlist is available项目地址: https://gitcode.com/GitHub_Trending/ip/iptv-checker创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考