本文章没有找到对应的语言版本

项目简介

XCQ0607/lxserver 是 LX Music 同步服务端的增强版，在官方同步功能基础上新增了：

  • 🎵 Web 播放器 — 浏览器直接听歌，手机/电脑无需安装客户端
  • 🔍 多源聚合搜索 — 搜索各大音乐平台资源
  • 📋 歌单管理 — 多平台歌单浏览、搜索、一键播放
  • 🎤 歌词显示 + 卡片分享 — 支持歌词卡片生成和分享
  • 📡 Subsonic 协议 — 支持音流、Feishin 等第三方客户端连接
  • 💾 自动缓存系统 — 自动缓存歌词、链接及歌曲文件
  • 🎨 多主题 + 暗黑模式 — 森之韵、深海鲨、暖阳意、绯红月等

架构说明

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

┌──────────────┐  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐
│  LX Music    │  │  LX Music    │  │  Web 播放器  │  │ Subsonic     │
│  手机 App    │  │  桌面客户端  │  │  (浏览器)    │  │ 客户端       │
└──────┬───────┘  └──────┬───────┘  └──────┬───────┘  └──────┬───────┘
       │                 │                 │                 │
       └─────────────────┴─────────────────┴─────────────────┘
                            ↓
              LX Music Sync Server (xcq0607/lxserver)
                      端口 9527
                            ↓
              ┌──────────┬──────────┬──────────┐
              │  /data   │  /cache  │  /music  │
              │ 同步数据  │  缓存    │ 音乐文件  │
              └──────────┴──────────┴──────────┘

访问路径：

  • 管理后台：http://你的IP:9527/
  • Web 播放器：http://你的IP:9527/music

部署步骤

第一步：创建项目目录

1
2

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

第二步：编写 docker-compose.yml

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19

version: '3'
services:
  lx-sync-server:
    image: xcq0607/lxserver:latest
    container_name: lx-sync-server
    restart: unless-stopped
    ports:
      - "9527:9527"
    volumes:
      - ./data:/server/data
      - ./logs:/server/logs
      - ./cache:/server/cache
      - ./music:/server/music
    environment:
      - NODE_ENV=production
      - FRONTEND_PASSWORD=你的管理密码
      - ENABLE_WEBPLAYER_AUTH=true
      - WEBPLAYER_PASSWORD=你的播放器密码
      - LX_USER_你的用户名=你的同步密码

环境变量说明

变量说明默认值
FRONTEND_PASSWORD管理后台访问密码123456
ENABLE_WEBPLAYER_AUTH是否开启 Web 播放器密码保护false
WEBPLAYER_PASSWORDWeb 播放器访问密码123456
LX_USER_<用户名>同步用户及连接密码无
SERVER_NAME服务名称My Sync Server
MAX_SNAPSHOT_NUM最大快照备份数10
ADMIN_PATH管理后台路径（可自定义）/
PLAYER_PATHWeb 播放器路径/music
PROXY_HEADER反代获取真实 IP 的请求头无
DISABLE_TELEMETRY关闭匿名统计（关闭后无更新通知）false

更多环境变量见 项目文档。

第三步：启动容器

1

docker compose up -d

第四步：验证服务

1
2

curl http://localhost:9527
# 返回页面内容表示成功

客户端配置

LX Music 桌面端 / 手机端

  1. 打开 LX Music 客户端
  2. 进入 设置 → 同步
  3. 服务器地址填：http://你的IP:9527
  4. 点击 连接
  5. 输入 LX_USER_ 中设置的同步密码

Web 播放器

直接浏览器访问 http://你的IP:9527/music，输入 WEBPLAYER_PASSWORD 即可。

Subsonic 客户端（音流、Feishin 等）

Subsonic 协议默认开启，连接参数：

  • 服务器地址：http://你的IP:9527/rest
  • 用户名：LX Music 同步用户名
  • 密码：同步密码

外网访问

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

使用 Nginx / Caddy / Lucky 等反代工具：

Nginx 配置示例：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22

map $http_upgrade $connection_upgrade {
    default upgrade;
    '' close;
}

server {
    listen 443 ssl;
    server_name lx.你的域名.com;

    ssl_certificate     /path/to/cert.pem;
    ssl_certificate_key /path/to/key.pem;

    location / {
        proxy_set_header X-Real-IP $remote_addr;
        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;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection $connection_upgrade;
    }
}

⚠️ 反代时需设置 PROXY_HEADER=x-real-ip 环境变量，用于 IP 封禁防护。

Caddy 配置示例：

1
2
3

lx.你的域名.com {
    reverse_proxy localhost:9527
}

方案二：Tailscale / ZeroTier

不想暴露公网时，用组网工具：

  1. NAS 和客户端都安装 Tailscale
  2. 客户端用 Tailscale IP 访问：http://100.x.x.x:9527

数据管理

备份

1

cp -r ~/docker/lxmusic/data ~/backup/lxmusic-$(date +%Y%m%d)

迁移

1
2
3
4
5
6

cd ~/docker/lxmusic
docker compose down
scp -r ~/docker/lxmusic user@新机器:~/docker/
# 在新机器上
cd ~/docker/lxmusic
docker compose up -d

从快照恢复

  1. 停止服务
  2. 修改 data/users/<用户名>/list/snapshotInfo.json 中的 latest 为目标快照 key
  3. 清空 clients 字段：{"clients":{}}
  4. 启动服务，连接后选择「远程覆盖本地」

常用环境变量速查

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18

environment:
  # 基础
  - NODE_ENV=production
  - PORT=9527                          # 端口
  - SERVER_NAME=我的音乐服务器          # 服务名

  # 密码
  - FRONTEND_PASSWORD=管理密码          # 后台密码
  - ENABLE_WEBPLAYER_AUTH=true         # 开启播放器密码
  - WEBPLAYER_PASSWORD=播放器密码       # 播放器密码
  - LX_USER_myuser=同步密码            # 同步用户

  # 高级
  - MAX_SNAPSHOT_NUM=10                # 快照数量
  - DISABLE_TELEMETRY=true             # 关闭统计
  - PROXY_HEADER=x-real-ip            # 反代真实IP
  - ADMIN_PATH=/admin                  # 自定义后台路径
  - PLAYER_PATH=/music                 # 自定义播放器路径

注意事项

⚠️ HTTPS：公网部署务必通过反向代理启用 HTTPS，LX Music 客户端要求可信证书且证书链完整。

⚠️ 默认密码：FRONTEND_PASSWORD 默认为 123456，务必修改。

⚠️ OrbStack 用户：如使用 OrbStack 运行 Docker，需在 compose 中清空代理环境变量（http_proxy=、https_proxy=、ALL_PROXY=），否则容器可能无法正常启动。

⚠️ 数据安全：定期备份 data 目录，快照数据丢失无法恢复。

验证同步

  1. 在手机端添加一首歌到收藏
  2. 在电脑端或 Web 播放器检查收藏列表
  3. 应该实时同步出现

项目地址：https://github.com/XCQ0607/lxserver

说些什么吧！

giscus