别再到处找直播源了，一个 docker 让你看 800+ 频道

发表于 更新于 分类于 Waline： 阅读次数： 本文字数： 2.7k 阅读时长 ≈ 2 分钟
iPTV 是一个自托管的直播源管理与分发系统，开箱即有 800+ 频道，自带可视化后台。

简介

什么是 iPTV ？

iPTV 是一个开源的自托管 IPTV 直播源管理与分发系统，它开箱即有 800+ 个可稳定流畅播放的频道，聚合了央视频、咪咕、央视、卫视、凤凰卫视、亚太及国际、地方台、体育赛事，以及 B 站、斗鱼、虎牙等直播源，并支持自定义抓取源与订阅，同时提供 EPG 节目单与聚合功能。项目自带 GUI 可视化后台，支持 Docker 或 Node.js 运行，非常适合 NAS 与家庭服务器使用。

主要特点

  • 开箱即用：内置 800+ 个稳定频道，涵盖央视、卫视、地方台、体育及主流平台直播，无需手动搭建即可上手。
  • 可视化后台：自带 Web 管理界面，无需编写配置文件，通过鼠标即可完成频道分组、排序、重命名与批量管理。
  • 灵活源接入：支持网页提取、手动直链、第三方订阅源等多种方式添加内容，并能检测失效频道、动态调整多源优先级。
  • 多播放器适配：为飞牛影视、电视盒子（DIYP/百川）、苹果/安卓专业播放器（APTV/TiviMate）分别生成订阅地址，兼容性良好。
  • EPG 节目单：内置 EPG 源，并支持节目单聚合，提供 /playback.xml 节目单地址供播放器联播。
  • 配置迁移友好：支持一键导出 / 导入配置，配合数据目录可直接备份迁移整套设置。
  • 开源免费：基于 GPL-3.0 协议开源，可免费使用和修改。

应用场景

  • 家庭看电视：把 IPTV 部署在 NAS 上，家中的智能电视、电视盒子通过订阅地址即可观看 800+ 频道。
  • 多设备分配：通过后台「配置档」为不同设备生成专属订阅链接，全家各看各的，互不干扰。
  • 直播源管理：将散落的多平台直播源（B 站、虎牙、斗鱼、咪咕等）统一聚合，在一个后台集中管理与分发。
  • 体育赛事观看：内置体育与赛事频道，配合 EPG 节目单，不错过重要比赛。
  • 开发者测试：开发人员可以快速部署一套直播分发系统，用于测试播放器、订阅协议与 EPG 聚合。

iPTV 界面截图

总的来说，iPTV 是一个面向 NAS 与家庭服务器的开箱即用 IPTV 直播源聚合与分发平台，能让全家电视轻松接入 800+ 频道，同时提供了强大的可视化管理能力。

安装

在群晖上以 Docker 方式安装。

在注册表中搜索 akiralereal ，选择第一个 akiralereal/iptv，版本选择 latest。

本文写作时， latest 版本对应为 4.15.0；

docker cli 安装

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
# 新建文件夹 akiralereal 和 子目录
mkdir -p /volume1/docker/akiralereal/data

# 进入 akiralereal 目录
cd /volume1/docker/akiralereal

# 运行容器
docker run -d \
  --name=iptv \
  --restart=unless-stopped \
  --init \
  -p 1905:1905 \
  -v $(pwd)/data:/iptv/data \
  -e mport=1905 \
  akiralereal/iptv:latest
可变 值
mport 1905（容器监听端口，与端口映射对应）
mhost 可留空（外部访问地址，如 http://192.168.1.100:1905）
mpass 可留空（访问密码）

参数说明：--init 用于回收 Chromium 抓取频道时可能产生的僵尸进程，建议保留。

docker-compose 安装

将下面的内容保存为 docker-compose.yml 文件：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
services:
  iptv:
    image: akiralereal/iptv:latest
    container_name: ak-iptv
    restart: always
    init: true                    # 回收 Chromium 僵尸进程
    ports:
      - "1905:1905"
    environment:
      - mport=1905                # 容器监听端口，与 ports 对应
      # - mhost=                  # 可选：外部访问地址（如 http://192.168.1.100:1905）
      # - mpass=                  # 可选：访问密码，设置后访问 http://ip:port/密码/...
    volumes:
      - ./data:/iptv/data         # 数据持久化，不挂载则重建容器 / 升级镜像会丢配置

然后通过 SSH 登录到您的群晖，执行下面的命令：

1
2
3
4
5
6
7
8
9
10
# 新建文件夹 akiralereal 和 子目录
mkdir -p /volume1/docker/akiralereal/data

# 进入 akiralereal 目录
cd /volume1/docker/akiralereal

# 将 docker-compose.yml 放入当前目录

# 一键启动
docker-compose up -d

运行

在浏览器中访问 http://<群晖IP>:1905/admin 即可进入 Web 后台（若设置了密码则为 http://<群晖IP>:1905/<密码>/admin）

在「📺 我的频道」中进行分组、排序和隐藏设置。

进入后台「🌐 源管理」，按需启用 / 配置抓取模块、内置源与精选频道。

为不同设备（智能电视、电视盒子、手机播放器）复制对应的订阅地址。

常用访问地址：

用途 地址
M3U 播放列表 http://<群晖IP>:1905/interface.m3u 或者 http://<群晖IP>:1905/m3u
TXT 播放列表 http://<群晖IP>:1905/txt
EPG 节目单 http://<群晖IP>:1905/playback.xml

注意事项

  1. 数据持久化：务必挂载数据目录，否则升级镜像或重建容器会丢失全部配置
  2. H.265 兼容性：若播放器有声音无画面，多为 H.265 解码兼容问题，可在「🌐 源管理」启用「优先 H.264 」

  1. 老播放器 302 跳转：老播放器不支持 302 跳转会一直转圈，请在「📺 我的频道」复制带 ?relay=1 的兼容版地址。
  2. 安全建议：若对外开放访问，务必设置访问密码（mpass），同时注意本项目涉及 IPTV 直播源，请遵守版权与当地法律，仅限个人学习使用。

参考文档

akiralereal/iptv: 开箱即有 800+ 可稳定流畅播放频道的自托管 IPTV 直播源管理与分发系统
地址：https://github.com/akiralereal/iptv

akiralereal/iptv - Docker Hub 镜像
地址：https://hub.docker.com/r/akiralereal/iptv

iFansClub · Featured
地址：https://ifansclub.com/?lang=zh