飞

飞牛NAS/Docker部署洛雪音乐网页版音乐服务器

Captain 杂类 2025-11-19

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

➡️支持播放模式切换、音质选择、歌词显示、睡眠定时、播放倍数等功能。
➡️内置全自动化缓存系统，可自动保存歌词、链接及歌曲文件，通过专门的缓存控制面板实现颗粒化管理，极大提升弱网环境下的播放流畅度。
➡️支持多套现代化主题（如森之韵、深海鲨、暖阳意、绯红月等），并可根据系统自动切换暗亮模式。系统设置支持自动更新网络歌单、账号设置自动备份及多维度代理配置，确保播放顺滑稳定。
➡️支持导入自定义源脚本，扩展更多音乐来源。
➡️支持多用户管理，保护你的隐私，Web 播放器支持开启访问密码。

以下使用飞牛NAS系统的Docker部署

点开飞牛NAS桌面Docker图标 -> Compose -> 在项目管理里点击右边的“+新增项目”按钮创建项目：
1.项目名称输入lx-music或其他自定义名称，字幕必须小写。
2.点开“选择路径”新建文件夹，如：lx-music-web
3.在下方“来源”里点击右边的“创建docker-compose.yml”
复制粘贴进以下代码：

services:
  lx-sync-server:
    image: ghcr.io/xcq0607/lxserver:latest  # 镜像地址
    container_name: lx-sync-server  # 容器名称
    restart: always  # 容器崩溃后自动重启
    ports:
      - "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  # yourpassword是web播放器访问密码（请修改为实际密码）
      - FRONTEND_PASSWORD=adminpassword  # adminpassword是Web管理界面访问密码（请修改为实际密码）

勾选"创建项目后立即启动"后点击“确认”完成部署。

最后一步：防火墙放行9527端口
系统设置 -> 安全性 -> 防火墙 -> 入站规则 -> 编辑：
“新增一条”规则放行9527端口

访问：
http://ip:9527

网页播放器：
http://ip:9527/music

本项目部署完成后需要配置API接口才可以使用，具体步骤：

设置 -> 自定义源管理 -> 管理/添加 -> 从url导入，导入后点击右边启用按钮：

SixYin ⭐⭐⭐

https://raw.githubusercontent.com/pdone/lx-music-source/main/sixyin/latest.js

Huibq ⭐⭐⭐

https://raw.githubusercontent.com/pdone/lx-music-source/main/huibq/latest.js

Flower ⭐⭐⭐

https://raw.githubusercontent.com/pdone/lx-music-source/main/flower/latest.js

ikun ⭐⭐⭐

https://raw.githubusercontent.com/pdone/lx-music-source/main/ikun/latest.js

Grass ⭐⭐⭐

https://raw.githubusercontent.com/pdone/lx-music-source/main/grass/latest.js

VPS部署
本项目支持从 Docker Hub 或 GitHub Packages 拉取镜像：
Docker Hub: xcq0607/lxserver:latest
GitHub Packages: ghcr.io/xcq0607/lxserver:latest

安装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

部署
Docker Run 安装示例：

docker run -d \
  -p 9527:9527 \
  -v $(pwd)/data:/server/data \
  -v $(pwd)/logs:/server/logs \
  -v $(pwd)/cache:/server/cache \
  --name lx-sync-server \
  --restart unless-stopped \
  xcq0607/lxserver:latest

Docker Compose 安装示例：

创建一个目录，并进入此目录

mkdir  lxserver && cd lxserver

新建docker-compose.yml文件

vim docker-compose.yml

复制上面所述飞牛NAS里创建的docker-compose.yml文件内容后保存

运行容器

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

放行端口9527后浏览器输入 http://ip:9527 进入主界面，输入密码进入后台管理界面添加音源API（参见上文）
浏览器输入 http://ip:9527/music 进入web播放器登录界面，输入密码后进入播放器。

DockerMusicfnOS