MoonTVPlus 是什么?

🎬 MoonTVPlus 是基于 MoonTV v100 二次开发的增强版影视聚合播放器。它在原版基础上新增了外部播放器支持、视频超分、弹幕系统、评论抓取等实用功能,提供更强大的观影体验。


功能特性

  • 🔍 多源聚合搜索:一次搜索立刻返回全源结果。

  • 📄 丰富详情页:支持剧集列表、演员、年份、简介等完整信息展示。

  • ▶️ 流畅在线播放:集成 HLS.js & ArtPlayer。

  • ❤️ 收藏 + 继续观看:支持 Kvrocks/Redis/Upstash 存储,多端同步进度。

  • 📱 PWA:离线缓存、安装到桌面/主屏,移动端原生体验。

  • 🌗 响应式布局:桌面侧边栏 + 移动底部导航,自适应各种屏幕尺寸。

  • 👿 智能去广告:自动跳过视频中的切片广告,更可以自定义你的去广告代码以增强去广告功能。

🎉 相对原版新增内容

  • 🎮 外部播放器跳转:支持 PotPlayer、VLC、MPV、MX Player、nPlayer、IINA 等多种外部播放器

  • 视频超分 (Anime4K):使用 WebGPU 技术实现实时视频画质增强(支持 1.5x/2x/3x/4x 超分)

  • 💬 弹幕系统:完整的弹幕搜索、匹配、加载功能,支持弹幕设置持久化、弹幕屏蔽

  • 📝 豆瓣评论抓取:自动抓取并展示豆瓣电影短评,支持分页加载

  • 🪒自定义去广告:你可以自定义你的去广告代码,实现更强力的去广告功能

  • 🎭 观影室:支持多人同步观影、实时聊天、语音通话等功能(实验性)。

  • 📥 M3U8完整下载:通过合并m3u8片段实现完整视频下载。

  • 💾 服务器离线下载:支持在服务器端下载视频文件,支持断点续传,提前下载到家秒加载 。


Docker

容器编排部署 docker-compose.yml文件:

services:
  moontv-core:
    image: ghcr.io/mtvpls/moontvplus:latest
    container_name: moontv-core
    restart: on-failure
    ports:
      - '3400:3000'
    environment:
      - USERNAME=admin
      - PASSWORD=moontv1234
      - NEXT_PUBLIC_STORAGE_TYPE=redis
      - REDIS_URL=redis://moontv-redis:6379
    networks:
      - moontv-network
    depends_on:
      - moontv-redis
  moontv-redis:
    image: redis:alpine
    container_name: moontv-redis
    restart: unless-stopped
    networks:
      - moontv-network
    volumes:
      - ./data:/data
networks:
  moontv-network:
    driver: bridge

使用的环境变量简单说明如下,更多的可以参考官方文档:https://github.com/mtvpls/MoonTVPlus#环境变量

环境变量

默认值

说明

USERNAME

站长账号,任意字符串,必填字段。

PASSWORD

站长密码,任意字符串,必填字段。

NEXT_PUBLIC_STORAGE_TYPE

redis

播放记录/收藏的存储方式,支持 redis、kvrocks、upstash。

REDIS_URL

Redis 连接 URL,格式为 redis://:,Redis存储方式必填字段。


部署

1. 在飞牛主页面找到 Docker 打开后,切换菜单 Compose -> 新增项目

0-VDdf

2. 创建项目页面根据实际情况定义 项目名称、选择 路径,并把上面 docker-compose.yml 文件内容复制填入 来源 文本框内容。检查无误后点击 确定 按钮进行部署。

ScreenShot_2025-12-15_120329_143-redacted_dot_app.png

3. 返回 Docker管理页面,在 容器 菜单,就可以看到运行情况,点击 moontv-core 右侧🔗可以直接打开 MoonTV

也可以直接在浏览器地址输入:http://<NAS地址>:3400,即可访问 MoonTVPlus 服务。


使用

输入账号和密码进入 MoonTVPlus 首页。

账号密码为部署时候的环境变量 USERNAMEPASSWORD

配置播放源

下载播放源文件到本地并导入。

在线播放


弹幕后端部署

要使用弹幕功能,需要额外部署弹幕 API 后端服务。

部署步骤

  1. 按照danmu_api教程部署后端

  2. 建议配置SOURCE_ORDER或PLATFORM_ORDER环境变量,默认弹幕源很少

  3. 在管理面板设置后端地址


超分功能说明

超分功能需要浏览器支持webgpu并且你的浏览器环境不能是http(如非要在http中使用,需要在浏览器端设置允许不安全的内容)


AndroidTV 使用

目前该项目可以配合 OrionTV 在 Android TV 上使用,可以直接作为 OrionTV 后端

已实现播放记录和网页端同步


TVBOX 订阅功能

本项目支持生成 TVBOX 格式的订阅链接,方便在 TVBOX 应用中使用。

配置步骤

  1. 在环境变量中设置以下配置:

    # 启用 TVBOX 订阅功能
    ENABLE_TVBOX_SUBSCRIBE=true
    # 设置订阅访问 Token(请使用强密码)
    TVBOX_SUBSCRIBE_TOKEN=your_secure_random_token
  2. 重启应用后,登录网站,点击用户菜单中的"订阅"按钮

  3. 复制生成的订阅链接到 TVBOX 应用中使用


安全与隐私提醒

请设置密码保护并关闭公网注册

为了您的安全和避免潜在的法律风险,我们要求在部署时强烈建议关闭公网注册

部署要求

  1. 设置环境变量 PASSWORD:为您的实例设置一个强密码

  2. 仅供个人使用:请勿将您的实例链接公开分享或传播

  3. 遵守当地法律:请确保您的使用行为符合当地法律法规

重要声明

  • 本项目仅供学习和个人使用

  • 请勿将部署的实例用于商业用途或公开服务

  • 如因公开分享导致的任何法律问题,用户需自行承担责任

  • 项目开发者不对用户的使用行为承担任何法律责任

  • 本项目不在中国大陆地区提供服务。如有该项目在向中国大陆地区提供服务,属个人行为。在该地区使用所产生的法律风险及责任,属于用户个人行为,与本项目无关,须自行承担全部责任。特此声明

由于开发者要求不能在 B站、小红书、微信公众号、抖音、今日头条或其他中国大陆社交平台发布视频或文章宣传本项目。因此本文只在我的博客发表,不会同步微信公众号。