
Solara 是一个基于 Cloudflare Pages 和 Workers 的极简音乐播放器项目。要通过 Cloudflare (CF) 部署该项目,主要分为 代码部署 和 数据库配置 两个核心步骤。
项目地址:[链接登录后可见]
我构建的:[链接登录后可见]
以下是详细的部署指南:
1. 准备工作
2. 部署 Cloudflare Pages (代码部分)
登录 Cloudflare 控制台,点击左侧菜单栏的 Workers & Pages -> Create application -> Pages -> Connect to Git。
选择你刚才 Fork 的 Solara 仓库。
Build settings(构建设置)配置如下:
点击 Save and Deploy。初次部署完成后,你会得到一个 .pages.dev 的二级域名。
3. 配置 Cloudflare D1 数据库 (存储部分)
Solara 使用 Cloudflare D1 来存储播放列表和偏好设置,你需要手动创建并绑定数据库:
在 CF 面板进入 Workers & Pages -> D1。
点击 Create database,建议命名为 solara-db。
进入该数据库,在 Console 选项卡中,你需要执行初始化建表 SQL(通常在项目的文档或 functions/ 目录下的相关说明中可以找到对应的 Schema)。
4. 绑定数据库到 Pages
回到 Workers & Pages -> 你的 Solara 项目 -> Settings -> Functions。
滚动到 D1 database bindings 部分,点击 Add binding。
Variable name(变量名)必须填写为 DB(这是代码中引用的名称)。
D1 database 选择你刚才创建的 solara-db。
重新部署:回到 Deployments 页面,点击右侧的三个点选择 Retry deployment,让数据库绑定生效。
5. 环境变量与 API 代理 (可选)
如果项目需要代理特定的音乐 API 或封面取色功能:
部署完成后,访问你的 Pages 域名即可。由于项目集成了 Cloudflare Pages Functions,后端 API 逻辑会自动运行在边缘节点上。