企业官网建设流程全解析

打开播放列表一堆频道加载失败，iptv-checker帮你快速筛出所有失效源

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

当你打开保存在电视盒子上的 M3U 播放列表，发现一半频道转圈没画面、另一半直接提示“源不可用”时，只剩换源这一条路。iptv-checker 是一款免费的 IPTV 播放列表检测工具，支持 Docker 和命令行两种部署方式，能自动验证列表里每个频道是否可用。读完这篇，你会知道如何用 Docker 在几分钟内部署它，以及如何从创建检测任务一路走到导出一份干净的播放列表。

5 分钟用 Docker 跑起 iptv-checker 的 Web 界面

最省事的方式是用官方镜像直接启动。在装有 Docker 的机器上执行两条命令：

docker pull zmisgod/iptvchecker # 拉取官方镜像 docker run -d -p 8081:8089 --name iptv-checker zmisgod/iptvchecker # 启动容器，宿主机 8081 端口映射到服务

部署是否成功有一个明确的检查点：用浏览器访问http://127.0.0.1:8081，看到任务管理页面正常加载，就说明服务已经在跑了。

如果你更习惯用 Compose，仓库里自带了 docker-compose.yaml，端口和开机自启策略都已配好，在文件所在目录执行：

docker-compose up -d # 一键启动，宿主机重启后容器自动拉起

完全不想常驻容器的话，也可以从项目发布页下载对应平台的二进制文件，在命令行里做一次性的检测任务。

从创建检测任务到导出有效播放列表的完整路径

界面里的使用路径非常线性：建任务、等结果、导出。

• 建任务：把 M3U / M3U8 / TXT 格式的播放列表链接贴进任务表单，直链或 GitHub 仓库中的文件都可以
• 等检测：任务在后台并发执行，检测期间可以实时查看每个频道的状态
• 拿结果：检测完成后，以 M3U 或 TXT 格式导出干净列表，IPv4 和 IPv6 源还能分开输出

英文界面功能与中文完全一致，习惯英文操作或需要对接英文生态的用户可以直接切换：

界面里还有在线播放入口，点开某个频道就能直接试播它的流，确认画面声音正常，而不只是“能连通”。EPG 配置、频道名称解析等细项也都开放了设置，可以按自己的习惯调。

它凭什么判断源可用：三个值得了解的设计决策

HTTP 探测加 FFmpeg 强制检测双保险

结论：每个频道都有“快筛”和“实测”两次机会。纯 HTTP 探测速度快，但有些源站对任何请求都返回 200，必须拉流解码才知道真假；iptv-checker 因此用 FFmpeg 做强制检测兜底，慢一点，但导出的列表塞进播放器时不会翻车。

定时任务与超时自动复位

结论：检测可以按周期跑，卡住的任务会被自动救回来。源的可用性是动态变化的，一次检测管不了太久，所以支持定时任务定期复检；同时给单源检测设了强制超时，运行超 2 小时会自动复位，不会拖死整条队列。

SSRF 防护与 URL 校验

结论：它只检查你给的地址，不碰内网。检测对象是用户粘贴的 URL，系统会做合法性校验并拦截内网地址和危险协议，把容器端口映射到公网使用也不至于变成攻击跳板。

四个真实场景，从个人折腾到团队自动化

• 个人用户：周末前跑一次检测，导出仍然可用的频道，重新导入盒子播放器，观影时不再卡黑屏
• 多源玩家：按 IPv4 / IPv6 分开导出结果，家庭网络没有 IPv6 就直接用 IPv4 那份列表
• 自托管用户：容器常驻在家庭服务器，开启定时任务每周自动复检，源的健康状况不用人工盯着
• 团队用户：把检测接进 CI 流程，播放列表质量不达标直接卡住发布环节，问题挡在源头

常见卡点与排查方法

部署后 8081 打不开？先确认容器在运行，再检查 8081 端口是否被其他服务占用，占用时改一下-p的宿主机端口即可。

检测速度偏慢？FFmpeg 强制检测比纯 HTTP 探测耗时，源越多越明显；网络条件差时可以调大超时参数，或先关掉强制检测快速筛一轮。

需要配置 GitHub token 吗？只有从 GitHub 仓库抓取播放列表时才涉及：未配置时限流为每小时 60 次请求，配置后提升到 5000 次，在 Web 后台的系统配置里填入即可。

完整版本记录见 CHANGELOG.md，构建与端口配置见 dockerfile，英文文档见 README_EN.md。只要你的播放列表挂在网络上，跑一轮检测，哪些源还活着就一目了然。

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