NAS+IPTV-API帮你自动化
别急,今天我就要给大伙儿介绍一个真正的“神仙打架”神器——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,那简直是天作之合!简单、便捷、不污染系统环境。下面我给你两种部署方式,总有一种适合你!
- 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上默默运行啦!🎉
- 命令行部署:高手进阶,掌控一切!
如果你更喜欢手动掌控一切,或者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文件了,直接订阅这个链接,每次更新都是最新的!😍
IPTV-API
如果想看日志,也能通过这些接口访问:
有效结果日志: 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 来查看实时的推流状态统计数据。
🏷️ 结语:你的NAS,无限可能!
怎么样,是不是感觉自己的NAS又多了一项“超能力”?IPTV-API这个小工具,看似不起眼,但却能大大提升我们的观影体验。告别那些频繁失效的直播源,让你的NAS成为真正的家庭娱乐中心!
赶紧行动起来,把IPTV-API部署到你的NAS上,享受私人定制的流畅直播体验吧!如果遇到什么问题,欢迎在评论区留言交流,我们一起折腾,一起进步!