Folia sync-server 部署指南5 分钟跑通跨设备 AI 主题同步【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-majorFolia 是一款本地优先的音乐播放器招牌是华丽的歌词动画曲库除了本地文件夹还支持 Navidrome、网易云、QQ、酷狗等在线源。这篇文章只解决一件事电脑上把 AI 主题和外观调舒服了手机上不想再折腾一遍。仓库自带的 sync-server 就是干这个的它能把你设备之间的 AI 主题库和外观配置同步起来。读完这篇你会把同步服务部署上线并让客户端完成第一次完整同步。部署完成后是什么效果服务上线、客户端配对成功后两台设备共用同一个主题库电脑上新生成的 AI 主题切到手机打开就是同一套歌词动画和字体。背景图、透明度、字幕样式、首页布局这些视觉设置也会跟着对齐。之后每次启动 Folia 都会自动拉增量设置界面能看到「上次同步」的时间戳等不及自动同步时手动点一下「同步 AI 主题」立刻执行。同步到底在搬什么搬的东西分两类。第一类是外观设置快照两端各存一份时间戳谁的更新谁生效不存在互相覆盖。第二类是 AI 主题库每个主题按指纹分进 256 个 bucket——可以把它理解成按首字母归档的抽屉柜客户端先只拉每个桶的摘要哈希做比对哪个桶变了才去取桶里的内容几百首歌的主题实际也只传差量部分。协议字段定义在 src/services/sync/syncTypes.ts桶比对逻辑在 src/services/sync/syncMerkle.ts。先备好两把钥匙三条部署路线共用同一套路由和数据模型前置材料只有一份材料作用硬性要求备注SYNC_TOKEN客户端读写同步数据的凭证8 位以上随机字符串不够长服务端直接拒绝启动DASHBOARD_TOKEN隐藏状态看板的访问钥匙16 位以上选填不配就没有看板同步不受影响Node.js跑安装脚本 / 自托管版本 ≥ 24Cloudflare 和 Node 路线都要Docker容器路线能跑 compose仅 VPS/NAS 路线用密码管理器存两把 Token无丢了没法回读见下方警告浏览器按F12进控制台跑crypto.randomUUID()或者终端执行下面这条几秒出结果openssl rand -hex 16Cloudflare 部署后 Token 会被加密存储、明文永远无法回读丢了只能重新部署。务必先把两把 Token 存进密码管理器再开始部署动作。挑一条部署路线先拿到源码git clone https://gitcode.com/GitHub_Trending/fo/folia-major cd folia-major三条路线横向对比路线适合谁成本一句话结论Cloudflare Workers没有服务器、不想运维免费跑在边缘网络上零运维默认选择DockerVPS/NAS 且已装 Docker已有机器一个精简 compose 文件宿主机13000端口Node 自托管常开机器但不能装 Docker已有机器底层 better-sqlite3默认3000端口跑 Cloudflare 安装脚本适合手上没有服务器的人。进菜单输3脚本会依次创建 D1 数据库Cloudflare 托管的 SQLite、生成wrangler.local.toml、提示输入SYNC_TOKEN、自动生成DASHBOARD_TOKEN并发布上线cd sync-server bash ./install.shWindows 在 PowerShell 里执行.\install.ps1。全程只需两次输入但结束后输出的 Worker 域名和DASHBOARD_TOKEN明文只出现这一次立刻抄进密码管理器。另外脚本生成的wrangler.local.toml里含你的数据库 ID不要提交进任何仓库。一条命令起容器适合 VPS 和 NAS。先在sync-server/目录下新建.env写入SYNC_TOKEN选填DASHBOARD_TOKEN然后回仓库根目录构建启动docker compose -f deploy/docker/compose.sync.yaml up -d --build容器内监听3000映射到宿主机13000SQLite 数据库持久化在sync-server/data/folia-sync.db。要连同在线音乐后端整套部署才需要deploy/docker/compose.yaml单独同步场景用不着。起一个 Node 自托管服务适合家里那台常开但不能装 Docker 的机器同样要求 Node.js 24。在sync-server/下建.envSYNC_TOKEN必填PORT默认 3000、DB_PATH可选接着安装依赖并启动npm install npm run start:nodeSQLite 文件默认生成在sync-server/当前目录里需要常驻的话用 PM2 之类的工具管起来。填两个字段连通客户端服务跑起来后客户端侧的配置流程是打开设置 → 存储设置 → 同步服务一节把「启用同步服务」开关拨开「Sync Server 地址」填服务的根地址Cloudflare Worker 域名或http://NAS-IP:13000末尾不要带任何路径「Bearer Token」填SYNC_TOKEN点保存点「测试」提示成功即连通提示连接失败或凭证无效直接对照后面的排障表查点「同步 AI 主题」手动执行一次界面会汇报上传、下载的主题数和处理过的差异桶数——数字出现就说明整条链路通了部署后的可选项与排障几个可选操作隐藏看板配过DASHBOARD_TOKEN的话浏览器访问你的域名/?token你的DASHBOARD_TOKEN能看到主题数量和最近更新时间页面纯只读zip 备份与迁移同一设置界面里有「导出 zip / 导入 zip」整份主题库可以打包备份甚至绕开服务端在两台电脑间迁移若同步已启用导入内容会顺手推送到服务端数据库备份Docker 部署直接打包sync-server/data目录即可Cloudflare 方案建议定期用客户端导出留底排障速查现象处理Token 忘了明文只在部署当时显示一次丢了只能重新部署注入新的SYNC_TOKEN换新后记得把每台客户端的凭证同步改掉测试连接不通三查地址是否根地址别带路径、Token 是否完整、Docker 是否真的把13000暴露了出来服务暴露在公网在 WAF/Nginx 层加频率限制除/health外所有接口都要鉴权泄露面本身不大想继续深挖sync-server/README.md 有完整的 API 表和手动部署细节客户端的协调逻辑集中在 src/services/sync/ 目录。开头那 5 分钟的部署花掉后从此你在哪台设备上打开 Folia歌词动画、字体和背景都是同一副面孔不用重新调。【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
