Lazy loaded image
技术分享
📺MoonTV：免费在线观影神器，看片神器！支持Vercel、Cloudflare Pages、Docker等一键部署！
Words 1893Read Time≈ 5 min
2025-1-20
2025-8-7
type
status
date
slug
summary
tags
category
icon
password
每次想看个电影，要么翻墙去海外平台，要么在本地资源里大海捞针，老铁们是不是也跟我一样烦？前几天刷到一个Docker项目，直接让我眼前一亮——MoonTV。不夸张地说，它可能是目前最能让追剧党省心的影视聚合工具了，不仅支持多资源搜索、在线播放、收藏同步，连切片广告都能自动跳过，关键是部署起来超级简单，就连小白也能轻松上手。今天就带老铁们深度扒一扒这个神器。
🎬 MoonTV 是一个开箱即用的、跨平台的影视聚合播放器。它基于 Next.js 14 + Tailwind CSS + TypeScript 构建，支持多资源搜索、在线播放、收藏同步、播放记录、本地/云端存储，让你可以随时随地畅享海量免费影视内容。

项目简介

MoonTV是由社区开发者打造的跨平台影视聚合播放器，支持Web端、移动端及Android TV设备使用。项目采用Next.js 14作为前端框架，配合Tailwind CSS实现响应式布局，使用TypeScript提升代码可维护性。它的核心功能是通过聚合多个免费资源站点，为用户提供统一的观影入口，同时支持播放记录、收藏同步、智能去广告等实用功能。项目地址：https://github.com/senshinya/moontv
notion image

项目优势

多源聚合搜索，省去四处翻站的麻烦

MoonTV内置了数十个免费资源站点，用户只需输入关键词，就能立刻返回全站搜索结果。比如想找2023年的新片，系统会同时从多个站点抓取相关资源，避免了传统方式下“大海捞针”的尴尬。

流畅在线播放体验

不同于传统影视网站需要跳转到第三方页面，MoonTV直接集成ArtPlayer播放器与HLS.js技术，支持流畅的视频播放。无论是1080P还是4K蓝光资源，都能在浏览器中稳定加载，而且播放过程中还能自动跳过切片广告（实验性功能）。

响应式布局，适配所有屏幕尺寸

MoonTV的界面设计非常人性化，电脑端采用侧边栏布局，移动端则切换为底部导航栏，最大程度适应不同设备。而且PWA功能支持离线缓存，用户即使断网也能继续观影，还能直接安装到桌面或主屏，体验堪比原生应用。

云同步功能，跨设备追剧无压力

如果你用的是Docker部署方式，MoonTV还能支持Redis作为存储后端。这意味着你的收藏夹、播放记录和观看进度可以实时同步到多个设备。比如在手机上看到一半，直接到电视上继续看，完全不需要手动记录。

部署流程

支持 Vercel、Docker 和 Cloudflare 部署。

1、Vercel 部署

推荐使用，零运维成本，免费额度足够个人使用。
  1. Fork 本仓库到你的 GitHub 账户。
  1. 登陆 Vercel，点击 Add New → Project，选择 Fork 后的仓库。
  1. （强烈建议）设置 PASSWORD 环境变量。
  1. 保持默认设置完成首次部署。
  1. 如需自定义 config.json，请直接修改 Fork 后仓库中该文件。
  1. 每次 Push 到 main 分支将自动触发重新构建。
部署完成后即可通过分配的域名访问，也可以绑定自定义域名。

2、Cloudflare 部署

Cloudflare Pages 的环境变量尽量设置为密钥而非文本

普通部署（localstorage）

  1. Fork 本仓库到你的 GitHub 账户。
  1. 登陆 Cloudflare，点击 计算（Workers）-> Workers 和 Pages，点击创建
  1. 选择 Pages，导入现有的 Git 存储库，选择 Fork 后的仓库
  1. 构建命令填写
      2. 预设框架为无，构建输出目录为 .vercel/output/static
  1. 保持默认设置完成首次部署。进入设置，将兼容性标志设置为 nodejs_compat
  1. （强烈建议）首次部署完成后进入设置，新增 PASSWORD 密钥（变量和机密下），而后重试部署。
  1. 如需自定义 config.json，请直接修改 Fork 后仓库中该文件。
  1. 每次 Push 到 main 分支将自动触发重新构建。

D1 支持

  1. 点击 存储和数据库 -> D1 SQL 数据库，创建一个新的数据库，名称随意
  1. 进入刚创建的数据库，点击左上角的 Explore Data，将D1 初始化 中的内容粘贴到 Query 窗口后点击 Run All，等待运行完成
  1. 返回你的 pages 项目，进入 设置 -> 绑定，添加绑定 D1 数据库，选择你刚创建的数据库，变量名称填 DB
  1. 设置环境变量 NEXT_PUBLIC_STORAGE_TYPE，值为 d1；设置 USERNAME 和 PASSWORD 作为站长账号
  1. 重试部署

3、Docker 部署

适用于自建服务器 / NAS / 群晖等场景。

1. 直接运行（最简单）

访问 http://服务器 IP:3000 即可。（需自行到服务器控制台放通 3000 端口）

使用展示

如何搜索影视资源

部署完成后，老铁们可以在首页输入关键词进行搜索。比如输入“肖申克的救赎”，系统会自动从内置资源站点抓取相关视频资源，并展示片名、年份、简介、演员信息等。还能直接看到不同站点提供的观看链接，操作非常直观。

收藏与继续观看功能

如果你发现某部电影特别好，可以直接点击“收藏”按钮，之后就能在收藏夹里快速找到。支持Redis存储的小伙伴还能在不同设备间同步播放进度，比如在手机上看一半，切换到电视上还能继续观看。

多平台使用演示

MoonTV支持Web端、移动端和Android TV设备使用。移动端使用时，PWA功能让老铁们可以离线观看，安装到桌面上就像本地软件一样方便。Android TV用户则可以把它当作OrionTV的后端，实现更流畅的观影体验。

总结

MoonTV确实是一个非常实用的工具，尤其适合Docker爱好者和喜欢折腾技术的老铁们。它用极简的部署流程解决了传统影视聚合网站的痛点，无论是多源搜索、播放流媒体，还是跨平台同步，都能满足大部分需求。不过需要提醒的是，项目提供的资源均来自第三方网站，老铁们在使用时要注意遵守相关法律法规，避免造成不必要的麻烦。

项目地址和使用地址

上一篇
谷歌浏览器常用插件
下一篇
模板说明
Catalog