前言#

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

截图#

功能特性#

• 多源聚合搜索：内置一个免费资源站点，一次搜索立即返回全源结果。

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

• 运行在线播放：集成 HLS.js & ArtPlayer。

• 收藏 + 观看继续：支持 Redis / D1 / Upstash 存储，多端同步进度。

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

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

• 极简安装：一条 Docker 命令即可将完整服务运行起来，或免费安装到 Vercel 和 Cloudflare。

• 智能去广告：自动跳过视频中的切片广告。（实验性）

项目地址：https://github.com/axingsvg/MoonTV

准备#

本教程以 Vercel 为例。

• 一个 GitHub 账号。

• 一个 Vercel 账号。

• 一个域名。

具体注册教程自行搜索即可，Vercel 和 GitHub 需要梯子。

部署#

前往项目地址并Fork。

打开 Vercel 导入项目。

可以看到 Vercel 已经自动匹配了 Next.js 框架。

在环境变量的 Key 里输入 PASSWORD，VALUE 则填写你想设置的密码，打开 MoonTV 需要此密码，然后点击 Deploy 部署项目。

部署完成后，点击 Add Domain 配置自定义域名，不然国内访问不了。

点击 Add Existing 添加自定义域名，然后点击 Save，根据提示配置 CNAME 记录。

域名解析完成后，国内网络可以访问了。

访问时输入密码进行登录，即可进入主页面，开始追剧之旅。