1、IPTV-API 简介

IPTV-API 是一款超实用的 IPTV 电视直播源更新工具，可让您畅享不间断的精彩电视直播。它支持自定义频道，自动获取直播源接口，测速验效后生成可用的结果。

主要功能

• 自定义模板，生成您想要的频道

• 支持多种获取源方式：组播源、酒店源、订阅源、关键字搜索

• 接口测速验效，获取延迟、速率、分辨率，过滤无效接口

• 偏好设置：IPv6、接口来源排序优先级与数量配置、接口白名单

• 定时执行，北京时间每日 6:00 与 18:00 执行更新

• 支持多种运行方式：工作流、命令行、GUI 软件、Docker(amd64/arm64/arm v7)

更多功能请参见：https://github.com/Guovin/TV

2、使用 Docker Compose 部署容器

在 UGOS Pro 系统上，推荐使用项目 Docker Compose 快速部署容器，适合需同时管理多个容器的场景，这种方法简化了容器的部署与管理工作。以下是使用 Docker Compose 部署 IPTV-API 服务的详细步骤。

点击了解：什么是项目（Docker Compose）？

2.1 进入 Docker 项目界面

在 UGOS Pro 系统中，打开 Docker 应用，点击【项目 > 创建】，启动项目创建向导。

2.2 配置 Docker Compose 文件

在项目创建向导中，您需要填写项目名称、存放路径（自动生成）和上传 Docker Compose 配置文件。以下是 IPTV-API 的示例配置：

services:
  iptv-api:
    image: guovern/iptv-api # 使用镜像名称
    container_name: iptv-api # 指定容器名
    ports:
      - "8755:8000" # 将容器的 8000 端口映射到宿主机的 8755 端口，也可自行将NAS主机端口修改为其他端口。
    volumes: 
      - ./config:/iptv-api/config # 指定用于存储或共享容器配置文件的路径
      - ./output:/iptv-api/output # 指定用于持久化存储生成的数据或日志的路径
    restart: always # 设置容器重启策略为始终重启

2.3 参数说明

image

• 使用的 Docker 镜像为 guovern/iptv-api，镜像来源通常是 Docker Hub，且这里没有指定版本，默认为最新版本。

container_name

• 指定容器的名称为 iptv-api，方便通过固定名称管理该容器。

ports

• 将容器的 8000 端口映射到宿主机 NAS 的 8755 端口，局域网内用户可以通过 http://<NAS_IP>:8755 访问容器web 服务。

volumes

./config:/iptv-api/config：./ 表示当前 Docker Compose 文件所在的目录，将主机的配置目录挂载到容器的 /iptv-api/config，用于存储或共享容器配置文件。这里的./config路径可以根据个人NAS实际存放路径进行调整。例如 /volume1/iptv-api/config。

./output:/iptv-api/output ：./ 表示当前 Docker Compose 文件所在的目录，将主机的输出目录挂载到容器的 /iptv-api/output，便于持久化存储生成的数据或日志。这里的./output路径可以根据个人NAS实际存放路径进行调整。例如 /volume1/iptv-api/output。

restart

• always：设置容器无论因任何原因停止都会自动重启，确保服务高可用。

相关阅读

【FAQ】如何在 Docker Compose 配置文件中正确表示 volumes 挂载路径？

3、部署项目

确认配置无误后，点击【立即部署】，系统将自动拉取镜像并启动容器。部署完成后，您可以通过 http://<NAS_IP>:端口访问 IPTV-API 的首页。

镜像下载失败处理方法：

Docker 镜像加速器：建议配置加速器以提高下载速度，特别是在中国内地的网络环境下。参考《Docker配置镜像加速和镜像源》了解如何设置。

代理设置：在某些情况下，您可能需要配置 HTTP/HTTPS 代理来辅助下载，详见《Docker通过设置代理下载镜像》。

4、访问 IPTV-API 服务

部署成功后，您可以通过浏览器访问 http://<NAS-IP>:端口号，将 <NAS-IP> 替换为您的 NAS 的实际 IP 地址（如 http://192.168.22.185:8755）访问  IPTV-API 服务。

下面是不同地址对应的服务，其中8755为上面映射的端口：

• 接口地址：ip:8755

• M3u 接口：ip:8755/m3u 例如 192.168.22.185:8755/m3u

• Txt 接口：ip:8755/txt

• 接口内容：ip:8755/content

• 测速日志：ip:8755/log

4.1 访问接口地址

• 在浏览器输入http://NAS-IP:8755，首次访问可能会提示"未找到结果文件，若已启动更新，请耐心等待更新完成..."。

• 您可以前往【容器】界面，点击右侧的“...”按钮进入控制台，容器日志显示“Update completed ”信息，说明已经更新完毕。

• 更新完毕后，您可以再次访问http://NAS-IP:8755，下载源信息。

4.2 M3u接口

在浏览器输入http://ip:8755/m3u，下载 m3u 格式的源信息。

4.3 Txt接口

影视仓请使用txt接口，不然会出现很多重复并且无用的频道， 在浏览器输入http://ip:8755/txt，下载 txt 格式的源信息。

4.4 接口内容

在浏览器输入http://ip:8755/content，可以获取源信息。

4.5 测速日志

在浏览器输入http://ip:8755/log，可以获取不同频道的测速日志。

更多配置参数请参考此链接：https://github.com/Guovin/iptv-api/blob/master/docs/config.md

5、调用 API 接口

大部分 IPTV 项目都可以直接使用 m3u 地址，比如在 IOS 上下载安装 Fileball 应用，免费版本允许设置一个 IPTV 源，我们选择“添加远程订阅”，然后填入我们自己 NAS 提供的 接口 URL 地址。

请注意：EPG 指的是电子节目单，用于查看每一个频道对应的节目，一般常用的EPG地址有：51zmt（具体可自行上网搜索）

配置示例：

Name: 自定义

URL: http://NAS IP:8755/m3u 请注意：外网访问需要使用公网IP地址。

EPG: 一般为http://epg.51zmt.top:8000/e.xml

配置完成后，点击存储的 IPTV 源，即可观看直播，实现电视自由。

关于其他端或设备如何使用这些源信息可自行上网查询相关资料。

6、注意事项

请注意，本教程中的镜像由第三方开发和维护，教程仅供参考。绿联不承担因用户操作不当、第三方软件漏洞或镜像更新引发的风险，包括但不限于：

· 第三方镜像可能导致您在 UGOS Pro 系统中的文件意外修改或删除。

· 使用不安全的镜像可能导致数据上传至第三方服务器，存在隐私和数据泄露风险。

· 为确保系统稳定和数据安全，请谨慎选择可信来源的第三方镜像。

其他注意事项：

1. 容器的文件/文件夹路径仅供参考，您可以根据个人习惯创建。

2. 网页访问的容器端口和本地端口应保持一致。如有冲突，请改为未使用的端口。容器之间的本地端口不能相同，端口冲突会导致无法启动容器。

3. 容器的网页链接仅在 bridge 桥接模式下可访问。

4. 镜像仅提供搭建教程，具体使用方法和深度玩法请网上搜索参考。

5. 镜像由第三方开发，具体配置变动和 bug 修复请关注相关官方信息。

6. 建议将 Docker 配置目录存储在 SSD 硬盘中，以避免机械硬盘影响系统性能。