🎬 MoonTV 是一个开箱即用的、跨平台的影视聚合播放器。它基于 Next.js14 + Tailwind CSS + TypeScript 构建，支持多资源搜索、在线播放、收藏同步、播放记录、本地/云端存储，让你可以随时随地畅享海量免费影视内容。
支持多家资源站的聚合内容，拥有简洁的前端、自动适配的播放接口、移动端优化，适合部署在 Cloudflare Pages 上，无需服务器、数据库或中转后端，即可免费运行。
本教程将手把手教你在 Cloudflare Pages 上部署自己的 MoonTV，并介绍其特色功能如：深色模式、PWA、聚类搜索等。
🧰 在正式部署前，你需要准备以下内容：
| 项目 | 说明 |
|---|---|
| ✅ GitHub 账号 | 用于 Fork 项目并自动部署代码（https://github.com） |
| ✅ Cloudflare 账号 | 用于 Pages 免费部署和绑定自定义域名（https://dash.cloudflare.com） |
| 🌐 自定义域名（可选） | 如果你希望使用自己的域名，如 moontv.novel086.top，可提前注册好 |
一、MoonTV Cloudflare Pages 快速部署指南
1️⃣ Fork 项目
- 打开 MoonTV 仓库：https://github.com/senshinya/MoonTV
- 点击右上角
Fork，Fork 到你自己的 GitHub 账户
2️⃣ 创建 Cloudflare Pages 项目
- 登录 Cloudflare，进入「Workers & Pages」>
Pages - 点击
导入现有Git存储库，选择Connect to Git - 授权你的 GitHub 仓库，选择刚刚 Fork 的
MoonTV项目 - 填写构建信息：
| 项目 | 设置内容 |
|---|---|
| 框架预设 | 选择 无 |
| 构建命令 | pnpm install --frozen-lockfile && pnpm run pages:build |
| 构建输出目录 | 保持空白 或者.vercel/output/static |
3️⃣ 添加环境变量（推荐设置）
点击 Pages 项目 > 设置 > 变量和机密，添加以下变量：
| 名称 | 示例值 | 说明 |
|---|---|---|
PASSWORD | 123456 | 启用访问密码 |
SITE_NAME | Hans影视库 | 页面标题 |
ANNOUNCEMENT | 本站仅提供影视信息搜索服务 | 公告栏说明 |
NEXT_PUBLIC_STORAGE_TYPE | localstorage | 必须填写此项，否则出错 |
NEXT_PUBLIC_ENABLE_REGISTER | false | 静态部署不建议开启注册 |
NEXT_PUBLIC_SEARCH_MAX_PAGE | 10 | 搜索最大页数 |
NEXT_PUBLIC_AGGREGATE_SEARCH_RESULT | true | 聚合同名搜索结果 |
设置完成后，回到 Overview 页面，点击 重试部署 以使环境变量生效。
4️⃣绑定自定义域名（可选但推荐）
将你的站点绑定到自己的域名，如 moontv.novel086.top，更专业好记！
🔧 步骤如下：
- 打开 你的项目 → 点击「自定义域」
- 输入托管到CloudFlare域名」绑定即可
二、配置资源站接口（config.json）
打开你的仓库，修改根目录下的config.json文件，添加或替换资源站：
| { “cache_time”: 7200, “api_site”: { “ffzy”: { “api”: “http://ffzy5.tv/api.php/provide/vod”, “name”: “非凡影视” }, “zuid”: { “api”: “https://api.zuidapi.com/api.php/provide/vod”, “name”: “最大资源” }, “ikun”: { “api”: “https://ikunzyapi.com/api.php/provide/vod”, “name”: “iKun资源” } } } |
常用免费资源推荐：
| 名称 | 接口地址 |
|---|---|
| 极速资源 | https://jszyapi.com/api.php/provide/vod |
| 非凡影视 | http://ffzy5.tv/api.php/provide/vod |
| 魔爪资源 | https://mozhuazy.com/api.php/provide/vod |
| 卧龙资源 | https://wolongzyw.com/api.php/provide/vod |
| 最大资源 | https://api.zuidapi.com/api.php/provide/vod |
| 无尽资源 | https://api.wujinapi.me/api.php/provide/vod |
📌 Tips：
- 建议选择资源质量高、更新快、可访问性强的源
- 每次修改后直接
Commit到 main 分支，Cloudflare Pages 会自动构建更新
如果你喜欢本项目，欢迎：
- Star ⭐ 项目支持作者：MoonTV 仓库
- 分享给你的朋友
- 提出改进建议，共建更好开源项目！