在 Cloudflare 平台上完整部署 GitHub 项目 MoonTV 实现免费追剧流程
🎬 MoonTV 是一个开箱即用的、跨平台的影视聚合播放器。它基于 Next.js 14 + Tailwind CSS + TypeScript 构建，支持多资源搜索、在线播放、收藏同步、播放记录、本地/云端存储，让你可以随时随地畅享海量免费影视内容。
仓库地址：https://github.com/senshinya/MoonTV
✨ 功能特性
- 🔍 多源聚合搜索：内置数十个免费资源站点，一次搜索立刻返回全源结果。
- 📄 丰富详情页：支持剧集列表、演员、年份、简介等完整信息展示。
- ▶️ 流畅在线播放：集成 HLS.js & ArtPlayer。
- ❤️ 收藏 + 继续观看：支持 Redis/D1 存储，多端同步进度。
- 📱 PWA：离线缓存、安装到桌面/主屏，移动端原生体验。
- 🌗 响应式布局：桌面侧边栏 + 移动底部导航，自适应各种屏幕尺寸。
- 🚀 极简部署：一条 Docker 命令即可将完整服务跑起来，或免费部署到 Vercel 和 Cloudflare。
- 👿 智能去广告：自动跳过视频中的切片广告（实验性）
1. Fork 仓库并同步主仓库
-
登录 GitHub 后访问 MoonTV 官方仓库 → 点击 Fork 到你的账号下。
-
若官方有更新，可在你 fork 的仓库页面使用 Sync fork 功能保持同步(GXNAS博客)。
2. 在 Cloudflare Pages 上创建部署项目
-
登录 Cloudflare 控制台 → 转至 Pages → Create project。
-
选择你 fork 后的 GitHub 仓库作为项目源。
-
设置构建命令为：
pnpm install --frozen-lockfile && pnpm run pages:build框架选择 “None”，构建输出目录设置为：
.vercel/output/static
- 首次部署成功后需要进入设置，将兼容性标志设置为
nodejs_compat，并新增 PASSWORD 密钥（变量和机密下），而后重试部署。
如果不设置密码，会有如下提醒，所以还是设置一下密码
4. 外网访问
根据以上步骤部署完成后就可以通过生成的免费域名反问了，不过这个域名很可能被墙。
5. 设置自定义域名实现国内访问
- 点击自定义域–>设置自定义域。
- 这里设置托管在Cloudflare上的域名，可以参考这里获取和托管域名：https://blog.csdn.net/loutengyuan/article/details/149096491?spm=1011.2415.3001.5331
- 设置好域名后点击激活域，几分钟后就可以访问了。
6. 可选：使用 Cloudflare D1 数据库实现跨设备数据同步
启用 D1 支持后，MoonTV 可以把播放记录、收藏等存储在数据库中，而非仅本地浏览器。
-
在 Cloudflare 控制台 -> Storage & Databases → D1，创建一个新数据库。
-
执行自由 ID 初始化脚本（通常在 README 或项目文件夹中的
D1初始化.md）来创建表结构和初始化数据(GitHub)。 -
添加环境变量：
NEXT_PUBLIC_STORAGE_TYPE = d1 USERNAME = <管理员用户名> PASSWORD = <管理员密码> -
重新部署完成后，即可访问
/admin页面管理用户，并开启注册功能或停用注册(GitHub, GXNAS博客)。
7. 后续维护与更新同步
- 在 GitHub 中开启
.github/workflows/sync.yml自动同步 upstream 更新。 - 使用 GitHub「Sync fork」功能手动同步主仓库。
- 每次同步后都需要重新构建部署。
- 可通过 config.json 自定义更多站点设置，例如公告、站点名称、搜索页数等变量(GitHub)。
小贴士 / 注意点
- 构建输出目录
.vercel/output/static即使用于 Cloudflare Pages 也不要修改。 - 构建命令需要使用 pnpm 环境；如你截图中使用 npm 或 yarn，也可以替换为对应命令。
- 若页面无法刷新内容，可能是 Cloudflare EdgeOne 与 MoonTV 不兼容的问题，建议优先采用 Pages +
nodejs_compat标志部署(GitHub, GitHub)。 - OrionTV 可作为电视端客户端使用，MoonTV 可作为其后端数据源功能，可后续扩展此支持(老E的博客)。
- 如果你截图中展示了 config.json 的具体字段（如 Douban 代理、搜索页数等），请将其直接加入 Fork 仓库后同步至云端部署。