提醒：本工具仅供技术研究和学习使用，请勿用于非法用途。

简介

什么是 IPTV-Spider ？

IPTV-Spider（又名万人骑 IPTV 工具）是一个 IPTV 直播源自动采集和管理工具。它可以帮助用户全自动采集全网公开的组播/酒店源，自动验证有效性，并生成可直接使用的订阅接口。

主要特点

自动采集：支持组播（Multicast）和酒店源（Hotel）两种模式，后台静默扫描，无需挂机等待
智能验证：采集到的 IP 会自动进行连接测试，过滤掉失效的假源，只保留能看的
可视化管理：通过 Web 界面清晰地查看每个IP 的归属地、节目数量、上线时间，还能一键删除失效源
接口生成：每个有效 IP 都可以生成独立的订阅接口，直接输出 M3U 格式的频道列表

应用场景

电视直播：采集有效直播源，通过接口直接导入电视播放器观看
源站备份：将采集到的源保存下来，建立自己的 IPTV 源库
接口分享：生成接口地址，分享给家人朋友使用

IPTV-Spider 是一个实用的 IPTV 源采集和管理工具，适合需要免费直播源的用户使用。

安装

在群晖上以 Docker 方式安装。

镜像选择

该项目的 Docker 镜像同时发布在 Docker Hub 和 ghcr.io

镜像来源镜像地址 Docker Hub（推荐）

cqshushu/iptv-spider:latest

ghcr.io

ghcr.io/cqshushu/iptv-spider:latest

国内加速镜像：

镜像地址 swr.cn-north-4.myhuaweicloud.com/ddn-k8s/docker.io/cqshushu/iptv-spider:latest

本文写作时，latest 版本对应为 v2.1.1；

卷

在 docker 文件夹中，创建一个新文件夹 iptv-spider，并在其中建一个子文件夹 data

文件夹装载路径说明 docker/iptv-spider/data

/app/data

存放采集的数据

端口

本地端口不冲突就行，不确定的话可以用命令查一下

# 查看端口占用
netstat -tunlp | grep 端口号

本地端口容器端口 50085

50085

命令行安装

docker cli 安装

如果你熟悉命令行，可能用 docker cli 更快捷

# 新建文件夹 iptv-spider 和 子目录
mkdir -p /volume1/docker/iptv-spider/data

# 进入 iptv-spider 目录
cd /volume1/docker/iptv-spider

# 运行容器
docker run -d \
  --name iptv-spider \
  --restart unless-stopped \
  -p 50085:50085 \
  -v $(pwd)/data:/app/data \
  cqshushu/iptv-spider:latest

docker-compose 安装

也可以用 docker-compose 安装，将下面的内容保存为 docker-compose.yml 文件

version: '3.8'

services:
  iptv-spider:
    image: cqshushu/iptv-spider:latest
    container_name: iptv-spider
    restart: unless-stopped
    ports:
      - "50085:50085"
    volumes:
      - ./data:/app/data  # 存放数据

然后通过 SSH 登录到您的群晖，执行下面的命令：

# 新建文件夹 iptv-spider 和 子目录
mkdir -p /volume1/docker/iptv-spider/data

# 进入 iptv-spider 目录
cd /volume1/docker/iptv-spider

# 将 docker-compose.yml 放入当前目录

# 一键启动
docker-compose up -d

运行

在浏览器中访问 http://<群晖IP>:50085 即可进入登录界面，填入从公众号获取的 KEY 后点验证

如果之前安装过

老苏是从 1.0 开始用的

还需要验证一下登录密码

登录成功后的主界面

设置

进入 设置 –> API设置，分别检查版本和 API

如果 API 测试不通过，可以启用 网络代理 ，再试试

数据采集

进入 采集 –> 采集数据

采集参数说明：

页数：采集页数，建议不超过 5 页
开始日期：只保留大于该日期的数据，建议不要超过 5 天

等待……

直到采集结束

这一块和 1.0 的变化不大

播放

切换到 IP管理

相比 1.0，不仅接口细分为了 TXT 和 M3U，还增加了编辑和播放

组播源可能需要 udp-stream 的配合，所以老苏只试了下 酒店源

进入播放界面，虽然画质不高，但是可以播放

直接复制 M3U，用 Potplayer 试一下

这个源确实分辨率不高，但速度挺快的

注意事项

仅供学习研究：本工具仅供技术研究和学习使用，请勿用于非法用途
手动采集：当前只支持手动采集，也支持通过 /api/collect 接口进行自动更新
端口冲突：如果 50085 端口被占用，可以改为其他端口
数据备份：记得定期备份 data 目录中的数据，避免丢失

参考文档

IPTV-Spider: 万人骑IPTV工具 Docker版
地址：https://hub.docker.com/r/cqshushu/iptv-spider

Package iptv-spider
地址：https://ghcr.io/cqshushu/iptv-spider

医工学习日志 – 作者博客
地址：https://cqshushu.blogspot.com/

IPTV-Spider Docker 版发布 – 微信公众号文章
地址：https://mp.weixin.qq.com/s/fZoV82bgQt2vH4Qe6xJ51g