LX Sync Server 部署指南：轻松搭建自己的洛雪音乐服务

什么是 LX Sync Server？#

LX Sync Server 是 LX Music 的数据同步与 Web 播放中枢服务，它可以帮你搭建一个私有化的音乐云服务，实现多设备间的音乐数据同步，还能提供在线播放功能。

核心特性#

LX Sync Server 具有以下强大功能：

准备工作#

在开始部署之前，你需要确保你的设备满足以下条件：

1. 安装了 Docker（如果还没安装，可以搜索一下 Docker 安装教程，很简单的）
2. 确保 9527 端口没有被其他服务占用
3. 有足够的存储空间来存放音乐数据

部署方法#

1
docker run -d \
2
  -p 9527:9527 \
3
  -v $(pwd)/data:/server/data \
4
  -v $(pwd)/logs:/server/logs \
5
  --name lx-sync-server \
6
  --restart unless-stopped \
7
  ghcr.io/xcq0607/lxserver:latest

1
version: '3.8'
2
services:
3
  lxserver:
4
    image: ghcr.io/xcq0607/lxserver:latest
5
    container_name: lx-sync-server
6
    restart: unless-stopped
7
    ports:
8
      - "9527:9527"
9
    volumes:
10
      - ./data:/server/data
11
      - ./logs:/server/logs
12
    environment:
13
      - PORT=9527
14
      - FRONTEND_PASSWORD=123456
15
      - DISABLE_TELEMETRY=false

1
docker-compose up -d

重要说明：关于挂载卷#

在部署时，有两个挂载卷非常重要：

1. 数据卷：-v ./data:/server/data

   • 这个卷存储了所有的应用数据，包括用户信息、认证文件和音乐缓存
   • 一定要配置，否则容器重启后数据会丢失

2. 日志卷：-v ./logs:/server/logs

   • 这个卷存储了服务的日志文件
   • 方便查看服务运行状态和排查问题

验证部署是否成功#

部署完成后，打开浏览器访问 http://你的服务器IP:9527，你应该能看到 LX Sync Server 的登录页面。

默认用户名是 admin，密码是 FRONTEND_PASSWORD（默认 123456），登录后你就可以开始使用了。

访问 Web 播放界面#

除了管理界面，LX Sync Server 还提供了一个 Web 播放界面，你可以通过 http://你的服务器IP:9527/music 访问。

导入音源文件#

点击左边任务栏—设置—系统，我们要在这里添加音乐源，用过lxmusic的朋友都知道，目前这只是一个壳，加入了音乐源才有灵魂。 这里要输入管理员密码，输入后才能添加。 输入密码后选择你的音源添加就行。【没有音源的朋友可以直接公众号后台回复音乐获取,超多高质量音源】,添加好后就是这样。

管理后台操作指南#

部署完成后，你可以按照以下步骤使用管理后台：

1. 登录管理后台：访问 http://你的服务器IP:9527，默认用户名是 admin，密码是 FRONTEND_PASSWORD（默认 123456），请第一时间更改密码哦！！！

2. 初始化配置：首次登录请立即进入“系统配置”修改默认密码，确保服务器安全

3. 添加用户：在“用户管理”页面创建同步账号，生成的密码即为 LX Music 移动端/桌面端连接时使用的密钥

4. 配置备份策略：建议在“WebDAV 同步”中配置云端备份，双重保障数据安全

5. 管理数据：使用“数据管理”功能查看和管理所有用户的歌单和歌曲

6. 查看快照：在“快照管理”中查看自动生成的备份，必要时可以回滚数据

7. 查看日志：通过“系统日志”功能查看服务器运行状态，排查问题

总结#

通过 Docker 部署 LX Sync Server 非常简单，只需要几个步骤就能完成。部署完成后，你就拥有了一个私有化的音乐同步服务，可以在多设备间同步音乐数据，还能在线播放音乐。

如果你是 LX Music 的用户，或者想要搭建一个自己的音乐云服务，不妨试试 LX Sync Server，相信它会给你带来不错的体验！

项目地址#

• GitHub 仓库：https://github.com/XCQ0607/lxserver
• 官方文档：https://xcq0607.github.io/lxserver/guide/getting-started.html

互动时间#

你有没有使用过类似的音乐同步服务？部署 LX Sync Server 时遇到了什么问题？欢迎在评论区分享你的经验！

如果觉得这篇文章有用，别忘了点赞、在看并分享给身边的朋友～