洛雪音乐 Docker 版部署教程：支持自定义音源、多平台搜索与音乐下载
如果你平时有听歌和整理音乐库的需求，可能会遇到：
音源分散
下载不方便
本地音乐缺少封面和信息
这篇文章分享一个基于 洛雪音乐 的 Docker 项目，支持：
多平台音乐搜索
自定义音源
歌曲下载（单曲 / 批量）
本地音乐刮削（自动补全信息）
一、视频教程地址
👉 视频演示：
二、项目特点
这个项目在洛雪音乐基础上做了 Docker 化，主要功能包括：
🎵 多平台音乐搜索
🔗 自定义音源支持
⬇️ 支持歌曲下载（支持批量）
📁 自动整理下载目录
🖼 本地音乐刮削（封面 / 信息）
🌐 支持局域网 / 公网访问
适合：
NAS 用户
音乐爱好者
想搭建私有音乐库的人
三、部署环境说明
系统：飞牛（fnOS）
部署方式：Docker Compose
其他支持 Docker 的系统同样适用
四、创建项目目录
先创建一个目录，例如：
/lx-sync
用于存放：
配置文件
五、Docker Compose 部署步骤
1️⃣ 新建项目
进入 Docker：
打开 Compose
新增项目
填写项目名称
选择刚才创建的目录
粘贴 compose 文件
version: '3'
services:
lx-sync-server:
image: geelonn/lxserver:latest
container_name: lx-sync-server
restart: unless-stopped
ports:
- "8888:9527"
volumes:
# 配置文件和数据库，建议放在你的 Docker 配置目录下
- "/vol1/1000/docker/lx-sync/data:/server/data"
- "/vol1/1000/docker/lx-sync/logs:/server/logs"
- "/vol1/1000/docker/lx-sync/cache:/server/cache"
# 音乐存储相关：对应你提到的 media/music 目录
# 下载时临时存放的目录
- "/vol1/1000/media/music/downloads:/server/downloads"
# 最终自动归档和存放音乐的目录
- "/vol1/1000/media/music:/server/music"
environment:
- NODE_ENV=production
- ENABLE_LOCAL_DOWNLOAD=true
# 对应容器内部路径，程序会自动将 downloads 的内容归档到 music
- DOWNLOAD_PATH=/server/downloads
- MUSIC_PATH=/server/music
# --- 安全性建议 ---
# 如果你需要在公网访问，请取消下面两行的注释并修改密码
# - FRONTEND_PASSWORD=你的强密码
# - WEBPLAYER_PASSWORD=你的强密码2️⃣ 修改关键配置
✅ 端口设置
根据自己环境修改端口，例如：
8088 → 9527
确保端口未被占用。
✅ 本地路径映射
将音乐目录映射为你自己的路径，例如：
/你的音乐目录:/server/music
✅ 公网访问（可选）
如果需要公网访问：
设置访问密码
去掉配置中的
#注释
这样可以提高安全性。
3️⃣ 开始构建
确认配置无误后：
点击确定
开始构建容器
六、基础设置说明
部署完成后，打开页面：
1️⃣ 添加自定义音源
进入：
设置 → 自定义源管理
添加音源（文件可在文章或视频中提供）
启用音源
2️⃣ 个性化设置
在设置中可以调整：
界面颜色（显示设置）
搜索逻辑
下载规则
根据个人习惯调整即可。
七、音乐搜索与下载
进入搜索页面：
输入歌曲名称
在右侧选择搜索平台
支持：
单曲下载
批量下载
下载方式说明
浏览器下载 → 下载到本机
本地目录下载 → 下载到 NAS
下载完成后：
自动创建歌手目录
自动分类文件
八、歌单与收藏功能
歌单
支持搜索和导入分享歌单
可自建歌单管理音乐
收藏（需要登录）
登录方式：
进入设置页最下方 → 后台管理
在用户管理中查看账号密码
登录后即可使用收藏功能
九、本地音乐刮削
在【本地歌曲】中：
支持扫描本地音乐
自动补全：
歌曲信息
封面
元数据
适合整理已有音乐库。
十、整体体验总结
这个项目的优势在于：
功能全面（搜索 + 下载 + 管理）
支持自定义音源
可作为本地音乐库工具
支持 Docker 部署，适合 NAS
适合：
想搭建私人音乐库的用户
有 NAS 的用户
希望统一管理音乐资源的人
总结
通过 Docker 部署洛雪音乐项目，可以实现：
搜索 + 下载 + 本地管理 一体化音乐方案
如果你希望在 NAS 上搭建一个简单好用的音乐系统，这个项目值得尝试。
如果有问题欢迎留言或加入群组交流。
感谢你的阅读，我们下期再见。
评论区