企业官网建设流程全解析

iptv-checker：三步跑通 IPTV 播放源检测，告别手动挨个试

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

收藏了一堆 IPTV 播放源，三个月后打开一看，一半频道打不开。iptv-checker 就是为解决这件事做的播放源检测工具：把它部署在 Docker 里，把 M3U 播放列表交给它，它会逐个验证每个频道是否还能正常播放，最后导出一份只剩可用频道的干净列表，你再拿这份列表去喂机顶盒或播放器。

播放源失效的几种样子，和为什么手动试没用

IPTV 源失效没有固定规律：有的服务器直接下线，有的换了 IP 或换了线路，有的白天能看、晚上被挤爆。一份几百个频道的列表，你手动试一遍要一下午，而且每次只告诉你"这一个"行不行，剩下的还是未知。

更坑的是另一类：地址还通、请求返回正常，点进去却卡住不出画面。这种"半死"状态靠眼睛根本分辨不出来，而它们恰恰是列表里最该被清掉的。

要解决这事，需要的不是"再试几个"，而是一个能替你批量跑一遍、把死链接过滤掉的工具。iptv-checker 干的就是这件事：它既能用命令行（CLI）跑，也带一个 Web 管理界面，适合挂在一台常开的机器上长期工作。

一次导入 M3U 列表，批量验证每个频道是否可播

它的核心能力用一句话说：把 M3U（最常见的播放列表格式，每个频道一行 URL）、M3U8 或 TXT 列表交给它，它按频道逐个检测可用性，支持并发执行和超时时间配置。

检测分两层。第一层是 HTTP 快速检测，速度快，适合对整张列表做初筛；第二层是强制 FFmpeg 检测——真的去拉几秒流、把画面解出来，确认 CODEC（视频编码格式）能正常解码才算通过。部分 RTSP 协议的源会先读取 SDP（Session Description Protocol，描述流媒体会话中音视频格式的一种元数据），再判断是否可播。两层搭配，既快又不容易被"假 200"骗过。

结果不只是给你看一眼：可以按 M3U / TXT 格式导出，IPv4 和 IPv6 还能分开输出，方便不同网络环境的设备各用一份。此外它内置了「想看频道」收藏管理、EPG（电子节目单，即节目日程数据）配置、频道名智能匹配（解析时自动规范化 tvg-name / tvg-id），导出前能把频道名和分组理干净。

从拉取 Docker 镜像到第一次检测跑通

前置条件只有一个：装好 Docker。然后两条命令：

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

想更省事的话，仓库里直接放了一份现成的 docker-compose.yaml，内容就是镜像、端口 8081:8089、开机自启三件事，执行docker-compose up -d即可。镜像由 Rust 编写，dockerfile 里可以看到构建过程，并预装了 FFmpeg 供强制检测使用。

启动后浏览器打开 http://127.0.0.1:8081，就是这个欢迎页：

左侧只有三个主入口：「定时检查任务」「想看频道」「设置」。第一次检测的路径很短：进入「定时检查任务」→ 新建任务 → 填入你的 M3U 源地址（公共订阅源也可以直接粘贴）→ 点立即执行。任务列表里能看到每个任务的进度，跑完后直接导出可用频道列表，把它重新导入设备，这一步就闭环了。

顺手做一件事：进「系统配置 → 基础配置」填上 github_token。如果你习惯从 GitHub 仓库直接抓取播放列表，未认证每小时只有 60 次请求额度，配上 token 后提升到 5000 次，保存时系统还会自动验证 token 是否有效。

两个进阶设置：强制 FFmpeg 检测与 CRON 定时

让结果更可信：把强制 FFmpeg 检测打开。默认的 HTTP 检测很快，但有一类源返回 200 却播不出来（流中途掐断、编码不对）。把任务的 ffmpeg_check 打开，判定标准就从"地址通"变成"画面能出来"。代价是速度变慢，所以配合并发数一起调：机器核心多就开高并发，机器弱就调低，再给每个源留足超时时间，避免个别慢源拖住整个任务。

让检测自己跑：用 CRON 表达式挂定时任务。后台任务支持定时执行，用 CRON 表达式（标准的定时写法，五位分别表示分、时、日、月、周）定义时间，比如0 3 * * *就是每天凌晨 3 点全量检查一遍。跑完后把导出的干净列表重灌设备，你的播放列表就始终维持在上一次检测的可用状态上。再叠加自定义排序、关键词匹配（只保留你搜得到的频道）、网速最快筛选这些设置，检测任务基本不用人盯。

它和播放器、聚合网关类工具的区别

定位一句话：它只做"检测 + 清理列表"这一件事。常见的同类工具其实是别的角色——IPTVnator、VNSMVP 这类是播放器，负责"看"；xTeVe 这类是聚合/网关，负责"改"源；iptv-checker 站在它们前面，负责"验"。

• 家庭用户：有固定的一两份列表，目标是"每次打开都是能看的频道"，定时任务 + 导出两步走就够。
• 维护公共列表的人：定期批量验证、过滤死链，IPv4/IPv6 分开导出分发给不同网络的用户。
• 有 CI 习惯的开发者：它也提供各平台的 CLI 二进制，可以直接塞进流水线做列表质量检查。

界面支持中英文切换，英文界面长这样：

部署之后的使用节奏建议

第一周先做一次"大扫除"：把你最常用的列表导进去，开强制 FFmpeg 检测全量跑一遍，拿到第一份干净列表换上。之后在「定时检查任务」里挂一个每天凌晨的全量检查，导出结果定期重灌设备即可。如果频道太多太杂，用「想看频道」+ 关键词匹配只圈定你真正在看的那几十个，检测量会小一个量级。

另外两个实用入口：内置播放器可以直接在 Web 里验证频道画面；「设置」中的系统配置支持 ZIP 打包导出和导入，换机器时整套配置可以原样搬走。

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