🔄 MoonTVPlus 更新教程
部署方式：GitHub Actions → Cloudflare Workers（全程免费）
📌 两种更新方式
| 方式 | 适用场景 | 难度 |
|---|---|---|
| Sync Fork | 拉取上游（原作者）最新代码 + 重新部署 | 简单 |
| Pull Request | Sync Fork 按钮找不到时的替代方案 | 简单 |
✅ 推荐方式：优先使用
Sync fork，如果找不到按钮，用 Pull Request 替代。
🚀 方式一：使用 Sync Fork（推荐）
第 1 步：进入你的仓库主页
打开你 Fork 后的 MoonTVPlus 仓库：
https://github.com/你的用户名/MoonTVPlus第 2 步：找到「Sync fork」按钮
在仓库主页顶部操作栏，找到 「Sync fork」 按钮（通常在 Code 按钮的右侧附近）。
⚠️ 如果找不到：不要慌，往下看「方式二：使用 Pull Request」。
第 3 步：点击 Sync fork
- 点击 「Sync fork」
- 弹窗出现后，点击 「Update branch」（或「同步分支」）
- 等待同步完成（几秒钟）
📌 这一步做了什么：把原作者
mtvpls/MoonTVPlus 的最新代码拉取到你的仓库中。
🚀 方式二：使用 Pull Request（Sync Fork 找不到时）
第 1 步：进入 Pull requests 页面
在仓库顶部菜单，点击 「Pull requests」。
第 2 步：创建新的 Pull Request
- 点击绿色的 「New pull request」
-
配置对比分支：
- head repository：选择
你的用户名/MoonTVPlus，分支main - base repository：选择
mtvpls/MoonTVPlus，分支main
- head repository：选择
- 点击 「Create pull request」
- 点击 「Merge pull request」 → 确认合并
✅ 完成标志：页面显示 “Merged successfully”，代码同步完成。
⚙️ 第 3 步：触发重新部署（两种方式通用）
代码同步完成后，需要触发 GitHub Actions 重新构建并部署到 Cloudflare Workers。
操作步骤
- 在仓库顶部菜单，点击 「Actions」（操作）
- 在左侧 Workflows 列表中，点击 「Deploy to Cloudflare」
- 点击右侧的 「Run workflow」 按钮
- 弹窗中确认分支为
main，点击绿色的 「Run workflow」 - 等待 2~3 分钟，状态变为绿色 ✅ 即部署完成
⚠️ 常见问题：如果 Actions 页面没有
Deploy to Cloudflare 选项，说明 Fork 时 GitHub 默认禁用了 Actions。点击蓝色的 「I understand…」 按钮启用即可。
✅ 第 4 步：验证更新是否成功
方法一：登录后台查看版本号
- 访问你的 MoonTVPlus 站点：
https://你的域名.workers.dev - 登录后台，在界面中查看版本信息
- 版本号格式如
v223.2.0，确认与上游最新版本一致
方法二：查看 GitHub Actions 运行记录
- 进入仓库 「Actions」 页面
- 最新一次运行记录显示绿色的 ✅ 「成功」
- 点击进入可查看详细构建日志
🎉 更新成功！ 你可以在 「变更日志」（CHANGELOG）中查看本次更新的具体内容。
📋 完整更新流程图
┌─────────────────────────────────────────────────────────────┐
│ MoonTVPlus 更新流程 │
├─────────────────────────────────────────────────────────────┤
│ │
│ ① 同步代码 │
│ ├─ 方式A：点击 Sync fork → Update branch │
│ └─ 方式B：Pull Request → Create → Merge │
│ ↓ │
│ ② 触发部署 │
│ Actions → Deploy to Cloudflare → Run workflow │
│ ↓ │
│ ③ 等待构建 │
│ 约 2~3 分钟，状态从 🟡 变为 ✅ │
│ ↓ │
│ ④ 验证版本 │
│ 登录后台查看版本号，确认更新成功 │
│ │
└─────────────────────────────────────────────────────────────┘
📦 版本信息示例
以下是一次成功更新的版本信息展示：
📌 版本号：v223.2.0
📅 发布日期：2026-06-25
📝 状态：✅ 当前为最新版本
变更日志（示例）
- 新增：EdgeOne 部署支持
- 新增：Web TV 增加局域网遥控
- 新增：动漫磁力搜索增加 Nyaa 源
- 新增：下载增加 IndexedDB 模式
- 新增：下载内容导出功能
- 新增：自定义 X-Emby-Authorization
- 改进：UC 和夸克网盘自动续期机制
- 改进：优化预加载策略
⚠️ 常见问题与避坑指南
| 问题现象 | 原因与解决方法 |
|---|---|
| 找不到 Sync fork | 界面布局差异，改用 Pull Request 方式同步（见方式二）。 |
| Actions 被禁用 | Fork 时 GitHub 默认禁用 Actions，点击蓝色 「I understand…」 启用。 |
| 部署失败（红色叉号） | 查看日志定位原因。常见原因：CLOUDFLARE_API_TOKEN 权限不足或过期，重新创建 Token 并更新 GitHub Secret。 |
| 更新后页面空白 | 检查 NEXT_PUBLIC_STORAGE_TYPE 是否为 upstash，以及 Upstash 数据库是否正常。 |
| 登录后没有影片 | 更新不会影响影视源配置，检查 LunaTV 订阅源是否仍有效。如失效，重新添加。 |
📌 总结
核心链路：
同步代码（Sync fork / PR）→ 触发部署（Actions Run workflow）→ 等待构建 → 验证版本
同步代码（Sync fork / PR）→ 触发部署（Actions Run workflow）→ 等待构建 → 验证版本
- 频率：建议每隔 2~4 周检查一次上游是否有重要更新
- 风险：极低。整个流程只更新代码，不会影响你的数据（存储在 Upstash）
- 回滚：如果需要回滚，可以在 GitHub Actions 中找到历史部署记录，重新运行旧版本的工作流
评论（0）
暂无评论