自建 IPTV 直播源教程

基于 iptv-aggregator 的 Docker 一键部署方案，自维护直播源，告别失效源。

本文为本地整理的教程，镜像与配置请以项目官方仓库为准：yiwanaishare/iptv-aggregator

准备工作

• 飞牛 NAS 已安装并启用 Docker 应用；

• 确认端口 50086 未被其它应用占用；

• 在 Docker 项目里使用的文件夹路径为 docker/iptv。

飞牛 Docker 部署步骤

1. 打开飞牛 NAS 的 Docker 应用。

2. 在左侧菜单打开 Compose。

3. 点击右上角 新建项目。

4. 项目路径填写 docker/iptv。

5. 在项目设置中点击 配置文件夹，创建数据文件夹 data。

6. 创建配置文件 docker-compose.yml，将下面内容完整复制粘贴进去：

services:
  aggregator:
    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

7. 确认配置无误后，点击 构建，等待镜像下载并自动启动容器。

8. 在 Compose 项目详情中确认容器 iptv-aggregator 状态为“运行中”。

使用方法

获取播放地址

启动后访问：http://NAS_IP:50086/iptv，将 NAS_IP 替换为你的设备地址即可得到 M3U 播放列表地址。

导入电视

• TiviMate：添加播放列表 → 输入上述地址；

• TVBox：在配置中添加直播源地址；

• Kodi：通过 PVR 或播放列表方式导入。

验证与说明

刚启动时需要爬虫扫描，等待 5-10 分钟。确认日志出现以下内容即正常：

Trigger spider collection...
Playlist generated

常见问题

内容根据网络公开教程整理，可能有更新变化，请以项目官方文档为准。