📺 想起来了！还在手动找直播源？NAS+IPTV-API帮你自动化！

哈喽，各位NAS玩家们，我是你们的好朋友！话说，你是不是也跟我一样，为了看个直播，每天都在网上冲浪，辛苦搜罗各种直播源？结果呢？刚找到一个能用的，没多久就“阵亡”了，不是卡顿就是直接GG，简直是心塞太平洋！

别急，今天我就要给大伙儿介绍一个真正的“神仙打架”神器——IPTV-API！它能彻底帮你摆脱找源、换源的烦恼，把你的NAS变成一个全自动的“直播源永动机”！想象一下，你的NAS不仅能存电影，还能自己抓取、筛选、测速最新的直播源，并且每天自动更新，简直不要太爽！🥳

🏷️ 核心功能：IPTV-API 到底能干啥？

IPTV-API可不是个“傻大个”，它的功能强大到让你惊掉下巴：

个性化定制频道： 想看啥频道，自己动手丰衣足食！它支持自定义模板，还能给频道起别名，获取结果又多又准。
多路直播源获取： 不管是本地硬盘里的源，还是组播、酒店、订阅源，甚至关键字搜索，它都能帮你搞定。
RTMP推流： 遇到信号不好的直播源？它能把源转换成HLS格式推流，兼容性更高，还能减少缓冲，弱网环境下也能愉快看剧！
EPG电子节目单： 像传统电视一样，显示频道预告内容，知道接下来播啥，再也不用盲点频道了。
频道台标： 各种电视台的Logo都能显示出来，视觉体验直接拉满！
接口测速验效： 这个是核心中的核心！自动获取延迟、速率、分辨率，过滤无效链接，保证你拿到的都是能用的“好源”！
高级偏好设置： IPv4/IPv6偏好、接口排序、数量限制、黑白名单、甚至可以按归属地和运营商过滤，简直是为我们这种爱折腾的玩家量身定做！
定时任务： 默认每天上午6点和下午6点自动更新，你也可以自己设定更新时间，一劳永逸！
多种运行方式： 工作流、命令行、GUI，当然，我们NAS玩家最爱的还是Docker！

🏷️ NAS玩家专属：Docker部署教程来啦！

作为NAS玩家，用Docker部署IPTV-API，那简直是天作之合！简单、便捷、不污染系统环境。下面我给你两种部署方式，总有一种适合你！

1. Docker Compose：懒人必备，一键搞定！✨

如果你和我一样，喜欢简单粗暴，那么Docker Compose绝对是你的首选。只需要几行代码，就能把IPTV-API跑起来！

在你的NAS上，创建一个新的文件夹，比如iptv-api。

在这个文件夹里，新建一个名为docker-compose.yml的文件，然后把下面的内容复制进去：

services:
  iptv-api:
    image: guovern/iptv-api:latest
    container_name: iptv-api
    ports:
      - "5180:5180" # IPTV-API服务端口
      - "8080:8080" # Nginx HTTP服务端口，用于RTMP推流
      - "1935:1935" # Nginx RTMP服务端口，用于RTMP推流
    environment:
      # 你可以在这里设置一些环境变量来覆盖config.ini中的配置，例如：
      # - APP_PORT=5180
      # - NGINX_HTTP_PORT=8080
      # - NGINX_RTMP_PORT=1935
      # - open_update=True # 开启更新
      # - update_interval=12 # 每隔12小时更新一次
      # - time_zone=Asia/Shanghai # 设置时区
    volumes:
      - /你的NAS路径/iptv-api/config:/iptv-api/config # 挂载配置文件目录，方便你修改配置
      - /你的NAS路径/iptv-api/output:/iptv-api/output # 挂载结果文件目录，查看生成的直播源
    restart: unless-stopped # 容器自动重启策略

注意： 把/你的NAS路径/iptv-api/config和/你的NAS路径/iptv-api/output替换成你NAS上实际的路径哦！比如/volume1/docker/iptv-api/config。

保存文件后，打开NAS的SSH工具（或者Docker命令行界面），进入到你创建的iptv-api文件夹，然后运行这句命令：
```
docker compose up -d
```
搞定！现在，IPTV-API容器已经在你的NAS上默默运行啦！🎉

2. 命令行部署：高手进阶，掌控一切！

如果你更喜欢手动掌控一切，或者NAS的Docker不支持Compose，那手动命令行部署也是小意思！

拉取镜像：
首先，把IPTV-API的镜像拉到你的NAS上。国内的朋友们，为了加速，推荐用代理加速地址：
```
docker pull docker.1ms.run/guovern/iptv-api:latest
# 或者，如果你网络够好：
# docker pull guovern/iptv-api:latest
```
运行容器：
镜像拉下来后，就可以运行容器了。为了方便我们管理配置文件和获取结果，一定要把config和output目录挂载出来！
```
docker run -d \
  --name iptv-api \
  -p 5180:5180 \
  -p 8080:8080 \
  -p 1935:1935 \
  -v /你的NAS路径/iptv-api/config:/iptv-api/config \
  -v /你的NAS路径/iptv-api/output:/iptv-api/output \
  --restart unless-stopped \
  guovern/iptv-api:latest
```
同样，记得把/你的NAS路径/iptv-api/config和/你的NAS路径/iptv-api/output替换成你NAS上实际的路径！

小提示： 你还可以在docker run命令里，通过-e参数设置环境变量，来覆盖config.ini里的配置。比如：
-e APP_PORT=5180
-e open_update=True
-e update_interval=12

3.配置文件：私人定制你的专属电视！

部署好容器后，最关键的就是配置文件了！刚才我们挂载了/iptv-api/config目录，所以你可以在NAS上直接找到config.ini文件。

这个文件里有很多参数可以调整，能把IPTV-API打造成你专属的直播源生成器。我挑几个常用的给你讲讲：

open_update = True：这个是总开关，一定要开着，不然就不更新直播源了。
open_epg = True：开启EPG电子节目单，看节目预告。
open_m3u_result = True：开启生成M3U格式的直播源文件，方便播放器导入。
urls_limit = 10：每个频道最多保留多少个直播源接口，太多了播放器会卡，适量就好。
update_mode = interval / update_times / update_interval：设置更新模式和更新时间间隔，interval是按时间间隔更新，time是按指定时间点更新。
time_zone = Asia/Shanghai：设置时区，确保更新时间准确。
app_port = 5180：IPTV-API的Web服务端口，如果你改了，记得Docker里也要改。
open_speed_test = True：开启测速功能，强烈建议开着！
min_resolution = 1920x1080 / min_speed = 0.5：设置最低分辨率和最低速度，低于这个标准的源会被过滤掉。
ipv_type_prefer = auto：IPv4/IPv6偏好，自动选择或者强制偏好某种类型。
location / isp：想看哪个地区或者哪个运营商的源？在这里填入关键字，比如广东,电信。
logo_url：自定义频道台标库地址，让你的电视界面更漂亮！
open_rtmp = True：开启RTMP推流功能。

改完config.ini文件后，记得重启一下Docker容器，让新的配置生效哦！

docker restart iptv-api

🏷️ 直播源到手！怎么用？

IPTV-API运行起来后，你就可以通过浏览器访问它生成的直播源地址了。默认情况下，你的NAS的IP地址加上5180端口，就是IPTV-API的服务地址。

比如，你的NAS IP是192.168.1.100，那么访问地址就是 http://192.168.1.100:5180。

常用的直播源地址接口：

默认直播源： http://你的NAS-IP:5180/
M3U格式： http://你的NAS-IP:5180/m3u
TXT格式： http://你的NAS-IP:5180/txt
IPv4专用M3U： http://你的NAS-IP:5180/ipv4/m3u
IPv6专用M3U： http://你的NAS-IP:5180/ipv6/m3u

你只需要把这些链接复制到你喜欢的播放器（比如PotPlayer、VLC、Kodi、Emby、Jellyfin等）里，就能愉快地观看直播啦！再也不用手动导入M3U文件了，直接订阅这个链接，每次更新都是最新的！😍

如果想看日志，也能通过这些接口访问：

有效结果日志： http://你的NAS-IP:5180/log/result
测速日志： http://你的NAS-IP:5180/log/speed-test

🏷️ 高级玩法：RTMP推流，告别卡顿！

IPTV-API还提供了一个非常实用的功能——RTMP推流！这个功能非常适合那些家里网络环境不咋地，或者直播源本身信号不稳定的情况。

开启RTMP推流后，IPTV-API会利用你NAS的本地带宽，把获取到的直播源（甚至是本地视频文件）转换成HLS格式，然后推流出来。这样，你的播放器接收到的就是稳定的本地推流，大大减少卡顿，提升播放体验！

怎么玩？

在config.ini里把open_rtmp设置为True。
如果你想推流本地视频文件，可以在挂载的config目录下，新建一个hls文件夹。把你想推流的视频文件放进去，文件名就用你想要的频道名（比如CCTV1.mp4）。
推流的接口：
- 默认推流： http://你的NAS-IP:5180/hls
- M3U格式推流： http://你的NAS-IP:5180/hls/m3u
你可以访问 http://你的NAS-IP:8080/stat 来查看实时的推流状态统计数据。