自建音乐服务器：LX Music 歌曲同步方案

Sat, 02 May 2026 00:00:00 +0000

为什么自建音乐同步？

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）

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

电脑端（Windows/macOS/Linux）

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

Lx-Music on Dick's Tech Notes

自建音乐服务器：LX Music 歌曲同步方案

为什么自建音乐同步？

技术方案

部署步骤

第一步：创建项目目录

第二步：编写 docker-compose.yml

第三步：启动容器

第四步：验证服务

客户端配置

手机端（Android/iOS）

电脑端（Windows/macOS/Linux）

网页版

外网访问

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