Folia 跨设备同步实操指南10 分钟让 AI 主题在多台设备上对齐【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-majorFolia 是一款主打歌词动画的本地音乐播放器接 Navidrome、网易云、QQ、酷狗都能用AI 生成的主题会跟着每首歌渲染出不同画面。但主题存在你自己设备上换台机器就得重新折腾一遍外观和样式——这篇文章就是带你从零跑通 Folia 跨设备同步搭一个私有的 sync-server 中转站读完你就能把一台设备上调好的 AI 主题和外观设置推到另一台。从生成密钥、部署服务到客户端配对一共四步。动手前 30 秒先看清楚边界同步内容只有两块其余一概不碰同步的外观设置快照可视化模式、背景透明度、字幕样式、歌词字体、首页布局两端按时间戳比新旧新赢旧同步的AI 主题库按指纹分桶做增量比对只传差量不碰的曲库、歌单、收藏数据始终留在你本地耗时部署加配对约 15 分钟技术路线Cloudflare Workers、Docker、Node 三种部署共用同一套路由与数据模型客户端零差别机制亮点一句话带过主题库按指纹分成 256 个 bucket每桶带摘要哈希两端先比摘要、发现哪个桶变了再拉内容几百首主题实际只传差量见 syncMerkle.ts协议契约集中在 syncTypes.ts。先把两样东西攥在手里部署前把密钥写好、存进密码管理器因为 Cloudflare 部署后 Token 加密不可回读密钥用途必填建议强度SYNC_TOKEN客户端拿它读写同步数据是8 位以上随机字符DASHBOARD_TOKEN打开隐藏的网页状态看板否16 位以上随机字符生成两条路终端跑openssl rand -hex 16或者浏览器按 F12 在控制台跑crypto.randomUUID()为什么不能偷懒服务端对SYNC_TOKEN态度很硬少于 8 位直接拒启防的就是字典爆破所以别用「12345678」这种。Token 明文只显示一次丢了没法回读只能重新部署注入新的——这一步别嫌麻烦。三条路按你的家底挑一条没有服务器走 A有 VPS/NAS 走 B家里有台常开机器走 C。先拿源码git clone https://gitcode.com/GitHub_Trending/fo/folia-major cd folia-major不掏服务器钱的路线Cloudflare Workers适合没有服务器、不想半夜爬起来重启的人跑在 Cloudflare 边缘网络全程零费用。要求本机 Node.js 24。cd sync-server bash ./install.sh菜单输3脚本自动串起创建 D1 数据库 → 生成wrangler.local.toml→ 让你输入SYNC_TOKEN→ 自动生成并注入DASHBOARD_TOKEN→ 发布。Windows 在 PowerShell 里跑.\install.ps1。完成后抄下两样东西Worker 域名和DASHBOARD_TOKEN后者只显示这一次生成的wrangler.local.toml带你的数据库 ID别提交进任何仓库。有 VPS 或 NASDocker 一条命令如果你手上有台机器愿意让 13000 端口就这条最省事。在sync-server/下建.env写入SYNC_TOKEN和可选的DASHBOARD_TOKEN回仓库根目录docker compose -f deploy/docker/compose.sync.yaml up -d --build服务监听宿主机13000端口SQLite 数据库落在sync-server/data/folia-sync.db备份时打包这个目录就行。家里有一台常开机器Node 自托管如果你只有一台 NAS 或家里服务器同样要求 Node.js 24底层是 better-sqlite3。在sync-server/下建.envSYNC_TOKEN可选PORT默认 3000、DB_PATH然后npm install npm run start:node数据库文件就落在本地目录位置由DB_PATH决定。配对只填两栏让设备连上打开 Folia 的设置 → 存储设置 → Sync Server这一节打开「启用同步服务」开关「Sync Server 地址」填根地址不带路径Cloudflare 域名或http://NAS-IP:13000都行「Bearer Token」填SYNC_TOKEN点保存点「测试」按钮变绿勾就是通了点「同步 AI 主题」手动跑一次之后每次启动 Folia 都会自动增量同步界面上能看到「上次同步」的时间。跑起来之后顺手做三件事状况怎么处理Token 忘了重新部署注入新的换新后记得同步改所有客户端测试连接不通三查地址是否根地址、Token 是否完整、端口是否暴露公网被扫描在 WAF/Nginx 层加频率限制除/health外全要鉴权泄露面不大另外两件值得做配过DASHBOARD_TOKEN的话浏览器访问你的域名/?token你的DASHBOARD_TOKEN能看主题数量和最近更新时间页面只读放心开同一界面还有「导出 zip / 导入 zip」整份主题库可以备份成文件甚至完全绕开服务端在两台电脑间迁移。到这里就通了电脑上刚调好的歌词动画手机解锁就是同款字体、背景、动画处处一致。 【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考