资讯动态

iptv-checker 完整指南:M3U 播放列表批量播放源检测与 Docker 部署

发布时间:2026/10/23 2:26:06 来源:尧图企业网站定制
iptv-checker 完整指南M3U 播放列表批量播放源检测与 Docker 部署【免费下载链接】iptv-checkerIPTV checker tool for Docker CMD, check your playlist is available项目地址: https://gitcode.com/GitHub_Trending/ip/iptv-checker对于手里握着大量 IPTV M3U 播放列表、又懒得逐个频道点开的用户来说iptv-checker 是个对口的批量播放源检测工具。部署一个 Docker 容器后你就能在 Web 界面里验证 M3U / M3U8 / TXT 列表中每个频道的可用性跑 FFmpeg 深度检测配定时任务最后把只剩可用频道的列表导出给播放器。全程不需要写代码容器起来之后都在浏览器里完成。 Docker 一条命令把服务拉起来官方镜像托管在 Docker Hub拉取后直接起容器docker run -d \ -p 8081:8089 \ --name iptv-checker \ zmisgod/iptvchecker启动完成后浏览器访问http://127.0.0.1:8081即可进入管理界面。容器内部服务默认监听 8089 端口WEB_PORT环境变量外部映射到哪个端口随意改。想要声明式的部署方式项目自带的 docker-compose.yaml 已经配好了8081:8089端口映射和restart: always跑一句docker-compose up -d就行。不想用容器的话也可以从项目 Releases 下载 CLI 二进制直接跑或者用 Tauri 打包的桌面版Windows / macOS / Linux 都有。 配置 GitHub Token60 次到 5000 次的差距如果你计划从 GitHub 仓库直接抓取频道列表这一步建议在首次检测前完成。GitHub API 未认证的频率限制是 60 次/小时配置 token 之后能到 5000 次/小时登录 GitHub创建一个 Fine-grained token权限选Public repositoriesContents: Read-only遵循最小化原则在 Web 后台的系统设置 → 基础配置里填入github_token字段保存时系统会自动调 API 验证 token 有效性无效会被直接拒掉。不配 token 也能用服务会优先走 API触发限流后自动降级为 HTML 页面解析。 跑第一次 M3U 验证进入检测页面粘贴 M3U 链接或上传本地文件确认参数后开始检测。检测方式有两种可以按需组合选项作用建议HTTP 检测按响应状态判断连通性默认开启速度快FFmpeg 强制检测实际拉流解码结果更准重要源开启超时时间单个频道的响应时间窗口按网络状况调整跑完之后结果表格里每个频道都会标上可用 / 不可用状态。v3.2.0 起支持关键词匹配可以用通配符*做模糊搜索配合状态筛选快速定位目标频道。几百个频道以前得在播放器里手动点着看现在一次批量跑完总耗时主要取决于并发数和超时设置。⏰ 定时检测任务怎么配最合理一次检测跑通后可以在「定时检查任务」里建任务让它每天固定时间自动跑。几个关键参数并发数同时检测的频道数量调大缩短总时长源站不稳定时保守一点检测方式HTTP 或 FFmpeg按准确度需求选择立即执行距离下次运行时间超过 3 分钟时任务列表才会展示这个按钮v5.0.0 之后单源检测加了强制超时、运行超 2 小时自动复位一个频道卡死导致后续任务全部停摆的问题已经修复。定时任务本身也支持导入导出换实例时不用重新配。 结果筛选与可用列表导出检测任务结束后结果可以直接导出为 M3U 或 TXT 格式。导出时有几个值得留意的选项按状态过滤只导出判定为可用的频道地址族分开导出IPv4 / IPv6 列表各自输出v4.4.0 起支持不同网络环境各用一份频道名清洗解析时自动规范化tvg-name/tvg-id去掉 4K 这类质量后缀可选在频道名后追加 HD / FHD 或 720p / 1080p 标签字符替换配置批量替换频道名里的特殊字符导出的文件可以直接丢进播放器。配过 EPG 的话M3U 里会带上节目单引用频道在播放器里就有图标和节目名称。️ 长期维护EPG、代理与分组映射列表要长期维护的话下面这几块配置值得了解EPG 管理v4.7.0 起EPG 源配置、同步、缓存管理一站完成系统自带一个默认 EPG 源网络配置proxy、自定义 headers、user_agent 独立放在network.json与基础配置分离频道分组映射本地维护tvg-name到group-title的映射EPG 没覆盖的频道也能快速归类配置导入导出系统配置打包成 ZIP 备份重建容器时一键恢复项目还内置了 SSRF 防护拦截内网 IP 和危险协议并做 URL 合法性校验。功能的完整演进记录可以看项目根目录的 CHANGELOG.md。整体看下来iptv-checker 把拿到源列表 → 验证可用性 → 定期维护 → 导出干净列表这条链路都覆盖到了一条命令起服务一次检测出结果一个任务自动跑一次导出直接进播放器。如果只是先试试水跑一遍 CLI 二进制对小型列表做一次验证再迁到 Docker 也不迟。【免费下载链接】iptv-checkerIPTV checker tool for Docker CMD, check your playlist is available项目地址: https://gitcode.com/GitHub_Trending/ip/iptv-checker创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

读完文章,也想定制专属网站?

尧图设计师 24 小时内与您沟通定制方案

免费获取报价 →
↑