
想不想拥有一个完全个性化的电视直播体验?告别卡顿,享受秒播的快感?IPTV-API就是你的答案!这是一个可高度定制的IPTV接口更新项目,实际上就是此前笔者介绍过的
tv-driver升级版。可以让你轻松拥有自定义频道菜单,自动获取直播源,测速验效后生成可用的结果,实现“✨秒播级体验🚀”。
🚀IPTV-API,到底牛在哪里?
IPTV-API之所以如此受欢迎,主要有以下几个核心优势:
- ✅ 高度自定义: 你可以根据自己的喜好,自定义频道菜单,打造专属的电视直播列表。
- ✅ 自动获取直播源: 无需手动搜索,IPTV-API会自动帮你获取最新的直播源,省时省力。
- ✅ 测速验效: IPTV-API会对获取的直播源进行测速和验证,过滤掉无效的接口,确保播放的流畅性。
- ✅ 多种获取源方式: 支持本地源、组播源、酒店源、订阅源、关键字搜索,总有一种方式适合你
- ✅ EPG功能: 支持EPG功能,让你提前了解频道预告内容,追剧更方便。
- ✅ 偏好设置: 你可以设置IPv4、IPv6、接口来源排序优先级与数量配置、接口白名单等,让IPTV-API更符合你的使用习惯。
- ✅ 多种运行方式: 支持工作流、命令行、GUI软件、Docker等多种运行方式,满足不同用户的需求。
⚙️核心配置,玩转IPTV-API
想要玩转IPTV-API,了解其核心配置是必不可少的。以下是一些常用的配置项:
| 配置项 | 描述 | 默认值 |
|---|---|---|
open_driver |
开启浏览器运行,若更新无数据可开启此模式,较消耗性能 | False |
open_epg |
开启EPG功能,支持频道显示预告内容 | True |
open_filter_speed |
开启速率过滤,低于最小速率(min_speed)的接口将会被过滤 |
True |
open_subscribe |
开启订阅源功能 | False |
ipv_type_prefer |
接口协议类型偏好,优先将该类型的接口排在结果前面,可选值:ipv4、ipv6、自动(auto) |
ipv6,ipv4 |
min_speed |
接口最小速率(单位M/s),需要开启 open_filter_speed 才能生效 |
0.2 |
source_file |
模板文件路径 | config/demo.txt |
subscribe_num |
结果中偏好的订阅源接口数量 | 10 |
🚀快速上手,多种方式任你选
IPTV-API提供了多种上手方式,无论你是技术小白还是资深玩家,都能找到适合自己的方法。
1. 命令行
pip install pipenv
pipenv install --dev
启动更新:
pipenv run dev
启动服务:
pipenv run service
2. GUI 软件
- 可在文末获取下载链接,打开软件后,设置好相关选项,保存并启动,即可完成更新
- 或者在项目目录下运行以下命令,即可打开 GUI 软件:
pipenv run ui

3. Docker 🐳
使用 Docker 部署 IPTV-API 可以让你快速搭建环境,无需关心复杂的依赖关系。
a. Docker CLI
- 拉取镜像
docker pull guovern/iptv-api:latest
国内用户可以使用代理加速:
docker pull docker.1ms.run/guovern/iptv-api:latest
- 运行容器
docker run -d \
-p 8000:8000 \
-v /path/to/your/config:/iptv-api/config \
-v /path/to/your/output:/iptv-api/output \
-e APP_HOST="http://your_domain_or_ip" \
-e APP_PORT=8000 \
-e UPDATE_CRON="0 22,10 * * *" \
guovern/iptv-api
说明:
-p 8000:8000:将容器的8000端口映射到宿主机的8000端口。-v /path/to/your/config:/iptv-api/config:将宿主机的/path/to/your/config目录挂载到容器的/iptv-api/config目录,用于存放配置文件。-v /path/to/your/output:/iptv-api/output:将宿主机的/path/to/your/output目录挂载到容器的/iptv-api/output目录,用于存放输出结果。-e APP_HOST="http://your_domain_or_ip":设置APP_HOST环境变量,用于指定访问地址。-e APP_PORT=8000:设置APP_PORT环境变量,用于指定服务端口。-e UPDATE_CRON="0 22,10 * * *":设置UPDATE_CRON环境变量,用于指定定时更新任务的时间。
b. Docker Compose
- 创建
docker-compose.yml文件
version: "3.9"
services:
iptv-api:
image: guovern/iptv-api:latest
container_name: iptv-api
ports:
- "8000:8000"
volumes:
- /path/to/your/config:/iptv-api/config
- /path/to/your/output:/iptv-api/output
environment:
APP_HOST: "http://your_domain_or_ip"
APP_PORT: 8000
UPDATE_CRON: "0 22,10 * * *"
restart: unless-stopped
说明:
image: 使用的镜像名称。container_name: 容器名称。ports: 端口映射。volumes: 目录挂载。environment: 环境变量。restart: unless-stopped: 除非手动停止,否则容器总是尝试重新启动。
- 启动容器
在包含 docker-compose.yml 文件的目录下,执行以下命令:
docker-compose up -d
环境变量:
| 变量 | 描述 | 默认值 |
|---|---|---|
APP_HOST |
服务host地址,可修改使用公网域名 | http://localhost |
APP_PORT |
服务端口 | 8000 |
UPDATE_CRON |
定时任务执行时间 | "0 22,10 * * *" |
挂载设置:
| 宿主机目录 | 容器目录 | 描述 |
|---|---|---|
/path/to/your/config |
/iptv-api/config |
存放配置文件,例如 config/demo.txt(模板文件)和 config/local.txt(本地源文件)。 确保将你的自定义配置放入此目录。 |
/path/to/your/output |
/iptv-api/output |
存放生成的IPTV结果文件,例如 output/result.m3u。 更新后的结果会保存在这个目录中。 |
- 访问接口
| 接口 | 描述 |
|---|---|
/ |
默认接口 |
/m3u |
m3u 格式接口 |
/txt |
txt 格式接口 |
/ipv4 |
ipv4 默认接口 |
/ipv6 |
ipv6 默认接口 |
/ipv4/txt |
ipv4 txt接口 |
/ipv6/txt |
ipv6 txt接口 |
/ipv4/m3u |
ipv4 m3u接口 |
/ipv6/m3u |
ipv6 m3u接口 |
/content |
接口文本内容 |
/log |
测速日志 |
记住将 /path/to/your/config 和 /path/to/your/output 替换为你宿主机上实际的目录。
🎉 下载GUI
关注我的公众号,私信【iptvapi】即可快速获取下载链接,下载后打开GUI即可享用。
原创不易,如果觉得此文对你有帮助,不妨点赞+收藏+关注,你的鼓励是我持续创作的动力!

原创文章,作者:诺多,如若转载,请注明出处:https://www.huluohu.com/posts/1533/
微信扫一扫
支付宝扫一扫