桌面版做同步服务端——在局域网内为移动版提供同步
前置条件
- 桌面版 v2.4.0 及以上。
- 桌面版和手机连接在同一个路由器的局域网内。
- 电脑没有被防火墙（Windows Defender 防火墙、第三方安全软件）拦截端口 23332。
步骤详解
步骤 1：找到同步设置入口
打开洛雪音乐桌面版 → 设置 → 找到「数据同步」或「同步功能」相关区块。不同版本的入口名称略有差异。
步骤 2：选择服务端模式
在「数据同步」设置中，选择「服务端模式」或「服务端」。
步骤 3：启用同步功能
勾选「启用同步」复选框。启用后会出现以下信息：
- 同步服务地址：通常显示类似
http://192.168.x.x:23332的地址。如果显示多个地址，选择与手机 IP 最接近的那一个（一般是 Wi-Fi 网卡的地址，不是以太网）。 - 端口号：默认是 23332。不要随意改端口，除非这个端口已经被其他程序占用。
- 连接码：部分版本会显示一个连接码，用于移动端验证。
步骤 4：处理防火墙弹窗
启用同步时，Windows Defender 防火墙或第三方安全软件几乎一定会弹窗提示是否允许网络连接。必须点击「允许访问」或「放行」。如果不小心点了「取消」或「阻止」，同步服务无法被手机访问。
之后如果需要手动放行，可以：
- Windows 设置 → 更新和安全 → Windows 安全中心 → 防火墙和网络保护 → 允许应用通过防火墙。
- 找到洛雪音乐（lx-music-desktop.exe），勾选「专用网络」和「公用网络」。
- 保存设置。
步骤 5：记下同步地址
记下桌面版显示的同步服务地址（比如 http://192.168.1.50:23332）。接下来在手机上需要输入这个地址。
验证服务是否启动成功
在手机连接之前，可以先在电脑上验证：
- 打开浏览器（Chrome、Edge 等）。
- 在地址栏输入桌面版显示的同步服务地址，末尾加上
/hello，比如http://192.168.1.50:23332/hello。 - 按回车。
如果看到 Hello~::^-^::~v3~ 这段文字，说明同步服务启动成功且响应正常。
如果浏览器打不开这个地址：
- 检查同步功能是否真的启用了（回到设置确认）。
- 检查 Windows 防火墙是否放行。
- 检查桌面版和手机是否在同一个路由器。
- 检查路由器是否开启了「AP 隔离」功能（见排查清单）。
端口号说明
默认端口 23332 是洛雪音乐官方推荐的同步服务端口。在极少数情况下（比如这个端口已被其他软件占用），你可以在同步设置中修改端口。修改后记得：
- 新端口号也需要在防火墙中放行。
- 手机端输入的地址必须用新端口号。
首次同步的合并方式
当手机第一次连接桌面版时，如果两端的收藏列表都不为空，桌面版会弹出合并方式选择对话框。三种选项：
| 选项 | 行为 |
|---|---|
| 以桌面版为主 | 桌面版的列表覆盖移动版 |
| 以移动版为主 | 移动版的列表覆盖桌面版 |
| 智能合并 | 两端的列表合并，相同列表合并歌曲，不同列表各自保留 |
大多数情况下推荐「智能合并」——两边都保留，不会丢歌。
重要：这个选择只针对首次同步。首次同步成功后，后续同步自动按智能合并处理，不会再弹出选择框。
后续同步
连接成功后，两端的同步是自动后台运行的：
- 手机收藏一首新歌 → 短时间内桌面版自动看到。
- 桌面版删除一个歌单 → 短时间内手机自动同步删除。
- 不需要手动触发，不需要重新连接。
如果觉得同步没有自动发生，可以在同步设置中点击「立即同步」按钮手动触发一次。