把 Re Player 部署到 Cloudflare

01项目速览

Re Player 是一个链接型媒体库：它不直接挂载任何存储服务，而是把外部媒体链接登记为 虚拟目录，再由访客端播放器按需加载。所有页面与接口都由 Cloudflare Workers 上的 Astro 服务端渲染产出，数据写入 Cloudflare D1。

02部署方式怎么选

Re Player 应用本体运行在 Cloudflare Workers 上，差别只在于“你怎么把代码送到 Cloudflare”。

环境要求

• Node.js ≥ 22（Astro 7 要求）与 npm；
• 一个 Cloudflare 账号（免费套餐即可，Workers 与 D1 都有免费额度）；
• Git 集成方式需要一个 GitHub 账号（把仓库 Fork 到自己名下）；
• 命令行方式无需额外安装全局工具，npx wrangler 会直接使用项目内依赖。

03前期准备

1. 注册 Cloudflare 账号

   打开 dash.cloudflare.com 注册并登录。免费套餐已包含 Workers 与 D1 的可用额度，个人使用足够。

2. 安装 Node.js ≥ 22

   从 nodejs.org 下载安装包，装好后在终端确认版本。低于 22 会导致 Astro 7 构建失败。

3. 获取代码

   克隆仓库，或从 Releases 下载 ZIP 解压。使用 Git 集成方式时，先把仓库 Fork 到自己账号下再连接。

4. （可选）登录 Wrangler

   只有命令行发布方式需要。首次执行会在浏览器弹出授权页，同意即可。

# 1. 检查环境
node -v      # 需要 v22 或更高
npm -v

# 2. 获取源码
git clone https://github.com/lircia/RP-Re_Player.git
cd RP-Re_Player
npm install

# 3. 登录 Cloudflare（仅命令行发布方式需要）
npx wrangler login

04部署到 Cloudflare Workers

这是最省心的方式：把仓库连接到 Cloudflare，之后每次推送都会自动构建并发布， 还可以保留历史版本随时回滚。

1. Fork 仓库

   打开 github.com/lircia/RP-Re_Player， 点右上角「Fork」Fork 到自己账号下，方便后续自定义配置与提交改动。

2. 在 Cloudflare 创建 Workers 应用

   控制台左侧选择「计算和 AI」→「Workers 和 Pages」→「创建应用程序」→ 选择 「Workers」→「导入现有 Git 存储库 / Connect to Git」， 首次使用需按提示授权 Cloudflare 访问 GitHub。

3. 选择仓库与生产分支

   选中你 Fork 的仓库，生产分支保持默认的 main。

4. 检查构建与部署设置

   构建命令保持默认的 npm run build；部署命令需要显式指向适配器生成的配置文件 （见下方表格）。首次构建约 1–3 分钟。

5. 保存并部署

   完成后会得到 <项目名>.workers.dev 地址， 也可以在「设置 → 域和路由」里绑定自定义域。

6. 绑定 D1 后重新部署

   数据库绑定只对之后的部署生效，请先完成第 06 节，再点一次「重试部署」。

05命令行部署与本地预览

5.1 Wrangler CLI 本地发布

在本地克隆仓库后，一条命令就能完成构建与发布，适合习惯终端操作、希望完全掌控发布过程的人。

git clone https://github.com/lircia/RP-Re_Player.git
cd RP-Re_Player
npm install

# 构建并发布到 Cloudflare Workers
npm run cf:deploy

# 等价于：
# npm run build && wrangler deploy --config dist/server/wrangler.json

5.2 本地运行（可选）

想先在本机看效果，可以执行 npm run local（Windows 上双击 Local.cmd 亦可）。 默认在 127.0.0.1 上提供 HTTP 80 与 HTTPS 443 服务， 地址显示为 soers.de5.net，默认管理员密码为 masteradmin。

06创建并绑定 D1 数据库

D1 用来保存伪挂载信息、访客统计与设置。没有它 RP 也能运行（自动回退内存存储）， 但重启或重新部署后数据会丢失，因此正式使用请务必绑定。

1. 创建 D1 数据库

   控制台里选择「存储和数据库」→「D1 SQL 数据库」→「创建数据库」， 名称填 re-play（可自定义）；也可以在本地用命令行创建。

2. 复制 database_id

   进入数据库详情页，复制数据库 ID。

3. 写入项目配置

   把 ID 填进 wrangler.toml 后提交到你的仓库； 使用 Git 集成方式时，也可以在控制台的「设置 → 绑定」里直接添加 D1 绑定。 绑定名必须保持为 DB。

4. 重新部署

   绑定只在部署时生效，务必重新部署一次（Git 集成方式可点「重试部署」）。

5. 验证

   访问 /admin 或 /table，RP 会自动创建所需数据表并开始写入。

name = "rp"
compatibility_date = "2026-09-06"
keep_vars = true

[[d1_databases]]
binding = "DB"              # 必须是 DB，不要改名
database_name = "re-play"      # 你的 D1 数据库名称
database_id = "你的 D1 数据库 ID"

# 创建数据库（输出中会给出 database_id，填进 wrangler.toml）
npx wrangler d1 create re-play

# 查看已有数据库列表
npx wrangler d1 list

# 备份数据库（更新前建议执行）
npx wrangler d1 export re-play --remote --output backup.sql

RP 自动创建的数据表

07环境变量

在 Workers 项目的「设置 → 变量和机密」中添加，或在 wrangler.toml 的 [vars] 段里声明。所有变量在重新部署后生效。

[vars]
A  = ""                              # 访客页打开前显示的外部媒体地址
B  = "4.2"                           # A / C 的最大显示或播放时间（秒）
C  = ""                              # 与 A 同时播放的可选外部音频地址
N  = "Re Player"                     # 网站名称
P  = "masteradmin"                   # 管理员密码，生产环境请务必修改
US = "https://cloud.umami.is/script.js"
UI = ""
UH = ""
UD = ""

变量优先级

• keep_vars = true 会阻止 Wrangler 删除你在控制台里配置的变量， 因此控制台与 wrangler.toml 可以共存；
• D1 可用时，RP 会在 rp_settings 中为每个非空的已绑定短变量写入 env:变量名 键（仅在键尚不存在时写入），此后优先读取数据库中的值；
• 也就是说：在后台改过的值不会被重新部署覆盖；反过来，如果在环境变量里改了值却没生效， 请检查 rp_settings 里是否已经存了旧值。

08首次访问与后台

1. 打开站点

   访问 https://<项目名>.workers.dev（或你绑定的自定义域）。 会先看到入口动画，移动端会自动跳到 /Local。

2. 登录管理后台

   打开 /admin，用变量 P 设置的密码登录（默认 masteradmin）。

3. 挂载媒体

   在后台把外部视频 / 音频 / 图片链接登记为虚拟目录与文件；站点名称、主题等也在这里设置。

4. 查看统计

   访问 /table 查看访问、目录、媒体与播放事件。

09版本更新

1. 先备份数据库

   D1 里的数据是唯一无法重新生成的东西，升级前导出一次最稳妥。

2. 拉取最新代码

   命令行方式用 git pull；Git 集成方式推送代码或直接重新部署即可。

3. 更新依赖并重新发布

   执行 npm install 后重新构建部署。

4. 数据结构自动升级

   RP 会在启动时自动创建 / 升级数据表，无需手工执行 SQL。

# 1. 备份数据库
npx wrangler d1 export re-play --remote --output backup.sql

# 2. 拉取最新代码并更新依赖
git pull
npm install

# 3. 重新构建并发布
npm run cf:deploy

10常见问题

11附录

11.1 项目目录结构

RP-Re_Player
├── src/                        # 源码
│   ├── layouts/                # 页面布局
│   ├── lib/                    # 业务逻辑（伪挂载、字幕、歌词、主题等）
│   ├── pages/                  # 路由页面
│   │   ├── api/                # API 接口
│   │   │   ├── admin/          # 管理后台接口
│   │   │   └── public/         # 访客公开接口
│   │   ├── Local/              # 访客媒体库
│   │   └── tree/               # 原生播放器
│   ├── styles/                 # 全局与主题样式
│   └── types/                  # 类型定义
├── public/                     # 静态资源（字体、图标、海报）
├── scripts/                    # 构建与本地运行脚本
├── astro.config.mjs            # Astro 配置
├── wrangler.toml               # Cloudflare 配置
├── package.json                # 项目依赖
└── LICENSE                     # MIT 许可证

11.2 相关链接