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 就是干这件事的：把 M3U 播放列表链接丢给它，自动批量检测可用性，再把能用的频道导出一份干净列表。Docker 或桌面端跑起来，几分钟就能上手。
它能替你干什么
一句话定位：iptv-checker 是一款 IPTV 播放源检测工具，负责验证 M3U / M3U8 / TXT 播放列表里的频道还活着没有，把"哪些能用、哪些死了"一次性理清楚。
核心能力：
- 批量检测：整份列表并发检查，自动标记有效与失效频道；可再叠加 FFmpeg 深度检测，确认流能否真正解码
- Web 管理后台：任务管理、配置编辑、结果导出都在浏览器里完成，不用守着终端
- 定时任务：检查可以按排期自动执行，不用每次手动触发
- 灵活导出：结果可导出 M3U / TXT，IPv4 与 IPv6 还能分开输出
- 附加功能：EPG 节目单管理、频道图标自动抓取、分辨率标签显示、深色模式；5.0 版本起还附带独立的桌面播放器客户端
中文界面左侧导航能看到三个主要模块：定时检查任务、想看的频道、设置，首页每张功能卡片都能一键跳转到对应页面。
三步跑起来
最省事的路径是 Docker，两条命令加开浏览器：
docker pull zmisgod/iptvchecker docker run -d -p 8081:8089 --name iptv-checker zmisgod/iptvchecker然后在浏览器打开http://127.0.0.1:8081。第二条命令把容器内 8089 端口映射到宿主机 8081，想换端口就改映射，同时可用WEB_PORT环境变量指定监听端口。
其他部署方式：
| 方式 | 用法 | 适合谁 |
|---|---|---|
| Docker Compose | 直接用仓库里的docker-compose.yaml执行docker-compose up -d，已配置自动重启 | 长期运行、服务器环境 |
| CLI 二进制 | 从 Releases 下载对应平台二进制，命令行直接跑 | 进阶用户、CI 流程 |
| 桌面播放器 | iptv-checker-player 独立应用，5.0 版本起随版本发布 | 想边检测边在同一台机器上看播 |
想持久化导出结果，再给 run 命令加一条-v ~/icStatic/output:/app/static/output把输出目录挂出来即可。
第一次检测：导入、跑、导出
完整流程四步：
- 导入播放列表：在检测页粘贴 M3U 链接，或上传本地 M3U / TXT 文件
- 启动检测：点击开始，工具会并发检查整份列表，几百个频道通常几分钟内跑完
- 查看结果：结果表格里绿色代表可用、红色代表失效，支持关键词过滤（通配符写法如
*体育*），也能按可用/失效状态筛选 - 导出：导出一份只含可用频道的播放列表，M3U 或 TXT 任选；只用其中一种 IP 协议的话，IPv4 / IPv6 可分开导出
界面本身中英文双语，英文版功能与中文完全一致，分享给海外用户时不用换工具。
两个真实用法
家庭频道维护
- 需求：全家共用一份播放列表，频道挂了你很难快速定位
- 做法：建一个定时任务，每天凌晨自动全量检查；把家里常看的频道收进"想看的频道"重点盯
- 效果：不用等出问题再排查，日常维护时间从"天天惦记"降到"偶尔看一眼"
小型社区 / 运营监控
- 需求：给小圈子维护 IPTV 源，需要尽早发现坏源并定期产出干净列表
- 做法：开启 FFmpeg 深度检测提高准确性，并发数设 5-10，每次检查完自动导出到固定目录
- 效果：坏源被按时记录，在用户反馈之前就能换源，维护工作量明显下降
两条调优建议：网络环境一般时把并发数调低、超时延长到 10-15 秒；频道量大时分批检测，用后台任务避免界面卡住。
常见坑
Q：Docker 启动后浏览器打不开页面？先确认端口映射写对了，再用docker logs iptv-checker看服务是否正常起来。
Q：某些频道一直卡在"检测中"？多为源响应慢。把超时时间调到 10 秒，开启"跳过非 HTTP 源"，并发数调低一些减轻网络压力。
Q：导出的列表在某些播放器里播不了？试试"简化导出"选项去掉扩展字段，或手动检查文件编码、确认播放器支持的 M3U 格式版本。
Q：Mac 桌面版提示文件已损坏？是系统隔离标记的问题，终端执行xattr -cr /Applications/iptv-checker-desktop.app即可。
Q：抓取 GitHub 上的播放列表会有限流吗？未配置 token 时 API 每小时只有 60 次配额，超限会自动降级为 HTML 解析；在后台填入一个只读权限的github_token，配额可提到 5000 次/小时，保存时系统会自动验证 token 有效性。
接下来去哪
- 官方文档：README.md / 英文 README_EN.md
- 更新日志：CHANGELOG.md，升级前值得看一眼
- Compose 示例：docker-compose.yaml
- 源码：
git clone https://gitcode.com/GitHub_Trending/ip/iptv-checker
把 Docker 跑起来、贴上第一份播放列表，今天就能收获你的第一份干净频道列表。
【免费下载链接】iptv-checkerIPTV checker tool for Docker && CMD, check your playlist is available项目地址: https://gitcode.com/GitHub_Trending/ip/iptv-checker
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考