想不想拥有一个完全个性化的电视直播体验？告别卡顿，享受秒播的快感？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 软件

1. 可在文末获取下载链接，打开软件后，设置好相关选项，保存并启动，即可完成更新
2. 或者在项目目录下运行以下命令，即可打开 GUI 软件：

pipenv run ui

3. Docker 🐳

使用 Docker 部署 IPTV-API 可以让你快速搭建环境，无需关心复杂的依赖关系。

a. Docker CLI

1. 拉取镜像

docker pull guovern/iptv-api:latest

国内用户可以使用代理加速：

docker pull docker.1ms.run/guovern/iptv-api:latest

2. 运行容器

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

1. 创建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: 除非手动停止，否则容器总是尝试重新启动。

2. 启动容器

在包含 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。 更新后的结果会保存在这个目录中。

3. 访问接口

接口	描述
/	默认接口
/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即可享用。

---

原创不易，如果觉得此文对你有帮助，不妨点赞+收藏+关注，你的鼓励是我持续创作的动力！