方案概述Docker Compose 部署 LX Server适用场景适合想在 NAS如飞牛 OS、群晖、云服务器或本地 Linux 环境中自建音乐同步服务的用户。它具备双核心功能一是作为数据同步服务端实现多端收藏与播放列表同步二是提供完整的 Web 音乐播放器。核心优势支持多平台音乐聚合搜索、智能缓存、WebSocket 实时通信并且容器化部署方便迁移和维护。 第一步准备工作创建目录结构在运行 Docker 命令前需要在宿主机上创建一个目录用于存放配置和数据方便后续管理和备份。建议位置Docker 数据目录例如飞牛 OS 的docker共享文件夹下或 Linux 的/opt/docker目录。创建文件夹新建一个名为lxserver的文件夹。目录结构预期如下/你的数据存储路径/lxserver/ ├── docker-compose.yml (稍后创建) ├── data/ (容器运行后自动生成用于存储数据库和用户数据) └── logs/ (容器运行后自动生成用于存储运行日志) 第二步编写 Docker Compose 文件进入lxserver文件夹创建docker-compose.yml文件并写入以下配置。操作建议推荐使用飞牛 OS 的 Docker-Compose 界面项目→新增→选择路径或通过 VS Code、FinalShell 等编辑器编辑该文件。代码内容version:3.8services:lx-sync-server:image:ghcr.io/xcq0607/lxserver:latest# 官方镜像源container_name:lx-sync-server# 容器名称restart:unless-stopped# 自动重启策略ports:-9527:9527# 端口映射宿主机:容器volumes:-./data:/server/data# 数据持久化映射 data 目录-./logs:/server/logs# 日志持久化映射 logs 目录⚙️ 第三步关键配置参数解析为了方便你后期自定义这里解释一下配置文件中各项参数的含义镜像源 (image)拉取最新的洛雪音乐服务端镜像。端口 (ports)默认监听9527端口。如果需要更改访问端口可以修改左侧的宿主机端口例如改成8080:9527。数据卷 (volumes)./data存储用户数据、歌单、数据库文件删除容器不会丢失这些数据。./logs存储运行日志遇到问题时可查看此目录排查。 第四步启动与访问保存文件后即可通过以下方式启动服务图形化界面推荐飞牛 OS 用户在 Docker-Compose 界面勾选“创建项目后立即启动”点击“创建”即可。命令行方式在lxserver目录下打开终端运行docker-compose up -d命令。验证部署查看日志运行docker-compose logs -f查看是否有报错。访问页面浏览器打开http://你的服务器IP地址:9527。如果能打开 Web 界面说明音乐播放器功能已正常运行。 后续建议反向代理与 HTTPS配置域名为了随时随地访问可以在路由器中设置端口转发或使用 Nginx、Caddy 将9527端口反向代理到你的域名上。开启 HTTPS若需开启 HTTPS请在反向代理层配置 SSL 证书洛雪音乐本身支持在反向代理后获取真实 IP配置X-Forwarded-For头即可。这样搭建完成后你就可以通过浏览器访问自己的私人音乐库并实现手机与电脑之间的歌单同步了。