洛雪音乐助手完整指南：下载、安装、歌单同步与使用技巧

洛雪音乐助手（lx-music）是目前最活跃的开源音乐播放器之一，内置搜索、歌单管理、歌词显示。

本文从零开始，手把手教你：下载 → 安装 → 数据同步 → 使用技巧。

一、下载

洛雪音乐助手支持 Windows、macOS、Linux、安卓四大平台。

官方下载地址

⚠️ 建议去 GitHub Releases 下载最新版，不要用第三方站点的打包，防止被植入恶意代码。

无法访问 GitHub？

如果你打不开 GitHub，可以尝试使用镜像站点访问。

二、安装

Windows 安装

1. 双击 lx-music-desktop-x.x.x-x64.Setup.exe
2. 选择安装路径（默认即可）
3. 等待安装完成，启动软件

便携版（免安装）：下载 .7z 或 .zip 后缀的压缩包 → 解压 → 运行 lx-music-desktop.exe

macOS 安装

1. 打开下载的 .dmg 文件
2. 将 洛雪音乐助手 拖入 Applications 文件夹
3. 首次打开如果提示”未识别的开发者”→ 进入 系统设置 → 隐私与安全性 → 点击”仍要打开”

Linux 安装

# 下载 .AppImage 后
chmod +x lx-music-desktop-x.x.x-x86_64.AppImage
./lx-music-desktop-x.x.x-x86_64.AppImage

安卓安装

1. 下载 .apk 文件
2. 点击安装（如果提示”未知来源”请确认）
3. 安装后即可打开使用

注意：洛雪音乐助手目前 没有 iOS 版本，iPhone 用户只能用 Listen1 或其他替代方案。

三、软件架构说明

洛雪音乐助手采用插件化音源架构设计。软件本身不存储任何音乐内容，而是通过音源（Source）模块与各平台对接。

• 音源（Source）：以 .js 文件形式存在，定义了搜索、播放、下载等接口
• 架构特点：音源与主程序解耦，可独立更新，用户可根据需要选择不同音源
• 社区维护：音源由开源社区维护，可通过项目官网获取最新版本

软件首次安装后默认不含音源文件，需单独下载音源 .js 文件并在设置中导入后方可使用。

四、手机与电脑数据同步

洛雪音乐自带数据同步功能（桌面版 v2.2.0+ / 移动版 v1.1.0+ 开始支持），可以把歌单、收藏等数据在电脑和手机之间实时同步。

4.1 同步模式说明

桌面版支持两种同步模式：

4.2 方案一：局域网同步（最常用、最简单）✅

适合：电脑和手机在同一个 Wi-Fi 下使用

电脑端设置（服务端模式）：

1. 打开电脑洛雪 → ⚙️ 设置 → 数据同步
2. 同步模式选择 「服务端模式」
3. 点击 “启用同步”
4. 电脑会显示一个同步服务地址（类似 http://192.168.x.x:23332）和连接码
5. ⚠️ 如果防火墙弹窗提示，记得点击允许
6. 同步端口保持默认 23332 即可，不要乱改

手机端设置（客户端模式）：

1. 打开手机洛雪 → ☰ 菜单 → 设置 → 数据同步
2. 在「同步服务地址」输入电脑上显示的地址，例如 http://192.168.1.5:23332
3. 输入完按一下回车键（让输入生效）
4. 点击 “启用同步”

首次同步：

• 如果电脑和手机两边的歌单都不为空，电脑端会弹出一个窗口，让你选择同步方式
• 这个弹窗仅针对首次同步，选一种即可
• 之后每次同步会自动根据两边数据合并，你可以在一边增删歌曲，另一边会自动同步

验证连接：

在手机上打开浏览器，输入 http://x.x.x.x:23332/hello（将 x.x.x.x 换成电脑显示的地址），如果能显示 Hello~::^-^::~v3~ 就说明连接成功。

⚠️ 注意：同步数据传输是明文，请在受信任的网络（自家Wi-Fi）下使用！

4.3 方案二：远程同步（通过独立同步服务器）

适合：电脑和手机不在同一个网络、想随时随地同步

洛雪官方提供了一个独立的数据同步服务（lx-music-sync-server），可以部署到云服务器上，实现跨互联网同步。

项目地址： https://github.com/lyswhut/lx-music-sync-server

部署方式（Docker 一键部署）：

# 在云服务器上执行
docker run -d \
  --name lx-music-sync \
  -p 23332:23332 \
  lyswhut/lx-music-sync-server

部署后，电脑和手机都设置为客户端模式，同步服务地址填你的服务器地址： – 无 SSL：http://你的服务器IP:23332 – 有 SSL（推荐）：https://你的域名/lxsync – 如果用了 80/443 端口可以省略端口号

4.4 方案三：使用 WebDAV 同步（备选）

除了内置同步，洛雪也支持 WebDAV 同步作为备选方案。

你需要： 一个 WebDAV 服务（推荐坚果云）

WebDAV 服务推荐：

以坚果云为例设置步骤：

1. 打开 https://www.jianguoyun.com 登录
2. 账户信息 → 安全选项 → 第三方应用管理 → 添加应用
3. 生成应用密码（记下来，只显示一次）
4. 电脑洛雪 → 设置 → 歌单 WebDAV 同步
5. 填写：
6. 地址： https://dav.jianguoyun.com/dav/
7. 用户名： 坚果云登录邮箱
8. 密码： 刚才生成的应用密码（不是登录密码）
9. 测试连接 → 成功 ✅
10. 手机端同样配置即可

建议： 局域网内首选方案一（内置同步），既简单又方便。有云服务器的话用方案二实现随时随地同步。WebDAV 作为备选。

五、使用技巧

5.1 常用设置优化

打开洛雪 → ⚙️ 设置 → 基础设置：

5.2 搜索技巧

• 精准搜索： 歌手名 歌名 → 指定歌手+歌名
• 歌单搜索： 直接在”歌单”Tab 搜索歌单 ID
• 全网搜索： 切换不同音源搜同一首歌，不同平台的音源结果可能不同
• 歌手搜索： 搜歌手名，点击”歌手”Tab查看全部歌曲

5.3 歌单管理

• 新建歌单： 左侧右击”我的歌单”→新建
• 添加到歌单： 歌曲右键 → 添加到歌单
• 批量操作： Ctrl/Shift 多选歌曲 → 右键批量操作
• 拖拽排序： 歌单内的歌曲可以直接拖拽调整顺序
• 导出歌单： 右键歌单 → 导出（JSON格式，可分享给朋友）

5.4 下载音乐

洛雪支持下载歌曲到本地：

1. 点击歌曲右侧的 ··· → 下载
2. 选择音质（普通/标准/高品质/无损）
3. 下载后可在”下载管理”中查看
4. 文件位置：设置中可自定义下载目录

注意： 能下载到哪种音质取决于当前音源是否提供该质量的链接，并非所有音源都支持无损下载。

5.5 键盘快捷键

5.6 多音源切换

洛雪支持同时导入多个音源，使用时可以在不同音源间切换：

• 设置 → 音源设置 → 下拉菜单选择当前使用的音源

5.7 美化

洛雪界面虽然不算华丽，但可以简单美化：

• 主题色： 设置 → 主题设置 → 自定义颜色
• 背景图： 桌面版支持自定义背景图片
• 迷你模式： 右上角 → 切换到迷你模式（类似 Windows Media Player 的迷你窗口）
• 歌词样式： 设置 → 歌词设置 → 调整字体大小和颜色

5.8 使用建议

六、常见问题

Q：洛雪音乐安全吗？会不会有病毒？

A：从 GitHub 官方 Releases 下载的版本是安全的。不要从第三方站点下载”破解版””免配置版”，那些可能被植入恶意代码。

Q：为什么我搜的歌播放不了？

A：原因可能是： 1. 音源配置问题 → 检查是否已导入有效音源 2. 网络问题 → 检查你的网络连接

Q：洛雪有 iOS 版吗？

A：没有。iOS 用户推荐使用 Listen1 的 Safari 插件版。

Q：歌单同步后重复了怎么办？

A：首次同步时注意选择正确的同步方式（覆盖/合并）。如果已经重复：在设置中找到”数据同步” → 选择”清除同步数据” → 重新同步即可。以后每次同步会自动合并，不会再重复。

Q：同步时提示连接失败？

A：检查以下几点： 1. 电脑和手机是否在同一个 Wi-Fi 下 2. 电脑上的同步服务是否已启用（地址和端口是否有显示） 3. 防火墙是否拦截了洛雪的端口（23332） 4. 在手机浏览器访问 http://x.x.x.x:23332/hello 测试能否打开 5. 路由器是否开启了 AP 隔离（公共Wi-Fi经常有这个问题）

Q：下载的歌曲在哪个文件夹？

A：打开 设置 → 下载设置，可以看到自定义下载目录，默认在 C:\Users\你的用户名\Music\lx-music\。

七、总结

洛雪音乐助手是一款功能完整的开源聚合音乐播放器，支持多种平台，具备搜索、播放、歌词显示、歌单管理和多设备同步等能力。https://wxa.wxs.qq.com/tmpl/ps/base_tmpl.html