一、项目简介
今天给大家分享一款功能超强的自托管模块化 IPTV 直播源管理系统，项目持续更新维护，目前最新版本为 v4.0.1，适配 Docker 一键部署，NAS 用户友好，新手也能零门槛搭建。
项目开源地址：https://github.com/akiralereal/iptv
视频教程:
☟性价比超高的云服务器支持试用☟
🔥 核心亮点：
内置咪咕高清直播源，涵盖央视、卫视、地方台、体育赛事，支持 HDR、H.265 高清编码
自带77个高清亚太频道，港澳台、国际频道全覆盖，画质稳定清晰
新增B站直播抓取模块，可自定义抓取赛事、网游等分区直播间，支持手动添加直播间地址
自带可视化后台管理页面，支持源管理、频道编排、EPG 节目单、多配置档、自定义直播源导入
支持 M3U/TXT 双格式订阅、兼容多播放器，换台速度快、稳定性拉满
⚠️ 重要提醒：部署全程无需登录咪咕账号、无需填写 Token，官方环境变量可直接留空，填写账号存在封号风险，普通游客模式即可满足日常高清观看需求。
二、部署前置准备
一台正常运行的飞牛 NAS（fnOS 系统）
NAS 已开启 Docker 容器功能（飞牛系统自带，无需额外安装）
设备与网络正常，无需魔法上网，国内环境可直接部署使用
三、飞牛NAS详细部署步骤
步骤1：新建项目目录
登录飞牛 NAS 管理后台，打开 Docker / Container Station，进入「项目」管理页面，手动新建一个专属目录，用于存放该 IPTV 项目的配置与持久化数据，方便后续管理与备份。
步骤2：新建Docker Compose项目
1. 点击「新建项目」，自定义填写项目名称（建议填写 iptv，方便识别）；
2. 选择上一步刚刚创建的专属目录作为项目存储路径；
3. 清空默认配置，粘贴下方带完整中文注释的完整版 docker-compose.yml 配置文件。
步骤3：完整可直接部署配置（带详细注释）
services:
iptv:
image: akiralereal/iptv:latest # 拉取项目最新版本镜像（v4.0.1）
container_name: iptv # 自定义容器名称
init: true # 启用init进程，回收Chromium僵尸进程，避免容器异常
ports:
- "1905:1905" # 端口映射，内外端口统一1905，固定无需修改
environment:
- muserId= # 咪咕账号ID【建议留空，填取有封号风险】
- mtoken= # 咪咕登录令牌【建议留空，不登录可正常高清观看】
- mport=1905 # 服务监听端口，与上方端口映射保持一致，固定不变
- mhost= # 外部公网访问地址，内网使用无需填写
- mrateType=3 # 默认画质：3=720P高清，2=480P标清，4/7/9为VIP蓝光/4K
- mpass= # 后台访问密码，无需密码可直接留空
- menableHDR=true # 开启HDR高清画质，提升画面质感
- menableH265=true # 开启H265原画编码，带宽占用更低、画质更好
- mupdateInterval=6 # 节目源、EPG节目单自动更新间隔（单位：小时）
# ----进阶内容开关（默认全部开启，新手无需修改）----
# - mblank=true # 空白模式总开关，开启后默认关闭所有内置源，适合纯自定义源用户
# - menableMigu=true # 咪咕源总开关（核心CCTV/卫视/赛事源）
# - menableBuiltInSources=true # 内置高清单频道源（纬来体育、4K卫视等）
# - menableBuiltInSubscriptions=true # 内置精选订阅源（港澳台、国际频道）
# - mdataDir=/migu/data # 容器数据持久化目录，默认无需修改
volumes:
- ./data:/migu/data # 数据持久化挂载，升级/重建容器不丢失配置、频道数据
restart: always # 容器异常退出、NAS重启后自动重启，保证服务常驻
步骤4：构建启动项目
1. 配置粘贴完成后，无需修改任何参数，保持默认即可；
2. 点击「确定」，系统自动拉取镜像、构建容器；
3. 等待构建完成，容器状态显示「运行中」即为部署成功。
四、后台管理页面使用教程
1. 进入后台面板
部署完成后，在浏览器输入地址：http://你的NASIP:1905/admin，即可进入可视化管理后台。
2. 基础频道查看
后台首页可查看全部频道列表，其中亚太分类内置77个高清频道，画质清晰、秒换台，无需额外配置即可直接使用。
同时页面可直接复制：M3U播放订阅地址、TXT播放地址、EPG节目单地址，适配各类播放器。
3. 源管理与B站直播配置（核心功能）
进入后台「🌐 源管理」页面，可自由添加自定义直播源、管理所有内置源与抓取模块，重点支持 B站直播抓取：
找到哔哩哔哩模块，开启开关，系统默认抓取赛事分区热门直播间；
自定义分类：可手动填写网游、单机、游戏、娱乐等B站分区，精准抓取对应分区热门直播；
手动添加直播间：支持直接复制B站直播间地址，每行填写一个，批量自定义抓取；
配置完成后点击「保存设置」，再点击「立即刷新」，返回频道列表即可看到新增的B站直播频道。
五、多播放器适配使用教程
该 IPTV 源适配主流电视、影音播放器，不同设备适配效果不同，实测适配方案如下：
1. Luna播放器（推荐）
打开Luna管理面板，进入直播源配置，自定义填写源名称，复制项目的M3U订阅地址和EPG节目单地址，点击添加即可导入使用，播放稳定、画质兼容好。
2. OK影视（最优适配）
完美适配该直播源，换台流畅、高清频道画质拉满，无卡顿、无花屏，日常观看首选。
3. TVBox系列播放器
原生适配效果一般，偶尔出现加载转圈、播放异常问题，建议开启后台「兼容版地址」（地址后缀携带 ?relay=1），可大幅优化播放稳定性，但整体体验不如OK影视、Luna。
六、使用体验总结
未登录咪咕账号游客模式：清晰度适中，换台速度极快，日常观看完全够用；
亚太内置频道全部为高清画质，稳定性极强，是核心优势；
B站直播自定义抓取灵活，可随心添加喜欢的直播间，拓展性极强；
后台可视化操作，零代码、零基础也能轻松管理频道、自定义源。
七、补充注意事项
严禁随意填写咪咕账号、Token，极易导致账号风控、封号，游客模式完全够用；
若播放出现「有声音无画面」，进入源管理关闭H.265/HDR编码即可解决（适配老旧设备）；
容器开启自动重启，NAS重启后服务自动恢复，无需手动操作；
所有配置持久化挂载，升级镜像、重建容器不会丢失自定义频道和设置。
本次部署教程全程零难度，飞牛NAS用户直接复制配置即可一键搭建，兼具咪咕高清卫视、亚太国际频道、B站直播三大核心功能，是目前性价比最高的自建IPTV方案！
评论区