用 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 文件里的频道逐条做可用性检查把失效的标出来再直接导出清洗后的列表。工具本身以 Docker 容器、CLI 二进制或桌面应用的方式运行Web 管理面板负责建任务、改配置和拿结果。部署一条 docker run 就能跑起来官方镜像在 Docker Hub 上名称是zmisgod/iptvchecker。容器内服务监听 8089 端口环境变量WEB_PORT习惯上把宿主机 8081 映射过去docker pull zmisgod/iptvchecker docker run -d -p 8081:8089 --name iptv-checker zmisgod/iptvchecker启动后浏览器打开http://127.0.0.1:8081即可进入管理界面。导出的结果文件写在容器内的static/output目录如果想让它们在宿主机上留存挂载一个本地目录即可docker run -d -p 8081:8089 \ -v ~/iptv-data/output:/app/static/output \ --name iptv-checker zmisgod/iptvchecker用 Docker Compose 长期运行仓库里自带了一份 docker-compose.yaml就是同一个镜像、同样的 8081:8089 端口映射外加restart: always容器异常退出后会自动拉起docker-compose up -d命令行与桌面端不想常驻容器也可以到项目 Releases 页面取对应平台的二进制文件在命令行直接运行v4.5.1 起支持从 CLI 触发检查。基于 Tauri 的桌面端覆盖 Windows / macOS / Linuxv4.0.0 起适合单机临时检测。 第一次检测从粘贴列表到导出结果进入 Web 面板后左侧导航是「欢迎、定时检查任务、想看的频道、设置」四个入口欢迎页用卡片形式跳转到各功能模块。一次完整的检测流程是这样的粘贴播放列表链接或上传本地 M3U / M3U8 / TXT 文件发起检查每个频道被逐条探测状态写进结果表用关键词过滤结果定位失效频道并查看具体原因导出支持 M3U 和 TXT 两种格式v4.4.0 起 IPv4 / IPv6 的结果还能分开导出成两个文件。检查本身分两档默认是 HTTP 探测速度快另一档是 FFmpeg 强制检测会真正拉取流并解码几秒耗时更多但误判更少。源少的时候两档都开也不心疼源多的时候先跑 HTTP 档再补测可疑频道更划算。定时任务失效频道不用人肉盯着面板里的「定时检查任务」就是后台任务系统给一个或几个播放列表建好周期任务它按设定时间自动执行检测参数支持并发数与超时时间调整任务本身可以导入、导出方便在多台机器间同步。一个典型的用法家庭影院共用一份订阅列表平时没人管它。给列表挂一个每日晚间的定时任务第二天早上看结果只有失效的那几个频道需要替换播放器里留着的始终是可用列表。配置层面v4.4.0 开始支持把系统配置打包成 ZIP 导出、再导入恢复换主机时不用从零重配。频道管理把真正要看的单独拎出来列表里的频道可能有上千个日常关心的往往只有几十个这部分功能集中在「想看的频道」和设置里想看频道收藏把常看的频道收进来结果页可以只看这批频道的状态关键词匹配v3.2.0 起按频道名模糊搜索配合超时时间配置一起用频道名智能匹配解析时自动规范化tvg-name/tvg-id去掉 4K 之类的质量后缀避免同一频道被拆成多条分组映射本地维护tvg-name与group-title的对应关系EPG 没覆盖到的频道也能归进正确的组EPG 支持可配置电子节目单源、同步和缓存频道名后面还能追加分辨率标签HD/FHD 或 720p/1080p。界面默认中文也提供英文版本布局和权限一致给家庭成员或海外用户开同一个面板没有障碍。 检测慢、卡住、结果不准常见问题的调法大量频道长时间停在检测中多数是源响应慢。把超时时间调长、并发调低——网络一般时并发 3–5 比拉满更稳别为了快把请求堆爆。RTMP 等源做 HTTP 检查必然失败后台任务提供跳过非 HTTP 源的选项v4.1.4 起勾掉后这类行不再拖慢整体进度。列表托管在 GitHub 上时抓取受限未认证请求每小时只有 60 次额度。在 Web 面板 → 系统配置 → 基础配置里填入github_token建议只给 Contents 只读权限的细粒度 token额度升到 5000 次/时保存时系统会先调 API 验证 token 有效性无效的会被拒。导出文件在个别播放器里打不开多半是格式兼容问题先确认播放器对 M3U 头的解析程度必要时改导 TXT 再手工整理。完整的能力变化可以看 CHANGELOG.md当前版本是 5.0.1更细的功能清单深色模式、网速最快筛选、自定义排序等在 README.md 的功能特性一节里。下一步行动清单用docker run把容器拉起来打开 8081对你实际在用的那份列表跑一次完整检查把常看频道收进「想看的频道」再建一个定时检查任务让它每天替你巡检需要换机器或重装时先导出系统配置 ZIP、把导出目录挂到本地路径迁移时基本无感。【免费下载链接】iptv-checkerIPTV checker tool for Docker CMD, check your playlist is available项目地址: https://gitcode.com/GitHub_Trending/ip/iptv-checker创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考