前言

分享过洛雪音乐的各个客户端版本，今天给大家带来一个网页版本的洛雪音乐。这款音乐服务不仅支持全平台客户端使用，还通过 Docker 容器化部署的方式，让搭建变得更加简便。借助飞牛 NAS 或 VPS，我们可以轻松搭建一个私有的音乐服务，随时随地享受高质量的音乐播放体验。

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

准备好了吗？我们马上开始！

✨ Web 播放器核心特性

1. 现代化界面

采用清爽的现代化 UI 设计，支持深色模式，提供极致的视觉体验。

2. 多源搜索

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

3. 内容与播放列表

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

4. 强大的播放控制

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

5. 缓存管理

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

6. 歌词卡片分享

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

7. 主题定制与系统功能

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

8. 自定义源管理

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

9.🔒 访问控制与安全

为了保护你的隐私，Web 播放器支持开启访问密码。

10.支持多用户管理

部署方法

使用Docker安装

本教程使用docker的方式安装部署,简单便捷
164b6ac419e23bc5390dc46601a202bf

准备条件

1）一台服务器

我们使用莱卡云VPS和飞牛NAS来演示

需要vps的可以看以下信息配置,可以参考以下资源占用情况
莱卡云官网

本期docker容器占用资源情况如下仅供参考不到50M

2）本教程使用到的项目

本教程使用的官方github地址
https://github.com/XCQ0607/lxserver
该项目是基于lyswhut大佬的lx-music-sync-server项目
https://github.com/lyswhut/lx-music-sync-server
以及
lx-music-desktop项目二次开发的
https://github.com/lyswhut/lx-music-desktop

3）API接口

本项目实际都是空壳软件需要配置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

四、web界面

打开web页面使用
成功以后需要打开自己相应的端口9527)防火墙就可以web端访问了

主界面

http://ip:9527

输入后台管理密码进入
这里点击进入web播放器

需要输入web播放器密码

首先添加6个音源
然后就可以使用了

其他功能自行研究

②飞牛云NAS部署

我们直接复制以上VPS的compose配置即可

启动成功

然后浏览器输入NAS的ip:9527端口就可以打开界面了
其他配置跟VPS上完全一样

绑定域名

VPS上的建议绑定下域名，方便管理。
绑定域名的教程参考以下内容

绑定域名视频教程

B站

YouTube

绑定域名可以参考
NginxProxyManager
https://duan.yyzq.eu.org//npm-ch

有任何问题可以直接留言或者问我
有任何问题可以直接留言或者问我
有任何问题可以直接留言或者问我

欢迎关注我们的微信公众号！

目录CONTENT

飞牛NAS/VPS使用Docker部署洛雪音乐网页版-一个私有音乐服务

前言