全自动维护IPTV直播源！Docker一键部署，彻底告别失效源-一万AI分享

摘要：还在手动找 m3u 直播源？还在为源失效而烦恼？本文教你在飞牛 NAS (FnOS) 上部署 IPTV Spider + Aggregator 自动化伴侣，打造一个“会自己更新”的直播源中心。

DockerHub地址：https://hub.docker.com/r/yiwanaishare/iptv-aggregator

---

😫 痛点：看电视五分钟，找源两小时

玩 NAS 和软路由的兄弟们，十有八九都折腾过 IPTV。大家肯定都有过这种经历：

在论坛或群里求到一个 m3u 列表。
导入 TiviMate 或 TVBox，刚开始挺爽。
过了三天，源失效了，画面转圈圈。
循环第一步...

为了解决这个问题，我封装了一个伴侣服务 IPTV Aggregator（聚合器）。

Aggregator (管家)：负责指挥爬虫、清洗数据、按你的喜好（省份/运营商）排序，并生成最终的播放列表。

今天就手把手教大家，如何在 飞牛 NAS (FnOS) 上一键部署这套神器！

🛠️ 准备工作

设备：安装了飞牛 OS 的 NAS。
网络：NAS 需能正常访问互联网（爬虫需要联网）。
工具：飞牛自带的“文件管理”和“Docker”。

🚀 部署步骤

第一步：创建文件夹

打开飞牛桌面的 「文件管理」：

找到或新建 docker 文件夹。
在里面新建一个文件夹，命名为 iptv。

📂 最终路径结构：docker/iptv/data（这个 data 目录用于存放生成的 iptv.txt，方便你直接取用）

第二步：创建 Docker 项目

打开飞牛桌面的 「Docker」 应用。
点击左侧菜单的 「项目」（Compose）。
点击右上角 「创建项目」。
项目名称：填写 iptv-auto。
路径：选择刚才创建的 docker/iptv。

第三步：配置 Docker Compose (核心)

将下方代码完整复制到编辑框中。请务必阅读代码中的中文注释，根据你的实际情况修改环境变量！

YAML

services:
  aggregator:
    # 官方镜像 (v2.0)
    image: yiwanaishare/iptv-aggregator:latest
    container_name: iptv-aggregator
    restart: unless-stopped
    ports:
      - "50086:50086"
    environment:
      # ==================== 用户自定义配置 ====================
      # 优先关键词 (如 "山西,联通", 逗号分隔)
      - PRIORITY_KEYWORDS=山西,联通   
  
      # 自动更新间隔（小时）
      - REFRESH_INTERVAL_HOURS=12   
  
      # 时区设置
      - TZ=Asia/Shanghai      
  
    volumes:
      # 数据持久化目录
      - ./data:/app/data

点击 「确定」 或 「构建并启动」，等待镜像拉取完成并变绿运行。

⏳ 验证与避坑（重要！）

很多朋友部署失败，都是因为太急了！

1. 为什么接口是空的？

刚启动时，访问接口可能会报错或返回空数据。这是正常的！

原因：爬虫也是需要时间去公网扫描 IP、测速的。
查看日志：点击 iptv-aggregator 容器 -> 日志。
- 看到 Trigger spider collection... 说明任务已下发。
- 此时去 iptv-spider 容器看日志，会发现它正在疯狂刷屏扫描。
等待时间：根据你设置的页数，通常需要 **5-**10分钟 才能完成第一轮扫描。

2. 如何确认成功？

当 iptv-aggregator 的日志中出现：

Playlist generated 或 Saved iptv.txt

说明第一轮数据已经生成完毕！🎉

📺 使用方法

获取播放地址

打开浏览器，输入：http://你的NAS_IP:50086/iptv

你会看到一个纯文本的频道列表，已经按你的关键词排好序了。

导入电视

打开 TiviMate、影视仓、TVBox 或 Kodi：

添加 M3U 播放列表。
地址栏输入上面的链接。
尽情享受秒切、高清、无广告的直播吧！

❓ 常见问题 (FAQ)

**Q：为什么扫不到源？**A：请检查 FILTER_TYPE。如果你家里没有组播环境，千万别选 multicast，请改回 hotel。

**Q：日志提示 Spider 密码错误？**A：检查环境变量 SPIDER_PASSWORD。如果你没有修改过 Spider 的镜像，默认密码就是 yiwan123。如果你手动去 Spider 后台改过密码，这里必须同步。

Q：端口冲突怎么办？A：如果 50085/50086 被占用，在 Compose 文件的 ports 处修改冒号左边的数字即可（例如 - "10086:50086"）。

**Q：数据存在哪里？**A：就在你最开始创建的 docker/iptv/data 文件夹下，有一个 iptv.txt。你可以把它复制出来分享给朋友，但不要手动修改它，因为下次更新会被覆盖。

希望这个教程能帮飞牛 NAS 的用户们解决看电视难的问题。如果觉得好用，记得点个赞哦！🚀

目录CONTENT

全自动维护IPTV直播源！Docker一键部署，彻底告别失效源