肥羊 AllInOne 停止维护后,很多人都在找替代方案。akiralereal/iptv 是目前最接近且更完整的选项——它是一个自托管的 IPTV 直播源管理与分发系统,开箱即有 800+ 频道,自带可视化后台,支持 Docker Compose 一键部署,实测空载内存仅约 64MiB,非常适合 NAS 和家庭服务器。

一、它到底是什么?

简单来说,akiralereal/iptv 是一个直播源“值班室”。它帮你把分散在各处的直播源(央视频、咪咕、B站、斗鱼、虎牙、地方台等)聚合起来,整理成一份干净的播放列表(M3U / TXT),再分发给你的播放器(TiviMate、APTV、Kodi、飞牛影视等)。

它不存储节目内容,而是在你家门口帮播放器“换票、补请求头”,让播放器能稳定访问那些公开可访问的地址。

核心能力概览:

功能 说明
开箱频道 809 个频道,54 个分组,含央视频 73 个、卫视、体育、iPanda、B站/虎牙/斗鱼、地方台等
源管理 内置 38 个抓取模块,覆盖咪咕、B站、斗鱼、虎牙等平台
可视化后台 网页管理,支持频道重命名、分组、隐藏、排序,无需编辑配置文件
多配置档 可为客厅、卧室分别创建独立频道列表,各自生成专属订阅链接
EPG 节目单 自动匹配节目单,支持输出 /playback.xml
多平台分发 M3U / TXT / 兼容版 / 全代理版,适配不同播放器
账号授权 扫码登录咪咕/B站,解锁高画质源,凭据只保存在自己部署中

二、部署准备

你只需要:

  • 一台支持 Docker 的设备(NAS / 软路由 / Linux 服务器均可)
  • 基本的 Docker Compose 操作能力
  • 5-10 分钟时间

重要提醒:这是自托管工具,整理的是公开可访问的地址。请仅在合法授权范围内使用,尊重版权。

三、Docker Compose 部署

1. 创建配置文件

新建文件夹 iptv,创建 docker-compose.yml:

services:
  iptv:
    image: akiralereal/iptv:latest
    container_name: iptv
    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         # 数据持久化,不挂载则升级镜像会丢配置
    restart: always

关键配置说明:

init: true(必须保留):项目内部使用 Chromium 进行页面抓取,这个参数用于回收僵尸进程,长时间运行不开会导致 NAS 性能逐渐下降。

./data:/iptv/data(建议保留):将数据目录映射到宿主机。不挂载的话,容器重建或镜像升级时你的频道配置、源设置、备份都会丢失。

mhost 和 mpass(可选):如果你的访问地址不是默认的 http://宿主机IP:1905,填入实际外部地址。设置密码后访问 Web 界面需要带上密码,格式为 http://IP:端口/密码/admin。

2. 启动服务

docker compose up -d

确认容器状态:

docker compose ps

看到 Up 即表示成功。

升级方法:docker compose pull && docker compose up -d

四、验证与使用

1. 打开管理后台

浏览器访问:

http://你的IP:1905/admin

(设置了密码则用 http://你的IP:1905/你的密码/admin)

进入后你会看到「我的频道」页面,顶部显示频道总数(约 809 个),左侧按分组排列:公告、央视频、体育、卫视、iPanda、B站、虎牙、斗鱼、各省地方台、景观等。

2. 播放地址一览

系统自动生成以下订阅地址,直接填入播放器即可:

用途 地址
M3U 播放列表 http://IP:1905/interface.m3u
TXT 播放列表 http://IP:1905/txt
EPG 节目单 http://IP:1905/playback.xml
管理后台 http://IP:1905/admin

3. 按设备选择地址

  • 飞牛影视 / 部分国产播放器:http://IP:1905/interface.m3u(必须带 .m3u 后缀)
  • 电视盒子(DIYP / 百川):http://IP:1905/txt
  • 专业播放器(TiviMate / APTV / Kodi):http://IP:1905/interface.m3u 或后台中带 ?relay=1 的兼容版地址

五、进阶配置

解锁高画质源(咪咕 / B站)

默认配置已能免费观看大量频道。如需 4K 体育或 B站原画,进入后台的 「🌐 源管理」,在咪咕或 B站模块卡片中扫码登录。凭据仅保存在你自己的部署中。

为不同设备定制频道列表

在「📺 我的频道」中,可以对频道进行重命名、分组、排序、隐藏。想为客厅和卧室分别定制?创建 配置档(Profile),每档独立保存隐藏和排序规则,各自生成专属订阅链接。

频道去重与批量管理

后台支持按名称长期屏蔽频道、一次隐藏整批同前缀分组,方便剔除不需要的内容。

六、常见问题速查

频道有列表但只有声音没画面 通常是 H.265 解码兼容性问题。进入「🌐 源管理」,关闭对应模块的「启用 H.265 原画」,保存后重试。

老电视盒子播放一直转圈 这类设备可能不支持 302 跳转。去「📺 我的频道」复制带 ?relay=1 的兼容版地址重新添加。视频流依然是直连的,不占 NAS 带宽。

数据备份与迁移 后台「设置 → 系统配置」提供一键导出/导入。或直接备份宿主机 ./data 目录(自定义台标在 logos/ 文件夹中,需单独拷贝)。