3分钟用Docker跑起iptv-checker：批量检查你的IPTV频道还能不能播

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

iptv-checker是一款面向IPTV播放源的频道可用性检查工具，专门用来验证M3U、M3U8、TXT格式的播放列表里哪些频道还活着。打开Kodi发现一半频道黑屏转圈，多半就是列表太久没体检了。这篇文章先花3分钟把它跑起来，再演示一次完整检测流程，最后讲按需调参和排查方法。

把它跑起来

一条命令就够了。docker pull拉取镜像，docker run -d后台启动容器，把宿主机的 8081 端口映射到容器内的 8089：

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

启动完成后，浏览器访问http://127.0.0.1:8081即可进入管理界面，看到的是一张欢迎页和几张功能卡片。

提示：8081 端口如果被占用，把-p左边改成 8080 之类空闲端口，访问地址跟着换。

跑起来之后你看到什么

界面分两块：左侧导航栏有「欢迎」「定时检查任务」「想看的频道」「设置」四项；右侧欢迎页摆着三张功能卡片，分别对应任务、收藏频道和系统设置。后面所有操作都从这两处发起：点「定时检查任务」卡片里的「前往任务」开始建检测任务，点「想看的频道」管理你关心的频道。

界面提供完整的中英文切换，语言偏好可以在设置里改。

一次完整的检测流程

1. 进入「定时检查任务」页面，点新建任务。
2. 任务表单里填入 M3U/M3U8 格式播放列表的 URL，保存后会先跑一轮检测。
3. 给任务设置检查频率，比如每天凌晨一次，到点自动再跑。
4. 回到任务列表点开检测记录，每个频道都标注了可用或失效，失效原因也写得出——链接下线还是服务器拒连。
5. 在结果里导出可用频道，选 M3U 或 TXT 格式下载。

下载下来的文件可以直接丢给 Kodi、VLC 这类播放器当播放列表，不用再做任何整理。

按需调整的几个参数

• 端口映射 — 8081 被占用，或者你想固定一个习惯端口时改-p参数
• 数据卷挂载 — 任务配置、导出结果需要跨容器重建保留时，挂一个目录进去
• 并发数 — 列表超过几百个频道觉得慢，或者源站扛不住时调整
• 超时时间 — 网络不稳定、个别大文件流误判失效时放宽到 10 秒左右

docker run -d -p 8081:8089 \ -v ~/iptv-data:/app/static/output \ --name iptv-checker zmisgod/iptvchecker

用 Compose 方式部署的，仓库里自带了一份 docker-compose.yaml 示例，可以照着抄。

遇到麻烦时的排查顺序

端口没通：先用netstat -tuln | grep 8081确认容器在监听，再查防火墙规则。

页面打不开但端口正常：看容器日志，docker logs iptv-checker里通常有明确报错。

检测速度慢：调低并发数，把超时时间改到 10 秒左右，远程列表也可以先存成本地文件再测。

个别频道误判：手动打开该链接确认真伪，再检查自己网络有没有地域限制，换个 User-Agent 重试。

再往后可以做什么

把导出的列表直接接进 Kodi 或 Jellyfin；在设置里配上通知，结果不用人盯；嫌手动操作麻烦，就用命令行版本跑在 CI 里定期体检播放列表。

收尾

iptv-checker 把"这个列表还能不能看"变成了一件可以定时跑、可以导出的事，省掉手动挨个点链接的时间。把上面那条docker run敲下去，两分钟后你就能拿到第一份可用频道报告。之后每周自动跑一轮，失效频道下线前就能被发现。

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