文章总结： IPTV-API是一个自动化工具帮助NAS用户获取和更新电视直播源支持Docker部署提供自定义频道测速RTMP推流等功能减少手动找源烦恼提升观影体验通过配置文件和定时任务实现自动更新用户可直接订阅生成的链接在播放器中使用
综合评分： 91
文章分类： 产品介绍,解决方案
想起来了！还在手动找直播源？NAS+IPTV-API帮你自动化！
原创
诺多
高等精灵实验室
2025年12月14日 08:30
江苏
📺 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跑起来！
- 1. 在你的NAS上，创建一个新的文件夹，比如
iptv-api。 - 2. 在这个文件夹里，新建一个名为
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。
- 3. 保存文件后，打开NAS的SSH工具（或者Docker命令行界面），进入到你创建的
iptv-api文件夹，然后运行这句命令：
docker compose up -d
搞定！现在，IPTV-API容器已经在你的NAS上默默运行啦！🎉
2. 命令行部署：高手进阶，掌控一切！
如果你更喜欢手动掌控一切，或者NAS的Docker不支持Compose，那手动命令行部署也是小意思！
- 1. 拉取镜像：
首先，把IPTV-API的镜像拉到你的NAS上。国内的朋友们，为了加速，推荐用代理加速地址：
docker pull docker.1ms.run/guovern/iptv-api:latest
# 或者，如果你网络够好：
# docker pull guovern/iptv-api:latest
- 2. 运行容器：
镜像拉下来后，就可以运行容器了。为了方便我们管理配置文件和获取结果，一定要把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文件了，直接订阅这个链接，每次更新都是最新的！😍
IPTV-API
如果想看日志，也能通过这些接口访问：
- • 有效结果日志：
http://你的NAS-IP:5180/log/result - • 测速日志：
http://你的NAS-IP:5180/log/speed-test
🏷️ 高级玩法：RTMP推流，告别卡顿！
IPTV-API还提供了一个非常实用的功能——RTMP推流！这个功能非常适合那些家里网络环境不咋地，或者直播源本身信号不稳定的情况。
开启RTMP推流后，IPTV-API会利用你NAS的本地带宽，把获取到的直播源（甚至是本地视频文件）转换成HLS格式，然后推流出来。这样，你的播放器接收到的就是稳定的本地推流，大大减少卡顿，提升播放体验！
怎么玩？
- 1. 在
config.ini里把open_rtmp设置为True。 - 2. 如果你想推流本地视频文件，可以在挂载的
config目录下，新建一个hls文件夹。把你想推流的视频文件放进去，文件名就用你想要的频道名（比如CCTV1.mp4）。 - 3. 推流的接口：
- • 默认推流：
http://你的NAS-IP:5180/hls - • M3U格式推流：
http://你的NAS-IP:5180/hls/m3u
- 4. 你可以访问
http://你的NAS-IP:8080/stat来查看实时的推流状态统计数据。
🏷️ 结语：你的NAS，无限可能！
怎么样，是不是感觉自己的NAS又多了一项“超能力”？IPTV-API这个小工具，看似不起眼，但却能大大提升我们的观影体验。告别那些频繁失效的直播源，让你的NAS成为真正的家庭娱乐中心！
赶紧行动起来，把IPTV-API部署到你的NAS上，享受私人定制的流畅直播体验吧！如果遇到什么问题，欢迎在评论区留言交流，我们一起折腾，一起进步！
原创不易，希望这篇文章对你有所帮助！如果觉得不错，记得点赞、收藏、分享哦！💖
高等精灵实验室
免责声明：
本文所载程序、技术方法仅面向合法合规的安全研究与教学场景，旨在提升网络安全防护能力，具有明确的技术研究属性。
任何单位或个人未经授权，将本文内容用于攻击、破坏等非法用途的，由此引发的全部法律责任、民事赔偿及连带责任，均由行为人独立承担，本站不承担任何连带责任。
本站内容均为技术交流与知识分享目的发布，若存在版权侵权或其他异议，请通过邮件联系处理，具体联系方式可点击页面上方的联系我。
本文转载自：高等精灵实验室 诺多《想起来了！还在手动找直播源？NAS+IPTV-API帮你自动化！》