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

洛雪音乐助手（lx-music）是目前最活跃的开源聚合音乐播放器之一，内置搜索、歌单管理、歌词显示，配合社区音源可以整合多个平台的歌曲。

本文从零开始，手把手教你：下载 → 安装 → 找音源 → 导入音源 → 手机电脑歌单同步 → 使用技巧。

一、下载

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

官方下载地址

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

无法访问 GitHub？

如果你打不开 GitHub，可以用这些镜像站（把 github.com 替换为镜像域名）：

https://mirror.ghproxy.com/https://github.com/lyswhut/lx-music-desktop/releases
https://ghproxy.net/https://github.com/lyswhut/lx-music-desktop/releases

或者去酷安搜"洛雪音乐"下载安卓版。

二、安装

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 或其他替代方案。

三、初次使用（安装后第一件事）

安装完打开，你会发现：

第一次打开可能搜不到歌 🔴

不要慌！这是因为洛雪默认不带音源文件，需要手动导入音源。这其实是好事——音源由社区维护更新，不绑定在软件里，源失效了换个新的就行。

接下来就是最关键的一步：获取并导入音源。

四、音源获取与导入

4.1 什么是音源？

洛雪本身不存储音乐，它只是一个"壳"。音源（也叫源、接口）定义了它能从哪里搜歌、播放。可以把音源理解为"翻译器"——告诉洛雪怎么去各平台拿数据。

4.2 获取音源

音源是一个 .js 文件，由社区开发者维护。

官方推荐音源仓库：

建议两个都关注，一个失效了马上换另一个。

下载步骤：

1. 打开 https://github.com/lyswhut/lx-music-source/releases
2. 查看最新的 Release（通常叫 v1.x.x）
3. 下载 lx-music-source-v1.x.x.zip
4. 解压后你会得到多个 .js 文件（一个文件就是一个音源）

4.3 导入音源

桌面版导入：

1. 打开洛雪音乐助手
2. 点击右上角 ⚙️ 设置
3. 左侧选择 音源设置（或叫"音乐来源"）
4. 点击 导入音源（或"导入"按钮）
5. 选择刚才解压的 .js 文件（可以多选）
6. 导入成功后，在"音乐来源"下拉菜单中选择刚刚导入的音源
7. 回到首页，随便搜一首歌试一下

效果验证：

• 搜索框输入任意歌曲名，如果出现歌曲列表 = ✅ 成功了
• 如果提示"搜索失败"或"未获取到数据" = 换个音源试试

安卓版导入：

1. 将 .js 音源文件传送到手机（微信文件传输助手、QQ等）
2. 打开洛雪音乐助手安卓版
3. 点击左上角 ☰ 菜单 → 音源管理
4. 点击 同步/导入音源
5. 选择音源文件
6. 然后点击"使用"

4.4 音源更新策略

音源随时可能失效（大平台接口一变，音源就废了）。建议：

• 定期检查更新： 每月访问 https://github.com/lyswhut/lx-music-source/releases 看看有没有新版本
• 关注 Release 通知： 在该页面点右上角 Watch → Custom → Releases，有新版本时 GitHub 会发邮件通知你
• 多备几个音源： 同时导入 2-3 个不同的音源，一个失效了切换另一个

4.5 如果找不到合适的音源

五、手机与电脑数据同步

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

5.1 同步模式说明

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

5.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）下使用！

5.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 端口可以省略端口号

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

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

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

WebDAV 服务推荐：

以坚果云为例设置步骤：

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

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

六、使用技巧

6.1 常用设置优化

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

6.2 搜索技巧

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

6.3 歌单管理

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

6.4 下载音乐

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

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

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

6.5 键盘快捷键

6.6 多音源切换

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

• 设置 → 音源设置 → 下拉菜单选择当前使用的音源
• 如果某个音源搜索不到结果（或搜索失败），换另一个试试
• 建议导入 3 个以上音源备用

6.7 美化

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

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

6.8 避坑指南

七、常见问题

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

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

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

A：原因可能是：

1. 音源失效 → 去 GitHub 下载最新音源
2. 该歌曲在当前音源中无法获取 → 切换不同音源试试
3. 网络问题 → 检查你的网络连接

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\。

八、总结：一句话入门

① 下载安装 → ② 下载音源 .js 文件 → ③ 导入音源 → ④ 开听！

后续只要定期（每月一次）去 https://github.com/lyswhut/lx-music-source/releases 检查音源更新即可。