iptv-api：Python 开源工具用于 IPTV 直播源自动采集、测速过滤与推流

摘要

1) 一句话总结 Guovin/iptv-api 是一个基于 Python 的开源 IPTV 直播源自动更新平台，提供全自动采集、测速、过滤及推流功能，并支持工作流、Docker、命令行与 GUI 等多端部署。

2) 核心要点

项目基础：基于 Python 开发，采用 MIT 开源协议，社区活跃度高（超 22,600 Stars，7,100+ Forks），最新发布版本为 2.0.0。
核心功能：支持多源聚合（本地源与订阅源），可全自动进行直播源的采集、筛选、测速验效（获取延迟、速率、分辨率）及结果生成。
个性化与扩展：支持自定义频道模板、频道别名（正则表达式）、EPG（节目预告）、频道台标（本地或远程库）以及回放类接口的获取。
高级过滤机制：支持按分辨率（默认最低 1280x720）、速率（默认最低 0.5M/s）、归属地、运营商以及黑白名单对接口进行精准过滤。
推流支持：内置 RTMP 推流功能（需安装 FFmpeg），可利用本地带宽改善弱网播放体验，并支持对本地 HLS 视频源进行推流。
多平台部署：支持 GitHub 工作流、命令行（pipenv）、GUI 桌面软件以及 Docker（支持 amd64/arm64/arm v7，推荐使用 Compose 部署）等多种运行方式。
结果输出：生成结果支持 m3u 和 txt 格式，兼容 IPv4 与 IPv6 协议，并提供丰富的 API 接口用于访问播放列表、推流地址及各类运行日志。

3) 风险与不足

工作流封禁风险：因项目 Fork 数量过多触发 GitHub 资源上限预警，官方已将工作流调整为手动触发；用户必须手动移除 main.yml 中的定时任务，否则可能面临工作流被禁用的风险。
无内置数据源：项目本身不提供任何直播数据源，用户必须自行寻找并添加数据源后才能生成有效结果。
结果质量依赖：最终生成的直播源质量高度依赖于用户提供的数据源质量以及运行时的网络环境。
测速准确性权衡：测速并发数、超时时长的调整，以及开启 Host 地址过滤功能，均会在更新耗时与测速结果准确性/接口质量之间产生博弈（例如开启 Host 过滤可大幅提速，但可能导致测速不准）。

⚡️IPTV直播源自动更新平台『🤖全自动采集、筛选、测速、生成🚀』：自定义获取频道；IPv4/IPv6；接口验效；推流；多平台支持；工作流、Docker、命令行、GUI多端部署 | IPTV live streaming source automatic update platform