5 分钟跑通 Folia sync-server 自托管Docker 与 Node 两条路线实测【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major换了新电脑Folia 里收藏的 AI 主题和歌词动画却留在了旧机器上——这就是 Folia sync-server 要解决的问题。它是官方提供的同步后端把视觉设置快照和 AI 生成主题在多端之间同步自托管把服务部署在自己的机器上支持 Docker 与 Node.js 两种路线5 分钟就能跑通。30 秒选路线对比项Docker 路线Node SQLite 路线适用场景VPS、NAS、已有服务器个人电脑、不便装 Docker 的轻量 VPS资源要求Docker EngineNode.js ≥ 24 npm一句话点评一次构建自动重启带内置健康检查最轻量表结构与 Docker 版完全同构随时互迁不想常驻服务器的话官方还提供 Cloudflare Workers D1 的 Serverless 路线免费且带一键脚本自动建库、注入 Secret本文不展开。动手前一行命令生成两个 Token无论走哪条路线先执行下面这行命令生成高强度随机串openssl rand -hex 16两类 Token 的用途如下Token用途是否必填建议长度SYNC_TOKEN客户端鉴权Folia 凭它读写同步数据必填8 ~ 32 位随机字符DASHBOARD_TOKEN浏览器隐藏看板防止被扫描选填16 位以上随机字符⚠️ 服务端强制要求SYNC_TOKEN长度 ≥ 8 位不达标会直接拒绝启动。Token 生成后只明文出现这一次请立即存入密码管理器。路线 ADocker 部署克隆仓库进入sync-server目录git clone https://gitcode.com/GitHub_Trending/fo/folia-major cd folia-major/sync-server创建.env文件填入两个 TokenSYNC_TOKEN你的随机字符串 DASHBOARD_TOKEN你的随机字符串回到仓库根目录执行构建并启动编排文件为deploy/docker/compose.sync.yamlcd .. docker compose -f deploy/docker/compose.sync.yaml up -d --build启动后核对三个关键点容器监听 3000映射到宿主机13000端口数据库持久化在sync-server/data/folia-sync.db重启不丢数据每 15 秒自动探测/health容器另启用read_only与no-new-privileges加固路线 BNode.js SQLite 部署先确认 Node 版本满足Node.js ≥ 24与package.json的 engines 声明一致node -v在sync-server目录创建.envSYNC_TOKEN你的SYNC_TOKEN DASHBOARD_TOKEN你的DASHBOARD_TOKEN PORT3000 DB_PATH./folia-sync.db安装依赖并启动存储层由better-sqlite3承担npm install npm run start:node 终端打印出 FOLIA SYNC SERVER Logo 即启动成功。长期挂机建议用 PM2 托管不想手动配置时执行官方安装向导install.shWindows 用install.ps1选 Node (PM2) 菜单会自动生成.env。客户端接入与 30 秒验收打开 Folia 客户端的存储设置填入两项workerBaseUrl服务根地址。Docker 路线填http://你的服务器IP:13000本机填http://127.0.0.1:3000Token之前生成的SYNC_TOKEN客户端通过Authorization: Bearer发送浏览器访问http://你的服务地址:13000/health返回含ok: true的 JSON 即通过——这是唯一免鉴权接口。服务同步三类内容视觉设置快照按时间戳读写旧时间戳不会覆盖新数据AI 主题按 256 个 bucket 做增量同步单批写入上限 500 条配置了看板 Token 后访问http://你的服务地址/?token你的DASHBOARD_TOKEN可只读查看主题数量与最近更新时间。常用端点一览方法路径用途GET/health连通性检查免鉴权GET / PUT/settings按时间戳读取/更新设置快照GET/themes/manifest256 个主题 bucket 摘要POST/themes/bucket按 bucket 拉取增量同步POST/themes/put批量写入主题单批 ≤ 500避坑清单忘记看板 Token重新生成DASHBOARD_TOKEN并重启即可但SYNC_TOKEN一旦重置所有设备的客户端配置都要同步更新。暴露公网安全吗建议在 Nginx 或 WAF 层配置频率限制防字典爆破只在内网设备间同步时别对外放端口最稳妥。想省掉服务器成本Cloudflare Workers D1 是官方推荐的免费 Serverless 替代仓库内置的脚本会自动创建数据库并注入 Secret。两条路线能互换吗能。同一套路由与表结构迁移时搬走 SQLite 数据库文件、复用同一组 Token 即可。写在最后一个 Token、一份小服务换机重装后主题与设置都能一键找回数据文件就躺在你自己的磁盘上。相关文件说明sync-server/README.md三种部署方案完整文档含 Cloudflaresync-server/src/app.tsHono 路由、鉴权与主题同步 APIsync-server/src/node.tsNode SQLite 启动入口deploy/docker/compose.sync.yamlDocker 独立编排文件src/services/sync/客户端同步协议实现【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
长河君 · 2026/10/21 1:37:15 · 阅读 1.2k 5 分钟跑通 Folia sync-server 自托管：Docker 与 Node 两条路线实测
5 分钟跑通 Folia sync-server 自托管Docker 与 Node 两条路线实测【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major换了新电脑Folia 里收藏的 AI 主题和歌词动画却留在了旧机器上——这就是 Folia sync-server 要解决的问题。它是官方提供的同步后端把视觉设置快照和 AI 生成主题在多端之间同步自托管把服务部署在自己的机器上支持 Docker 与 Node.js 两种路线5 分钟就能跑通。30 秒选路线对比项Docker 路线Node SQLite 路线适用场景VPS、NAS、已有服务器个人电脑、不便装 Docker 的轻量 VPS资源要求Docker EngineNode.js ≥ 24 npm一句话点评一次构建自动重启带内置健康检查最轻量表结构与 Docker 版完全同构随时互迁不想常驻服务器的话官方还提供 Cloudflare Workers D1 的 Serverless 路线免费且带一键脚本自动建库、注入 Secret本文不展开。动手前一行命令生成两个 Token无论走哪条路线先执行下面这行命令生成高强度随机串openssl rand -hex 16两类 Token 的用途如下Token用途是否必填建议长度SYNC_TOKEN客户端鉴权Folia 凭它读写同步数据必填8 ~ 32 位随机字符DASHBOARD_TOKEN浏览器隐藏看板防止被扫描选填16 位以上随机字符⚠️ 服务端强制要求SYNC_TOKEN长度 ≥ 8 位不达标会直接拒绝启动。Token 生成后只明文出现这一次请立即存入密码管理器。路线 ADocker 部署克隆仓库进入sync-server目录git clone https://gitcode.com/GitHub_Trending/fo/folia-major cd folia-major/sync-server创建.env文件填入两个 TokenSYNC_TOKEN你的随机字符串 DASHBOARD_TOKEN你的随机字符串回到仓库根目录执行构建并启动编排文件为deploy/docker/compose.sync.yamlcd .. docker compose -f deploy/docker/compose.sync.yaml up -d --build启动后核对三个关键点容器监听 3000映射到宿主机13000端口数据库持久化在sync-server/data/folia-sync.db重启不丢数据每 15 秒自动探测/health容器另启用read_only与no-new-privileges加固路线 BNode.js SQLite 部署先确认 Node 版本满足Node.js ≥ 24与package.json的 engines 声明一致node -v在sync-server目录创建.envSYNC_TOKEN你的SYNC_TOKEN DASHBOARD_TOKEN你的DASHBOARD_TOKEN PORT3000 DB_PATH./folia-sync.db安装依赖并启动存储层由better-sqlite3承担npm install npm run start:node 终端打印出 FOLIA SYNC SERVER Logo 即启动成功。长期挂机建议用 PM2 托管不想手动配置时执行官方安装向导install.shWindows 用install.ps1选 Node (PM2) 菜单会自动生成.env。客户端接入与 30 秒验收打开 Folia 客户端的存储设置填入两项workerBaseUrl服务根地址。Docker 路线填http://你的服务器IP:13000本机填http://127.0.0.1:3000Token之前生成的SYNC_TOKEN客户端通过Authorization: Bearer发送浏览器访问http://你的服务地址:13000/health返回含ok: true的 JSON 即通过——这是唯一免鉴权接口。服务同步三类内容视觉设置快照按时间戳读写旧时间戳不会覆盖新数据AI 主题按 256 个 bucket 做增量同步单批写入上限 500 条配置了看板 Token 后访问http://你的服务地址/?token你的DASHBOARD_TOKEN可只读查看主题数量与最近更新时间。常用端点一览方法路径用途GET/health连通性检查免鉴权GET / PUT/settings按时间戳读取/更新设置快照GET/themes/manifest256 个主题 bucket 摘要POST/themes/bucket按 bucket 拉取增量同步POST/themes/put批量写入主题单批 ≤ 500避坑清单忘记看板 Token重新生成DASHBOARD_TOKEN并重启即可但SYNC_TOKEN一旦重置所有设备的客户端配置都要同步更新。暴露公网安全吗建议在 Nginx 或 WAF 层配置频率限制防字典爆破只在内网设备间同步时别对外放端口最稳妥。想省掉服务器成本Cloudflare Workers D1 是官方推荐的免费 Serverless 替代仓库内置的脚本会自动创建数据库并注入 Secret。两条路线能互换吗能。同一套路由与表结构迁移时搬走 SQLite 数据库文件、复用同一组 Token 即可。写在最后一个 Token、一份小服务换机重装后主题与设置都能一键找回数据文件就躺在你自己的磁盘上。相关文件说明sync-server/README.md三种部署方案完整文档含 Cloudflaresync-server/src/app.tsHono 路由、鉴权与主题同步 APIsync-server/src/node.tsNode SQLite 启动入口deploy/docker/compose.sync.yamlDocker 独立编排文件src/services/sync/客户端同步协议实现【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考