3步跑通iptv-checker：IPTV播放列表批量检测完整指南

3步跑通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 批量检测一份几百个频道的 M3U 播放列表，失效频道一次全部现形，不用再逐条手动试。它是一款轻量级的 IPTV 源检测工具，支持 Docker 部署与命令行运行，过滤失效源并导出可用的频道列表。

快速部署：Docker、Compose、CLI 各一条命令

Docker（推荐）

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

CLI：从官方 Release 页下载对应平台的二进制文件，终端直接运行，适合接入 CI/CD 流程。

启动后访问http://127.0.0.1:8081进入 Web 管理界面：

常用参数：

• -p 8081:8089：容器服务端口是 8089，改左侧数字即可自定义宿主机访问端口
• -d：后台运行；去掉则前台运行，方便看启动日志

首次上手闭环：从输入源到导出可用列表

1. 访问http://127.0.0.1:8081，欢迎页点「定时检查任务 → 前往任务」。
2. 新建检测任务，填入 M3U / M3U8 / TXT 源地址，也支持导入本地文件。
3. 保存并启动检测，系统逐批校验频道，结果表实时刷新各频道状态。
4. 检测完成后逐行核对：可用与失效分色标注，还能按频道名关键词搜索定位。
5. 点导出，生成过滤后的 M3U / TXT 文件，IPv4 与 IPv6 列表可分开输出。

效率进阶：3个高频设置

• 定时检查任务：把例行巡检交给工具，到点只看结果。示例：检查周期设为「每天凌晨 2 点」，任务自动执行并留存历史记录。
• FFmpeg 深度检测：HTTP 返回 200 不代表能出流，FFmpeg 强制检测能抓出「显示存活但实际播不了」的源。示例：在任务设置中勾选ffmpeg_check选项。
• 关键词匹配 + 网速最快筛选：几百个频道里秒级定位。示例：搜索框输入频道名关键词过滤，或按网速排序挑出最快的线路。

避坑速查

• 启动后访问不了界面→ 端口映射写错。核对-p 8081:8089是否与访问地址一致，docker logs iptv-checker看容器状态。
• 单个频道检测卡住不动→ 该源无响应且未设超时。在系统设置里给单源加硬超时；5.0.0 已修复定时任务无限等待的问题。
• 批量抓取 GitHub 仓库源变慢→ 未认证 API 限流 60 次/小时。在「系统配置 → 基础配置」填入有效的github_token，限额提升到 5000 次/小时。
• 导出的列表播放器打不开→ 扩展字段与播放器不兼容。改用简化导出，只保留必要字段再导入播放器。

延伸资源

• README.md：完整使用说明、功能清单与 GitHub Token 配置
• README_EN.md：英文文档
• CHANGELOG.md：各版本详细更新日志
• docker-compose.yaml：可直接使用的 Compose 配置

版本提示：最新 5.0.1 将播放器频道列表合并为统一列表（已检查 + 已收藏去重），并修复了定时检查配置页的fmtTime is not defined报错。

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