使用 Cloudflare Pages 和 D1 数据库搭建你的 MoonTV

使用 Cloudflare Pages 和 D1 数据库搭建你的 MoonTV

前言

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

点击查看项目截图 项目截图 项目截图 项目截图

为什么选择 Cloudflare Pages + D1?

  • Cloudflare Pages: 免费、快速、全球CDN加速,非常适合部署静态网站。与 GitHub 集成,自动部署。
  • Cloudflare D1: Cloudflare 的无服务器(Serverless)SQLite 数据库,部署在边缘,低延迟,成本效益高。
  • 优势: 结合起来,你将拥有一个免费(或极低成本)、高性能、可全球访问的 MoonTV 实例,并且频道数据可以集中管理和更新。

准备工作

  1. Cloudflare 账号: 如果没有,请前往 Cloudflare 官网 注册并登录。
  2. GitHub 账号: 用于 Fork MoonTV 仓库并与 Cloudflare Pages 连接,Github官网
  3. Git 工具: 在本地进行代码克隆和修改。
  4. Node.js & npm/yarn: 如果需要在本地测试 Worker,或者未来对 MoonTV 进行二次开发。

部署步骤

整个部署过程分为三个主要部分:

普通部署(localstorage)创建cloudflareD1数据库给Moontv添加D1数据库支持

普通部署(localstorage)

  1. Fork 本仓库到你的 GitHub 账户。

  2. 登陆 Cloudflare,点击 计算(Workers)-> Workers 和 Pages,点击创建

  3. 选择 Pages,导入现有的 Git 存储库,选择 Fork 后的仓库

  4. 构建命令填写 pnpm install –frozen-lockfile && pnpm run pages:build,预设框架为无,构建输出目录.vercel/output/static

  5. 保持默认设置完成首次部署。进入设置,将兼容性标志设置为 nodejs_compat,无需选择,直接粘贴

  6. 首次部署完成后进入设置,新增 PASSWORD 密钥(变量和机密下),而后重试部署。

  7. 部署完成后即可通过分配的域名访问,也可以绑定自定义域名。

  8. 如需自定义 config.json,请直接修改 Fork 后仓库中该文件。

  9. 每次 Push 到 main 分支将自动触发重新构建。

D1 支持

  1. 完成普通部署并成功访问

  2. 点击 存储和数据库 -> D1 SQL 数据库,创建一个新的数据库,名称随意

  3. 进入刚创建的数据库,点击左上角的 Explore Data,将D1 初始化 中的内容粘贴到 Query 窗口后点击 Run All,等待运行完成

  4. 返回你的 pages 项目,进入 设置 -> 绑定,添加绑定 D1 数据库,选择你刚创建的数据库,变量名称填 DB

  5. 设置环境变量 NEXT_PUBLIC_STORAGE_TYPE,值为 d1;设置 USERNAME 和 PASSWORD 作为站长账号

  6. 重试部署

  7. 部署完成后即可访问输入自定义或系统分配的域名访问网站需要输入账号密码为正确

管理员配置

该特性目前仅支持通过非 localstorage 存储的部署方式使用

支持在运行时动态变更服务配置

设置环境变量 USERNAME 和 PASSWORD 即为站长用户,站长可设置用户为管理员

站长或管理员访问 /admin 即可进行管理员配置

AndroidTV 使用

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

暂时收藏夹与播放记录和网页端隔离,后续会支持同步用户数据

安全与隐私提醒

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

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

  • 避免公开访问:不设置密码的实例任何人都可以访问,可能被恶意利用
  • 防范版权风险:公开的视频搜索服务可能面临版权方的投诉举报
  • 保护个人隐私:设置密码可以限制访问范围,保护您的使用记录

部署要求

  1. 设置环境变量 PASSWORD:为您的实例设置一个强密码
  2. 仅供个人使用:请勿将您的实例链接公开分享或传播
  3. 遵守当地法律:请确保您的使用行为符合当地法律法规

重要声明

  • 本项目仅供学习和个人使用
  • 请勿将部署的实例用于商业用途或公开服务
  • 如因公开分享导致的任何法律问题,用户需自行承担责任
  • 项目开发者不对用户的使用行为承担任何法律责任