前言

此前，我曾分享过洛雪音乐的各平台客户端版本。今天，要为大家推荐的是它的网页版。这项音乐服务不仅支持全平台客户端，还借助 Docker 容器化部署，让搭建流程更为简便。通过飞牛 NAS 或 VPS，我们就能轻松搭建一个专属的私有音乐服务，随时随地畅享高品质的音乐播放体验。

洛雪音乐网页版让你告别传统音乐播放器，带来流畅的用户体验，并支持本地音乐的管理与播放。无论在家、办公室，还是外出途中，只要有网络，你都能访问并享受自己的私有音乐库。本教程将一步步教你如何在飞牛 NAS 或 VPS 上利用 Docker 部署洛雪音乐网页版，助你打造一个高效、安全且个性化的音乐服务。

准备好了吗？我们立刻开始！

✨ Web 播放器核心特性

1. 现代化界面

采用清爽的现代 UI 设计，支持深色模式，带来极致的视觉享受。

2. 多源搜索

支持聚合搜索各大音乐平台的资源，想听什么就能搜到什么。

3. 内容与播放列表

支持多平台歌单的浏览、搜索与一键播放，提供直观的歌单详情面板，包含封面、作者、简介等完整信息。播放队列支持拖拽排序、批量管理及快速定位当前播放曲目。

4. 强大的播放控制

支持播放模式切换、音质选择、歌词显示、睡眠定时、播放速度调节等功能。

5. 缓存管理

内置全自动化缓存系统，可自动保存歌词、链接及歌曲文件，通过专门的缓存控制面板实现精细化管理，显著提升弱网环境下的播放流畅度。

6. 歌词卡片分享

新增歌词卡片分享功能，支持自定义卡片比例（竖版/横版/方版）、色彩风格（深色/浅色/专辑色）及歌词行数，一键生成精美海报，并支持旋转缩放。

7. 主题定制与系统功能

支持多套现代化主题（如森之韵、深海鲨、暖阳意、绯红月等），并可依据系统自动切换暗亮模式。系统设置支持自动更新网络歌单、账号设置自动备份及多维度代理配置，确保播放流畅稳定。

8. 自定义源管理

支持导入自定义源脚本，扩展更多音乐来源。

9.🔒 访问控制与安全

为保护你的隐私，Web 播放器支持设置访问密码。

10.支持多用户管理

部署方法

使用Docker安装

本教程采用 Docker 方式安装部署，简单便捷。

准备条件

1）一台服务器

我们以莱卡云VPS和飞牛NAS为例进行演示。

如需 VPS，可参考以下信息配置，资源占用情况如下：
莱卡云官网

本期 Docker 容器资源占用情况仅作参考，不到 50M。

2）本教程使用到的项目

本教程使用的官方 GitHub 地址：

🔒 下载链接仅对登录用户可见，请登录或注册后查看。

该项目基于 lyswhut 大佬的 lx-music-sync-server 项目：

🔒 下载链接仅对登录用户可见，请登录或注册后查看。

以及
lx-music-desktop 项目二次开发而成：

🔒 下载链接仅对登录用户可见，请登录或注册后查看。

3）API接口

本项目实质上是空壳软件，需要配置 API 接口才能使用。

🔒 下载链接仅对登录用户可见，请登录或注册后查看。

附上桌面版本的最新客户端：
有需要的可以自取：

🔒 下载链接仅对登录用户可见，请登录或注册后查看。

4）域名(可选)

根据个人需求决定。

① VPS部署

一、Docker环境部署

在 VPS 上安装 Docker 和 Docker-Compose：
Docker 官方安装文档（英文）：
https://duan.yyzq.eu.org/docker-001
Docker-Compose 官方安装文档（英文）：
https://duan.yyzq.eu.org/docker-002
Centos 安装 Docker 和 Docker-Compose（中文）：
https://duan.yyzq.eu.org//03
Ubuntu 安装 Docker 和 Docker-Compose（中文）：
https://duan.yyzq.eu.org//04

推荐直接使用一键脚本

docker安装脚本

bash <(curl -sSL https://cdn.jsdelivr.net/gh/SuperManito/LinuxMirrors@main/DockerInstallation.sh)

docker-compose安装脚本

curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose && chmod +x /usr/local/bin/docker-compose

二、部署命令

登录服务器，使用 root 账户执行以下步骤。

2.2docker-compose命令

mkdir  lxserver ;cd lxserver

然后新建 docker-compose.yml 文件：

vim docker-compose.yml

services:
  lx-sync-server:
    image: ghcr.io/xcq0607/lxserver:latest  # 镜像地址
    container_name: lx-sync-server  # 容器名称
    restart: always  # 容器崩溃后自动重启
    ports:
      - "9527:9527"  # 映射容器端口 9527 到主机端口 9527
    volumes:
      - ./data:/server/data  # 将本地的 data 目录挂载到容器的 /server/data 目录
      - ./logs:/server/logs  # 将本地的 logs 目录挂载到容器的 /server/logs 目录
    environment:
      - TZ=Asia/Shanghai  # 设置时区为上海
      - ENABLE_WEBPLAYER_AUTH=true  # 开启认证
      - WEBPLAYER_PASSWORD=yourpassword  # web播放器访问密码（请修改为实际密码）
      - FRONTEND_PASSWORD=yourfrontendpassword  # 设置Web管理界面访问密码（请修改为实际密码）

注意自定义修改密码。

三、执行容器运行命令

docker-compose up -d #运行容器

docker-compose ps  #查看是否启动成功

正常启动后显示如下：

docker-compose ps
NAME             IMAGE                             COMMAND           SERVICE          CREATED          STATUS          PORTS
lx-sync-server   ghcr.io/xcq0607/lxserver:latest   "node index.js"   lx-sync-server   18 minutes ago   Up 18 minutes   0.0.0.0:9527->9527/tcp, [::]:9527->9527/tcp