tingfe/lx-music-sync-server repository overview

⁠LX Music 私有同步服务

这是 Tingfe 维护的 LX Music 私有同步服务端，为手机、桌面与车机提供同账号的数据同步和在线车机控制能力。

• Docker 镜像：tingfe/lx-music-sync-server⁠
• 客户端：lx-music-mobile⁠、lx-music-desktop⁠、lx-music-car⁠
• 当前服务端版本：v2.1.15

⁠本 Fork 的功能

• 同步歌单、收藏与不喜欢列表。
• 同步自定义音源的元信息和完整 JavaScript 脚本；同账号在线设备可实时收到更新。
• 同步跨平台语义一致的播放、搜索、歌词与列表偏好；语言、主题、路径、音频设备和窗口配置保持各终端本地独立，避免跨端错用。
• 支持同账号在线车机：手机可读取车机播放状态、切歌、播放/暂停，并将手机当前歌曲发送给车机。
• 保持旧客户端兼容：不认识的扩展同步 feature 会被跳过，原有同步不受影响。

v2.1.12 增加设置值校验，并修复车机短暂超时后无法再次发现的问题。手机端 v1.8.12 可区分操作失败与离线；现有车机端无需升级即可获得服务端恢复改进。

⁠Docker 部署与升级

极空间等 Docker 环境建议持久化挂载 /server/data：

services:
  lx-sync:
    image: tingfe/lx-music-sync-server:v2.1.15
    container_name: lx-music-sync-server
    restart: unless-stopped
    ports:
      - "9527:9527"
    volumes:
      - /你的数据目录/lx-music-sync:/server/data

升级时只需更新镜像并重建容器，不要删除宿主机的数据目录：

docker compose pull
docker compose up -d

服务端不提供浏览器管理后台；日常管理通过 Docker 管理页、容器日志、持久化数据目录和客户端同步设置完成。公网使用时必须经由可信 HTTPS 反向代理，并正确转发 WebSocket。

完整部署、迁移、数据恢复与兼容性说明见：升级说明⁠。

Docker Hub Overview 会在本 README 更新后单独自动同步；支持从 Actions 手动运行 Sync Docker Hub Overview。复用仓库 Secrets DOCKER_HUB_USER 与 DOCKER_HUB_TOKEN，不要填写明文账号密码到源码。若出现 403，需检查令牌是否有更新仓库描述所需权限；它与镜像构建相互独立。

⁠使用方式

1. 部署服务端并确保客户端可访问其地址。
2. 在手机、桌面或车机端的「设置 → 数据同步」填入同一服务地址、账号和连接码。
3. 先升级服务端，再升级客户端；首次接入时以服务端已有数据为准。

自定义音源是可执行 JavaScript，只应在你信任的设备、账号和私有服务之间同步。

⁠隐私保护

v2.1.15 包含隐私加固并修复 Docker 构建环境：日志脱敏、敏感文件忽略规则和发布前隐私回归检查均已接入。公网同步必须使用 HTTPS/WSS；已有旧日志不会自动清理。详情见：隐私与安全说明⁠。

⁠上游项目与许可证

本仓库基于 lyswhut/lx-music-sync-server⁠ 维护；上游的完整原始使用说明、Node.js/PM2 安装、Nginx 配置、快照恢复和环境变量清单请参阅其 README⁠。

本项目遵循仓库中的 Apache-2.0 License⁠ 及其适用说明。