绿联NAS 部署跨平台影视聚合播放器MoonTV

MoonTV 是什么？

🎬 MoonTV 是一个开箱即用的、跨平台的影视聚合播放器。它基于 Next.js 14 + Tailwind CSS + TypeScript 构建，支持多资源搜索、在线播放、收藏同步、播放记录、本地/云端存储，让你可以随时随地畅享海量免费影视内容。
贴几个系统截图：



✨ 特性

• 🔍 多源聚合搜索：内置数十个免费资源站点，一次搜索立刻返回全源结果。
• 📄 丰富详情页：支持剧集列表、演员、年份、简介等完整信息展示。
• ▶️ 流畅在线播放：集成 HLS.js & VidStack。
• ❤️ 收藏 + 继续观看：Docker 部署支持 Redis 存储，多端同步进度。
• 📱 PWA：离线缓存、安装到桌面/主屏，移动端原生体验。
• 🌗 响应式布局：桌面侧边栏 + 移动底部导航，自适应各种屏幕尺寸。
• 🚀 极简部署：一条 Docker 命令即可将完整服务跑起来，或免费部署到 Vercel。
• 👿 智能去广告：自动跳过视频中的切片广告（实验性）
  

🐳Docker
1、在文件管理器中创建文件夹，用来放Docker配置文件，这边作者放在共享文件夹中。

2、先将下载下来的 docker-compose.yml文件上传到创建的文件夹中（官方的代码编辑器有格式问题，直接下载省的编排出问题）。链接：https://pan.quark.cn/s/2bfac3e936a9

3、容器编排部署 docker-compose.yml文件，打开Docker应用，点击项目按钮，点击右上角创建

4、先点击存放路径的文件夹按钮，会提示：该路径已存在Compose配置，请重新选择路径或导入该配置。直接点击蓝色字

5、再创建你的Docker项目名称，并修改你的username跟password，确认Compose配置没有报错。注意：用户名密码不支持中文，不要带 ' '!!!!!

6、点击右下角立即部署。这样就是部署好了。

7、如果不知道自己的本地IP，点击控制面板，选择网络连接，查看LAN1的信息，作者这边是192.168.31.45，所以可以直接http://192.168.31.45:3000/ 进行访问。用户名密码就是配置文件中里设置的用户名密码。



PS：如果你有外面访问的需求，可以申请宽带的公网IPV6，并配置绿联的DDNS，或者使用Lucky，网上有很多教程，我这就不过介绍了。

                               
登录/注册后可看大图

2025.12.04更新内容，常见问题处理方法：
Q: Docker拉取不了镜像，卡住了怎么回事？
A: 1、需要添加Docker加速镜像，打开Docke - 镜像 - 右上角设置 - 新建
          常用镜像源：https://docker.1ms.run ； https://docker.milu.moe
     2、加速器配置
           点击原DockerHub后面的加速器配置，添加网址：https://docker.nastool.de 点击确定。
  

Q：镜像安装好后IP+3000端口访问不了，怎么回事？
A：1、先确认服务是否有异常，在项目 - 更多操作 - 控制台 -日志中查看
      2、服务没有问题，确认端口是否开放 控制面板 - 安全性 - 防火墙 ，如果打开了防火墙需要看一下是否端口被禁用
      3、确认自己的内网IP是否是正确的。


Q：安装好了以后为什么无法播放？
A:  Moontv 是空壳，需要配置视频源，点击自己的网站在后面追加/admin，比如我的访问地址是 http://192.168.31.45:3000/ 那就加上http://192.168.31.45:3000/admin，也可以点击右上角的头像点管理面板打开
   点击 配置文件 - 输入视频源地址: https://pz.v88.qzz.io/?format=2&source=jin18（这个建议自己找，网上有很多关键词："LunaTV-config",或者你懂点魔法可以访问：https://github.com/hafrey1/LunaTV-config）- 拉取配置 - 保存 就可以了。


PS: 不建议直接通过配置源的方式去配置，因为视频源太多，会导致请求视频源有效过多，导致点击播放时等待时间过长。我是通过第二种方式去手动输入视频源的。这个看个人。


这样基本就没有什么问题了，有什么常见问题我会持续更新的~

2026.01.23 更新
moontv已经停止维护，新版变更为moontvplus，增加弹幕等功能，需要的可以自行更新
作者地址：GitHub - mtvpls/MoonTVPlus: MoonTVPlus 是基于 MoonTV v100 二次开发的增强版影视聚合播放器。它在原版基础上新增了外部播放器支持、视频超分、弹幕系统、评论抓取等实用功能，提供更强大的观影体验。
优化整合直接用：https://pan.quark.cn/s/521e0c2cd33b
部署完成后，在站点管理里面添加弹幕API

我发现好多人不知道怎么设置镜像仓库... 看截图吧。
https://docker.1ms.run
https://docker.milu.moe

y6b3Cc 发表于 2026-2-4 12:40
楼主，可以分享一下视频源吗？

https://pz.v88.qzz.io/?format=2&source=jin18

- USERNAME=‘你的用户名’
- PASSWORD=‘登录密码’
不要加 ' '，就直接 = username 跟 =password

部署失败，提示这个什么意思？是要翻墙吗

茂茂阿丶 发表于 2025-11-30 21:35
- USERNAME=‘你的用户名’
- PASSWORD=‘登录密码’
不要加 ' '，就直接 = username 跟 =password ...

666

无法播放

并未能正确运行

Uq9FMd 发表于 2025-12-2 15:08
部署失败，提示这个什么意思？是要翻墙吗

docker要配置加速，你查一下吧

WN0ivp 发表于 2025-12-3 16:43
无法播放

要配置视频源的，你搜一下 “moontv视频源配置” 很好找的

Qirinstudio 发表于 2025-12-3 17:24
并未能正确运行

不能正确运行，你要贴一下报错信息，无非就是镜像下载不了，要么视频源没有