全自动 IPTV 直播源采集、测速、验证、分类与自治管理平台。 通过 GitHub Actions 定时运行，无需服务器，永久免费。

• 多源聚合 – 自动拉取 10+ 公开 IPTV 源，解析 M3U / TXT，智能去重。
• 双重验证 – HTTP 快速探测 + ffmpeg 深度验证，过滤无效、广告、黑名单 URL。
• 智能分类 – 按央视、卫视、地方（省份）、港澳台自动归类，支持 demo.txt 自定义顺序。
• 固定源保护 – 预设优质源，系统支持自动优化（选择延迟最低的备源），也可锁定禁止替换。
• 自治模式 – 新源先进入候选池，经过多次验证（成功率、延迟）达标后才提升为稳定源，实现“发现-验证-提升”闭环。
• 多格式输出 – 生成 tv.m3u、tv.txt、tv_multi.m3u、channels.json、tv_lite.m3u。
• 完全自动化 – 通过 GitHub Actions 每 6 小时自动运行，输出文件直接托管在仓库中。

1.Fork 本仓库到你的 GitHub 账号。 2.启用 Actions：进入仓库 → Actions 标签 → 点击“I understand my workflows, go ahead and enable them”。 3.手动触发首次运行（可选）：进入 Actions → IPTV 源智能更新与整理 → Run workflow。 4.获取播放列表：

• 标准 M3U：https://你的用户名.github.io/ITV/output/tv.m3u
• 标准 TXT：https://你的用户名.github.io/ITV/output/tv.txt
• JSON API：https://你的用户名.github.io/ITV/output/channels.json （替换 你的用户名 为你的 GitHub 账号名）

# git clone https://github.com/你的用户名/ITV.git
cd ITV
pip install -r requirements.txt
# 安装 ffmpeg（可选，用于深度验证）
sudo apt-get install ffmpeg   # Ubuntu/Debian
python -m src.run

更多配置项请查看 config/config.yaml。

1.采集 → 拉取所有订阅源，解析并去重。 2.测速验证 → HTTP 探测 + ffmpeg 深度验证，过滤无效源。 3.候选池观察 → 新源进入候选池，经多次验证（次数≥3、成功率≥50%、延迟≤3000ms）后标记为稳定。 4.提升 → 稳定候选源替换同名劣质源，记录到稳定池。 5.质量监控 → 稳定源持续检测，连续失败触发告警，自动从候选池寻找替代。

在 src/fixed_sources.py 中预设优质源，系统将优先使用这些源，并支持自动优化（选择延迟最低的备源）或锁定禁止替换。

CCTV_FIXED_SOURCES = {
    "CCTV-1": ["http://example.com/cctv1.m3u8"],
    "CCTV-5+": ["http://example.com/cctv5plus.m3u8"],
}

🚀 快速部署

1. 拉取镜像

docker pull zzgpy/itv:latest

2. 一次性运行（手动触发）

docker run --rm \
  -v $(pwd)/data:/app/data \
  -v $(pwd)/output:/app/output \
  -e AUTONOMOUS_MODE=true \
  -e FFMPEG_ENABLE=true \
  -e MAX_WORKERS=20 \
  zzgpy/itv:latest

参数说明：

• --rm：容器执行完成后自动删除。
• -v $(pwd)/data:/app/data：挂载数据目录，保存缓存和候选池等状态。
• -v $(pwd)/output:/app/output：挂载输出目录，获取生成的播放列表文件。
• -e：覆盖环境变量，可调整运行行为。 执行完成后，./output 目录下会生成 tv.m3u、tv.txt 等文件。

方式一：宿主机 crontab（Linux） 编辑 crontab：

crontab -e

添加一行（每天凌晨 2 点执行）：

0 2 * * * docker run --rm -v /path/to/data:/app/data -v /path/to/output:/app/output zzgpy/itv:latest

替换 /path/to/data 和 /path/to/output 为实际路径。 方式二：Kubernetes CronJob（集群环境） 创建 cronjob.yaml：

apiVersion: batch/v1
kind: CronJob
metadata:
 name: iptv-collector
spec:
 schedule: "0 2 * * *"
 jobTemplate:
   spec:
     template:
       spec:
         containers:
         - name: iptv-collector
           image: zzgpy/itv:latest
           env:
           - name: AUTONOMOUS_MODE
             value: "true"
           - name: FFMPEG_ENABLE
             value: "true"
           volumeMounts:
           - name: data
             mountPath: /app/data
           - name: output
             mountPath: /app/output
         volumes:
         - name: data
           persistentVolumeClaim:
             claimName: iptv-data
         - name: output
           persistentVolumeClaim:
             claimName: iptv-output
         restartPolicy: OnFailure

应用：

kubectl apply -f cronjob.yaml

若需要覆盖默认 config/config.yaml，可挂载自定义配置目录：

docker run --rm \
  -v $(pwd)/config:/app/config \
  -v $(pwd)/data:/app/data \
  -v $(pwd)/output:/app/output \
  zzgpy/itv:latest

注意：config/ 目录下必须包含 config.yaml、alias.txt、blacklist.txt、demo.txt、subscribe.txt 等文件，否则程序将使用默认配置。

创建 docker-compose.yml：

version: '3'
services:
  iptv-collector:
    image: zzgpy/itv:latest
    container_name: iptv-collector
    restart: "no"
    volumes:
      - ./data:/app/data
      - ./output:/app/output
      - ./config:/app/config   # 可选
    environment:
      - AUTONOMOUS_MODE=true
      - FFMPEG_ENABLE=true
      - MAX_WORKERS=20

运行：

docker-compose up

由于容器执行完成后会退出，如需定时运行，建议用外部 cron 调度 docker-compose run --rm iptv-collector。

完整配置可查看 config/config.yaml 或通过 -e 覆盖。

• /app/data：数据库缓存、候选池、稳定源记录等状态数据，建议持久化，避免每次重新学习。
• /app/output：生成的播放列表文件（tv.m3u、tv.txt 等），需持久化才能供外部服务访问。

编辑 config/demo.txt 即可自定义频道分组和顺序，支持精确匹配、包含匹配、拼音匹配和省份自动归类。

• 本项目仅用于个人学习和测试，不用于任何商业用途。
• 所有节目源均来自互联网公开链接，项目本身不存储、不篡改任何媒体内容。
• 严禁将本项目及生成的播放列表用于商业传播、二次分发。
• 因违规使用产生的任何法律责任，均由使用者自行承担。

MIT License