大家好，欢迎来到我的博客 👋
这篇文章将带大家实操一个 GitHub 上很火的 IPTV 项目。我在自己的飞牛 NAS 上部署之后，体验效果非常不错，因此整理成教程分享给大家。

该项目支持 自动更新，并且兼容 TVBox 类播放软件，适合喜欢折腾的朋友。下面就来一步步演示。

演示视频

1. 前置准备

  • 一台已安装 飞牛（FeiNiu）系统 的 NAS
  • 已启用 Docker 与 Compose 插件
  • 可用的端口（避免和现有服务冲突）

2. 创建文件夹

在飞牛的 文件管理 中，为 IPTV 项目新建一个文件夹，例如 iptv，用来存放配置。

3. 创建 Compose 项目

打开 Docker → Compose，点击 新建项目：

  • 名称：填写 IPTV
  • 路径：选择刚刚创建的 iptv 文件夹
  • Compose 文件：在此处粘贴以下内容

👉 在这里插入 compose 文件代码

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
version: "3.8"

services:
  iptv-api:
    image: guovern/iptv-api:latest
    container_name: iptv-api
    restart: unless-stopped
    ports:
      - "9000:8000"
    volumes:
      - ./config:/iptv-api/config
      - ./output:/iptv-api/output
    environment:
      - APP_HOST=http://0.0.0.0
      - APP_PORT=8000
      - TZ=Asia/Shanghai         # 设置时区为北京时间
      - UPDATE_CRON=0 0 */2 * *  # 每两天凌晨 0 点执行更新

⚠️ 注意：请修改其中的 端口（避免冲突），以及 更新周期变量（默认是每两天的 0 点自动更新，你也可以根据需求调整）。

点击 确定 并启动构建。

4. 查看部署情况

部署完成后，可以在 容器日志 中查看运行情况。
首次启动时，它会拉取并更新频道列表，大约需要等待一小段时间。

5. 验证 IPTV 输出

部署完成后，在浏览器中访问：

1
2
3

http://你的服务器IP:端口/txt

如果能看到频道列表，说明 IPTV 已经运行成功 ✅。

6. 配合 TVBox 使用

在 TVBox 配置中，填入以下地址即可使用：

1
2
3

http://你的服务器IP:端口/m3u

设置完成后，你就可以在 TVBox 中播放 IPTV 频道啦 🎉。

总结

这就是在飞牛 NAS 上部署 IPTV 项目的完整步骤。
它不仅支持自动更新频道，还能无缝对接 TVBox，非常适合自建家庭娱乐系统的用户。

如果你在操作过程中遇到问题，可以在评论区留言，或者加入群组一起交流。

📌 如果你觉得本教程对你有帮助，欢迎 点赞 / 分享 / 收藏，也别忘了订阅关注！