Web 与部署 · 2026

Folia 歌词同步服务

给开源播放器 Folia 搭同步服务端，让歌词、播放进度与主题在多端之间保持一致；按上游的三种部署方式之一走了 Cloudflare 一键安装。

看同步流程上游仓库

项目地址：github.com/chthollyphile/folia-major

NOW SYNCING歌词 · 进度 · 主题

SYNC_TOKEN · 已连接

同一套服务端，多台设备之间保持一致；看板只看状态，不暴露给客户端。

背景

Folia 是开源的歌词动画播放器，支持本地文件、Navidrome 和多个在线音乐平台，歌词逐字动画和主题都在客户端渲染；同步服务端负责把歌词、进度和主题在多端之间对齐。

项目地址：github.com/chthollyphile/folia-major

Folia 分客户端和服务端：客户端播放，服务端同步歌词、进度和主题。上游提供三种部署：Cloudflare D1/Workers、Docker 一键、Node + SQLite。

选了 Cloudflare，不用自建数据库。安装脚本创建 D1、注入 secret、部署 Worker；客户端鉴权用 SYNC_TOKEN，看板另用 DASHBOARD_TOKEN，管理面不暴露给客户端。

选型
对比三种部署：Cloudflare 无需自建数据库、按量计费；Docker 与 Node + SQLite 适合自有服务器。最终选 Cloudflare D1 + Workers。
安装
脚本自动创建 D1 数据库、注入 Secret、部署 Worker；内置歌词代理、QQ 接口、逐段歌词、主题生成等路由。
鉴权
SYNC_TOKEN 必填（≥8 位）用于客户端鉴权；DASHBOARD_TOKEN 选填，用于状态与统计看板；两者分开，管理面不暴露给客户端。
校验
用同一套服务端连多台设备，歌词、进度、主题双向同步一致；看板可查看运行状态与统计。

基于 Folia 开源项目的同步服务端部署，客户端与上游保持一致。