Folia 跨设备同步完整教程【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major电脑上把 AI 主题和外观调了半宿换台设备一切照旧歌词动画、背景、字体全得从头再来。Folia 跨设备同步就是为了解决这件事——官方自带的 sync-server 负责在几台设备间搬运你的「外观设置 AI 主题」数据本文从部署服务到客户端接通带新手走完全程。走通之后长这样电脑上点一次「同步 AI 主题」手机打开 Folia 就是同款歌词动画、同款背景与字体。下面按三步推进先备好两把「钥匙」两条命令的事再把同步服务跑起来最后把客户端接通。1. 两条命令备好 Token做什么生成两个随机字符串一个给客户端认门一个给你自己查状态用。怎么做SYNC_TOKEN必填客户端靠它读写同步数据服务端强制要求长度 ≥ 8 位太短会直接拒绝启动DASHBOARD_TOKEN选填访问隐藏状态看板用建议 16 位以上成功标志终端里多了一串随机字符。openssl rand -hex 16这条命令会当场生成一串 32 位随机字符不想开终端的话按 F12 在浏览器控制台跑crypto.randomUUID()也行。⚠️ 请把两个 Token 存进密码管理器。Cloudflare 部署后 Token 会被加密、不可回读DASHBOARD_TOKEN部署时只显示一次丢失只能重新部署。2. 跑一个免费同步服务服务端提供三条路挑一条走通即可方案门槛适用人群上手成本Cloudflare WorkersCloudflare 账号 Node.js 24没有服务器、想免费免运维输入两次约 5 分钟Docker一台能跑 Docker 的机器有 VPS / NAS一条命令启动Node.js 自托管Node.js 24本地或家庭服务器建个.env 两条命令Cloudflare Workers 部署推荐做什么用安装脚本把服务发布到 Cloudflare 边缘网络全程只需输入两次。怎么做git clone https://gitcode.com/GitHub_Trending/fo/folia-major cd folia-major/sync-server bash ./install.sh这条命令把源码拉到本地并进入同步服务目录Windows 在 PowerShell 里改用.\install.ps1。菜单里输入3选 Workers首次运行若弹出浏览器登录授权属正常现象。之后脚本会自动创建 D1 数据库、生成wrangler.local.toml、把 Token 注入 Cloudflare 并发布。成功标志终端输出 Worker 域名和看板链接https://你的Worker域名/?tokenDASHBOARD_TOKEN此时DASHBOARD_TOKEN明文只显示这一次立刻存好。 生成的wrangler.local.toml里带着你的数据库 ID只在本地用别提交进仓库。Docker 部署有 VPS / NAS 选这条做什么单独起一个容器只跑同步服务一条命令完成。怎么做先在sync-server/目录新建.env文件写入SYNC_TOKEN和可选的DASHBOARD_TOKEN然后回到仓库根目录docker compose -f deploy/docker/compose.sync.yaml up -d --build这条命令会构建镜像并在后台启动 folia-sync 容器配置模板见 deploy/docker/compose.sync.yaml。成功标志容器状态 running宿主机13000端口可访问/health数据库文件落在sync-server/data/folia-sync.db重启不丢数据。Node.js 自托管本地机器选这条做什么不借助 Docker用 Node 直接在机器上跑。怎么做cd sync-server后创建.env内容SYNC_TOKEN、DASHBOARD_TOKEN、PORT3000、DB_PATH再执行npm install和npm run start:node。成功标志终端打印监听地址浏览器访问http://本机IP:3000/health有响应。3. 客户端三步接通做什么在 Folia 里把服务地址和 Token 告诉客户端。怎么做打开设置 → 存储设置 → Sync Server打开「启用同步服务」开关「Sync Server URL」填服务根地址——Cloudflare 的 Worker 域名或http://NAS-IP:13000地址不带路径、末尾不要斜杠「Bearer Token」填SYNC_TOKEN点Save点Test界面实现在 src/components/modal/settings/StorageSettingsSection.tsx。成功标志Test 按钮旁出现绿色对勾 ✅。红叉时按顺序排查地址是否根地址、Token 是否完整、Docker 是否暴露了13000端口。4. 同步一次看到效果做什么手动触发一次同步确认数据真的在两端流动。怎么做回到同一界面点「同步 AI 主题」立即做一次增量同步旁边还有「同步外观设置」按钮。之后每次启动 Folia 都会自动增量同步逻辑在 src/services/sync/syncCoordinator.ts。成功标志界面出现「上次同步」时间浏览器打开看板链接能看到主题数量与最近更新时间。同步走的是增量外观快照按时间戳比新旧旧数据不会压掉新数据主题库把每首歌的指纹分进 256 个 bucket见 src/services/sync/syncMerkle.ts两端只比对摘要哈希几百首歌也只传有变化的部分。同一界面的「导出 zip / 导入 zip」可把整份同步库备份成文件在两台电脑间迁移同步启用时导入的内容也会推回服务端。验收画面在设备 A 上生成或修改一个 AI 主题点一次同步设备 B 重启 Folia打开同一首歌——背景、字体、动画样式与 A 完全一致无需再碰任何设置。⚠️ Cloudflare 方案不方便直接下载数据文件建议隔段时间用「导出 zip」留一份底。最后留三条速查情况处理忘记 Token只能重新生成并同步更新服务端与客户端配置Test 一直红叉核对根地址、Token、Docker13000端口暴露服务挂在公网在 WAF 或 Nginx 加频率限制/health以外接口都要求鉴权想继续深挖协议与 API 清单见 sync-server/README.md客户端同步实现集中在 src/services/sync/。【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考