Folia 同步服务免费部署完全指南多端 AI 主题外观一致【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-majorFolia 是一款主打绚丽歌词动画效果的本地音乐播放器。本文带你免费部署它的官方 sync-server完成后同一账号下所有设备的 AI 主题与外观设置自动保持一致不用再逐台重调。先选定部署路线路线适合谁成本运维成本Cloudflare Workers没有服务器、想零成本省心免费免运维Docker有 VPS / NAS自有服务器硬件一条命令启动Node.js 自托管本地机器不方便跑容器自有服务器硬件自行守护进程需 Node.js 24三条路线共用同一套路由与数据模型Node 入口是sync-server/src/node.tsCloudflare 入口是sync-server/src/cloudflare.ts核心路由在sync-server/src/app.ts换路线不影响客户端行为。没有服务器就直接选 Cloudflare有服务器则按你更熟悉的工具选即可。路线一用一条脚本部署到 Cloudflare Workers推荐前提一个 Cloudflare 账号本机可用 Node.js 24 与 npm。第 1 步获取源码。git clone https://gitcode.com/GitHub_Trending/fo/folia-major cd folia-major/sync-server部署脚本就放在仓库的sync-server/子目录里。第 2 步运行脚本并在菜单里选 Cloudflare 流程。bash ./install.shWindows 上改用 PowerShell 执行.\install.ps1。菜单有三个选项1) Node (PM2)、2) Docker、3) Cloudflare Workers菜单定义见 sync-server/install.sh输入3走本路线。首次运行时 Wrangler 可能要求跳转浏览器登录 Cloudflare 授权属于正常现象。第 3 步按提示注入凭证并发布。脚本会自动创建 D1 数据库并生成wrangler.local.toml然后提示你输入SYNC_TOKEN粘贴提前生成的即可DASHBOARD_TOKEN会自动生成。脚本结束时输出 Worker 域名和DASHBOARD_TOKEN两者都是后文接入要用的凭证随手记下。⚠️ 生成的wrangler.local.toml内含你的数据库 ID只作为本地文件保留不要提交到仓库配置模板是 sync-server/wrangler.toml。路线二用 Docker 在你自己的服务器上部署第 1 步在sync-server/下创建.env文件写入SYNC_TOKEN你的Token DASHBOARD_TOKEN你的Token # 可选第 2 步回到仓库根目录构建并后台启动docker compose -f deploy/docker/compose.sync.yaml up -d --build该命令会构建镜像并拉起容器。服务监听宿主机13000端口容器内 3000SQLite 数据库持久化在sync-server/data/folia-sync.db。⚠️ 部署在远程机器上时确认13000端口真实暴露否则客户端永远连不上。若要部署含在线音乐的 Folia 完整 Web 栈改用deploy/docker/compose.yaml同步服务仍对外提供13000端口的/health健康检查。路线三用 Node.js 自托管第 1 步在sync-server/.env写入三项SYNC_TOKEN、PORT默认 3000、DB_PATH。第 2 步安装依赖并启动cd sync-server npm install npm run start:node两个注意点要求 Node.js 24数据库层是 better-sqlite3含原生绑定不想手动跑的话install.sh的选项 1 会自动装依赖并用 PM2 托管连日志轮转都配好了。通用准备生成两个 Token 并接入客户端先备好两个 TokenToken用途是否必填长度要求SYNC_TOKEN客户端鉴权Folia 靠它读写同步数据必填至少 8 位随机字符DASHBOARD_TOKEN访问隐藏的网页状态看板选填建议 16 位以上两种最快的生成方式按F12打开浏览器控制台运行crypto.randomUUID()Linux/macOS 终端则执行openssl rand -hex 16。服务端会强制SYNC_TOKEN长度不小于 8 位否则拒绝启动目的是挡掉字典爆破。⚠️ 生成后立刻把两个 Token 存入密码管理器。Cloudflare 部署中 Token 加密存储、无法回读DASHBOARD_TOKEN丢失只能重新部署注入新的SYNC_TOKEN忘记则必须重新生成并同步更新所有客户端的配置。客户端接入只需要两个字段打开设置 → 连接与集成找到「同步服务」区块打开启用开关在「Sync Server 地址」填入服务根地址你的 Cloudflare 域名或http://NAS-IP:13000不带路径后缀在「Bearer Token」填入SYNC_TOKEN点击保存点击测试出现绿色对勾即连通 ✅点同步 AI 主题立即跑一次同步此后每次启动 Folia 都会自动增量同步界面显示「上次同步」时间连通性验证「测试」按钮就是连通性检查服务端另提供/health端点Docker compose 的健康检查即用它。失败不必猜直接对照下文的速查表对号入座。功能原理速览同步数据怎么跑、怎么保安全增量差量只传变化主题按指纹分入 256 个 bucket两端只比对桶的摘要哈希几百首歌也只传差量部分实现见 src/services/sync/syncMerkle.ts时间戳仲裁互不覆盖批量写入按时间戳判断新旧只采纳更新的记录两端各改各的不会互相冲掉协议定义见 src/services/sync/syncTypes.ts只读状态看板部署时配置了DASHBOARD_TOKEN后访问你的域名/?token你的Token可看主题数量与最近更新时间页面无任何敏感交互zip 导入/导出同一界面提供「导出 zip / 导入 zip」能把整份同步库备份成文件、脱离服务端迁移到另一台电脑若同步已启用导入的内容也会推送到服务端常见问题速查按现象对号入座现象检查解法客户端「测试」失败地址是否为根地址不带路径后缀Token 是否完整Docker 是否暴露 13000 端口地址改为纯域名或http://IP:13000重新粘贴完整 Token核对端口映射看板打不开或提示鉴权失败部署时是否配置了DASHBOARD_TOKEN?token参数是否完整拼写用完整链接访问Token 丢失只能重新部署并注入新 Token公网部署出现大量异常访问边缘层WAF / Nginx是否配置了频率限制加上限流规则/health之外的接口全部要求鉴权泄露面有限想备份同步数据当前用的是哪种部署方式Docker 部署直接打包数据目录Cloudflare 部署定期用客户端「导出 zip」留底到这里跨设备同步就闭环了电脑上新生成一个 AI 主题手机上打开 Folia 就是同款外观歌词动画、字体、背景全部一致。想深挖协议细节完整说明在 sync-server/README.md客户端同步源码集中在src/services/sync/目录随时可以翻看。【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考