lyswhut/lx-music-sync-server

LX Music Sync Server

镜像概述和主要用途

洛雪音乐数据同步服务端，源码地址：https://github.com/lyswhut/lx-music-sync-server
本服务用于洛雪音乐收藏列表数据同步，功能类似原PC端数据同步服务，现为独立部署版本，可部署在服务器上使用。
注意：服务本身不提供HTTPS协议支持，若部署在公网，需使用Nginx等服务做反向代理（SSL证书需可信且证书链完整），以实现客户端到服务器的HTTPS连接。

核心功能和特性

• 收藏列表数据同步：支持洛雪音乐客户端收藏列表数据的同步管理
• 灵活配置：通过环境变量或配置文件自定义服务参数
• 数据恢复：支持从快照文件恢复用户数据
• 代理支持：可通过Nginx等反向代理实现HTTPS访问和路径转发

使用场景和适用范围

• 需在服务器上独立部署洛雪音乐数据同步服务的用户
• 需要跨设备同步洛雪音乐收藏列表的场景
• 具备基础服务器操作经验的技术用户

使用方法和配置说明

Nginx反向代理配置

配置说明

代理需满足以下规则：

1. 代理URL根路径下所有子路径的WebSocket请求到LX Sync服务
2. 代理URL根路径下所有子路径的HTTP请求到LX Sync服务

配置示例

情况1：当前server块仅配置LX Sync服务

conf
server {
    # ...其他配置（如SSL证书等）
    location / {
        proxy_set_header X-Real-IP $remote_addr;  # 与config.js的proxy.header对应
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header Host $http_host;
        proxy_pass http://127.0.0.1:9527;  # 假设服务运行在本地9527端口
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection $connection_upgrade;
    }
}

情况2：当前server块存在其他服务（路径前缀转发）

conf
location /lx-sync/ {  # /lx-sync/为自定义路径前缀
    proxy_set_header X-Real-IP $remote_addr;  # 与config.js的proxy.header对应
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header Host $http_host;
    proxy_pass http://127.0.0.1:9527;  # 假设服务运行在本地9527端口
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection $connection_upgrade;
}

注意：$remote_addr的转发名称需与config.js中的proxy.header（或环境变量PROXY_HEADER）对应，并启用proxy.enabled，用于校验IP多次错误连接时的封禁。

从快照文件恢复数据

1. 停止同步服务
2. 编辑data/users/<用户名>/list/snapshotInfo.json，将latest字段修改为备份文件key名（即snapshot文件夹中文件名去掉snapshot_前缀后的部分）
3. 删除snapshotInfo.json中clients字段下的所有设备信息，修改后格式类似：{...其他内容,"clients":{}}
4. 启动同步服务，客户端连接后勾选“完全覆盖”，选择“远程覆盖本地”

环境变量配置

Docker部署示例

docker run命令

bash
docker run -d \
  --name lx-music-sync \
  -p 9527:9527 \
  -e BIND_IP=0.0.0.0 \
  -e PORT=9527 \
  -e LX_USER_admin='mypassword' \
  -v /path/to/data:/app/data \
  -v /path/to/logs:/app/logs \
  lyswhut/lx-music-sync-server

docker-compose配置

yaml
version: '3'
services:
  lx-music-sync:
    image: lyswhut/lx-music-sync-server
    container_name: lx-music-sync
    ports:
      - "9527:9527"
    environment:
      - BIND_IP=0.0.0.0
      - PORT=9527
      - LX_USER_admin='mypassword'
      - MAX_SNAPSHOT_NUM=20
    volumes:
      - /path/to/data:/app/data
      - /path/to/logs:/app/logs
    restart: unless-stopped