企业官网建设流程全解析

IPTV 播放源检测：iptv-checker 快速部署指南

【免费下载链接】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 列表里的频道链接是否还能正常播放，适合收藏了大量直播源、又不想一个个手动点开试的个人用户和 NAS 玩家。

项目定位

以前维护一份几百个频道的列表，只能逐个点开看能不能播，耗时还容易漏判。iptv-checker 把这件事自动化：导入列表后并发验证每个链接，标出可用与失效，还能按 IPv4 / IPv6 分开导出。

它提供 Docker、Docker Compose 和命令行三种运行方式，统一带一个 Web 管理后台，任务、收藏、设置都在浏览器里完成。

适合三类人：个人用户维护家用列表、小团队保障频道长期可用、开发者把检测接进 CI 流程自动校验列表质量。

快速上手

方式一：Docker 一键部署

装好 Docker 后，拉取镜像并启动容器，两条命令就够：

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

方式二：Docker Compose 部署

仓库自带配好的 docker-compose.yaml，克隆后直接起服务：

git clone https://gitcode.com/GitHub_Trending/ip/iptv-checker cd iptv-checker && docker compose up -d

方式三：命令行二进制

从项目 Releases 页面下载对应平台的二进制文件，在终端里直接运行，适合不想起容器的场景。

如何确认部署成功：浏览器打开http://127.0.0.1:8081，能看到"欢迎使用 iptv-checker"页面即成功。左侧是"定时检查任务、想看的频道、设置"三个模块，首页卡片可以直接跳转。

功能详解

按实际使用流程走一遍，核心就这四步。

1. 导入播放源

把 M3U / M3U8 / TXT 列表的链接或文件交给它，解析时会自动通过 EPG 数据规范化 tvg-name / tvg-id，去掉 "4K" 这类质量后缀。适合拿到新列表、想先过一遍手的场景。

2. 批量检测

默认用 HTTP 方式并发访问每个频道链接，标记可用与失效；担心"连得上但播不了"时，可以开启 FFmpeg 强制检测，判断更准。过程支持暂停和恢复，随时控制进度。

3. 结果导出

检测完成后按 M3U 或 TXT 格式导出只包含可用频道的列表，IPv4、IPv6 还能分开输出。给电视用一套、给别的设备用一套，一次检测分开拿就行。

4. ⏰ 定时检查任务

在"定时检查任务"里新增任务、设置频率，之后它在后台按点自动跑，不用人守着。列表更新频繁时，配一个定时任务基本就一劳永逸了。

场景实战

个人用户（家里几台设备共用一份源）

• 情况：电视、机顶盒、手机都要用同一份 M3U 列表，经常播不了才发现链接失效。
• 操作：Docker 起一个容器，导入列表检测一次，导出可用列表分发到各设备，再建一个定时任务。
• 结果：设备上的列表永远是筛过的，坏链接不会流到播放端。

小团队（对外提供频道服务）

• 情况：承诺频道长期可用，但源本身会定期失效。
• 操作：开启定时检测，失败源在结果里一目了然，配合配置导出定期存档。
• 结果：失效发现从"客户投诉"变成"提前看到"，维护过程有记录可查。

开发者（把检测接进 CI）

• 情况：项目里维护公共播放列表，合并前想自动验证质量。
• 操作：用 CLI 二进制在流水线里触发检查，把导出的结果作为产物归档。
• 结果：每次提交都有列表质量兜底，不用人工抽检。

进阶调优

三个参数最影响检测效率和结果质量，都藏在任务设置里。

• 并发数：默认值偏保守 → 建议按机器性能和网络带宽往上加 → 总耗时明显缩短；机器吃紧就先压低，避免本地资源打满。
• 超时时间：默认值对所有源一刀切 → 建议按列表特征调，快源调短、慢源调长 → 完成速度与慢源存活率之间取得平衡。
• FFmpeg 强制检测：默认只走 HTTP 检查 → 准确率优先时开启 → 用实际拉流结果代替单纯连接判断，但检测时间会增加。

效果对比

常见问题

问：支持哪些列表格式？答：M3U、M3U8 和 TXT 三种，导入时自动识别。

问：检测跑到一半可以停吗？答：可以，检测过程支持暂停和恢复。

问：IPv6 结果能单独拿吗？答：可以，导出时支持 IPv4 / IPv6 分开输出。

问：怎么备份整套配置？答：设置里支持配置打包导出和导入恢复，迁移机器时用得上。

问：判断"可播"不准怎么办？答：给任务开启 FFmpeg 强制检测，用实际拉流结果代替单纯的 HTTP 判断。

更多细节可以看 README 文档 和 更新日志，功能演进和修复记录都有完整说明。

iptv-checker 把"列表能不能播"这件事从手工活变成了定时任务，导入、检测、导出三步走完，剩下的交给后台。需要源码或想跟进更新，直接访问项目仓库即可。

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