Folia Sync-Server 完整部署指南10 分钟让 AI 主题多端同步【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-majorFolia 是一款本地优先的音乐播放器最出名的能力是歌词动画曲库除了本地文件夹还支持 Navidrome、网易云、QQ、酷狗等在线源。你在台式机上把外观、字体、AI 主题调得赏心悦目换到手机却要从头再来一遍——这就是 sync-server 要解决的痛点。它是 Folia 仓库自带的官方同步服务部署一次你自己的所有设备就共用同一套 AI 主题和外观配置。跟完这篇指南大约 10 分钟服务跑起来、客户端连上、第一次同步完成。第一步准备工作三条部署路线共用同一套路由和数据模型所以备料完全一样一次列齐材料作用要求备注SYNC_TOKEN客户端读写同步数据的凭证8 位以上随机字符必填不足 8 位服务直接拒绝启动DASHBOARD_TOKEN隐藏状态看板的钥匙16 位以上选填不配就没有看板同步不受影响Node.js跑安装脚本 / 自托管服务版本 24 以上Cloudflare 和 Node 路线都需要Docker容器路线专用能跑 compose仅 VPS/NAS 路线用到密码管理器存放两把 Token无见下方加粗警告生成 Token 只要几秒浏览器按F12打开控制台执行crypto.randomUUID()或者终端敲openssl rand -hex 16。Cloudflare 路线的 Token 部署后会被加密存储、无法再回读明文忘了只能重新部署。务必在部署动作之前把两把 Token 存进密码管理器而不是部署完再补。第二步把服务跑起来先拿源码。这条命令把 Folia 仓库克隆到本地第二行进入仓库目录git clone https://gitcode.com/GitHub_Trending/fo/folia-major cd folia-major按手头的机器选路线路线适合谁成本一句话结论Cloudflare Workers没有服务器、不想运维免费跑在边缘网络上零运维多数人默认选它Docker有 VPS/NAS 且装了 Docker用已有机器一个精简 compose 文件宿主机开13000端口Node 自托管常开机器但不装 Docker用已有机器底层 better-sqlite3SQLite 的 Node 绑定默认3000端口Cloudflare Workers默认推荐仓库自带安装脚本全程只需两次输入SYNC_TOKEN一次、选菜单一次。进入 sync-server 目录这条命令启动部署向导cd sync-server bash ./install.sh菜单输3Windows 在 PowerShell 里执行.\install.ps1脚本会依次建好 D1 数据库Cloudflare 托管的 SQLite→ 生成本地配置文件wrangler.local.toml→ 提示输入SYNC_TOKEN→ 自动生成DASHBOARD_TOKEN→ 发布上线。结束后输出的 Worker 域名和DASHBOARD_TOKEN是明文显示的最后一刻立刻抄进密码管理器。生成的wrangler.local.toml里含你的数据库 ID别提交进任何仓库它的用途只是让你下次重新部署时复用。Docker 容器在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 自托管同样要求 Node.js 24。在sync-server/下建.envSYNC_TOKEN必填PORT默认 3000DB_PATH可选。然后这两条命令依次装依赖并启动服务cd sync-server npm install npm run start:node服务起在3000端口SQLite 文件默认生成在同目录。机器常开的话建议用 PM2 这类进程管理器托管。第三步四步完成连通与验证打开 Folia 客户端进入设置 → 存储设置 → 同步服务一节只需要填两个字段打开「启用同步服务」开关「Sync Server 地址」填服务的根地址Cloudflare Worker 域名或http://NAS-IP:13000末尾不带任何路径「Bearer Token」填SYNC_TOKEN点保存点「测试」提示测试成功即连通提示连接失败或凭证无效对照文末排查表逐项查点「同步 AI 主题」手动执行一次界面会汇报上传数、下载数和处理的差异桶数判断标准第 4 步只要界面报出数字哪怕全是 0就说明客户端、网络、服务端、数据库这条链路全部走通。它到底在做什么同步的内容分两类。外观设置是一份快照两端各存一份时间戳谁新听谁的不会出现互相覆盖。AI 主题库走增量每个主题按指纹由内容算出的唯一标识分进 256 个 bucket——可以类比办公室文件柜的 256 个抽屉每个主题按编号躺进对应抽屉。每次同步客户端先只取每个抽屉的「清单哈希」做比对发现哪个抽屉内容变了才进去取新内容几百首歌的主题库网络上跑的只有变化那一小部分。桶比对的核心算法在 src/services/sync/syncMerkle.ts。服务上线之后隐藏看板部署时配了DASHBOARD_TOKEN的话浏览器访问你的域名/?token你的DASHBOARD_TOKEN能看到主题数量和最近更新时间。页面纯只读可以放心常开zip 备份与迁移同一设置界面有「导出 zip / 导入 zip」整份主题库可以打包成一个文件甚至完全绕开服务端在两台电脑之间迁移同步已启用时导入内容会顺手推到服务端。Docker 部署直接打包sync-server/data目录即可公网暴露在 WAF/Nginx 层加频率限制除/health外所有接口都要鉴权泄露面本身不大状况处理Token 忘了明文只在部署当时显示一次丢了只能重新部署注入新的SYNC_TOKEN换新后记得把每台客户端的凭证同步改掉测试连接不通三查地址是否根地址不带路径、Token 是否完整、Docker 是否真的暴露了13000服务暴露在公网WAF/Nginx 层加频率限制别让未鉴权接口裸奔服务跑通后任何设备启动 Folia 都会自动做增量同步设置界面能看到「上次同步」时间戳不想等就再点一次「同步 AI 主题」。完整 API 表和手动部署细节在 sync-server/README.md客户端的协调逻辑集中在 src/services/sync/ 目录。一次生成、处处一致——这就是这 10 分钟换来的东西。【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考