为什么自建音乐同步？

LX Music（洛雪音乐助手）是开源音乐播放器，但默认不能跨设备同步。自建同步服务后：

• ✅ 手机/电脑/平板歌单实时同步
• ✅ 收藏、播放历史云端保存
• ✅ 不依赖第三方服务，数据在自己手里
• ✅ 多设备无缝切换

技术方案

┌──────────────┐     ┌──────────────┐     ┌──────────────┐
│   手机 App   │     │  电脑客户端  │     │  网页版      │
└──────┬───────┘     └──────┬───────┘     └──────┬───────┘
       │                    │                    │
       └────────────────────┼────────────────────┘
                            ↓
                   LX Music 同步服务（:9527）
                            ↓
                   ┌────────────────┐
                   │   NAS 存储     │
                   │   歌曲文件     │
                   └────────────────┘

部署步骤

第一步：创建项目目录

mkdir -p ~/docker/lxmusic
cd ~/docker/lxmusic

第二步：编写 docker-compose.yml

services:
  lxmusic:
    image: lyswhut/lx-music-sync-server:latest
    container_name: lxmusic
    restart: unless-stopped
    ports:
      - "9527:9527"      # 同步服务端口
    volumes:
      - ./data:/data     # 数据持久化
    environment:
      - http_proxy=      # OrbStack 代理兼容
      - https_proxy=
      - ALL_PROXY=

第三步：启动容器

docker compose up -d

第四步：验证服务

curl http://localhost:9527
# 返回 LX Music 同步服务信息表示成功

客户端配置

手机端（Android/iOS）

1. 打开 LX Music App
2. 进入 设置 → 同步
3. 服务器地址填：http://你的NAS-IP:9527
4. 点击 连接
5. 输入自定义的同步密码

电脑端（Windows/macOS/Linux）

1. 打开 LX Music 桌面版
2. 进入 设置 → 同步
3. 服务器地址填：http://你的NAS-IP:9527
4. 点击 连接
5. 输入同步密码

网页版

1. 打开 LX Music 网页版
2. 设置中配置同步服务器地址
3. 使用相同密码连接

外网访问

方案一：Lucky 反向代理（推荐）

如果已配置 Lucky DDNS + 反向代理：