局域网同步连不上时的系统排查清单

排查顺序

按以下顺序逐步排查。每一步确认没问题后再进下一步，不要跳过。

第 1 步：桌面版同步服务是否真的启动

回到电脑上的洛雪音乐，确认：

「设置 → 数据同步」中已勾选「启用同步」。
模式选择的是「服务端模式」。
同步服务地址不是空的。
没有显示错误信息（比如端口被占用、启动失败）。

如果显示错误信息，先解决那里的问题（比如换一个端口）。

第 2 步：桌面版自己能访问吗

在电脑自身的浏览器中打开：

http://127.0.0.1:23332/hello

应该看到 Hello~::^-^::~v3~。如果电脑自己都打不开：

同步服务根本没正常启动。
检查端口是否被其他程序占用（netstat -ano | findstr 23332 在 cmd 中查看）。
或者关掉同步功能重新启用一次。

第 3 步：确认手机和电脑在同一个局域网

关键检查点：手机必须连接 Wi-Fi，不能用 4G / 5G 流量。4G / 5G 流量是蜂窝网络，和家里的 Wi-Fi 路由器是两个完全不同的网络，互相不通。

在电脑的 cmd 中执行：

ipconfig

查看 Wi-Fi 网卡的 IPv4 地址（通常是 192.168.x.x）。

在手机的 Wi-Fi 设置中查看手机当前的 IP 地址。

如果两个 IP 的前三段不一样（比如电脑是 192.168.1.50，手机是 192.168.0.80），说明它们不在同一个子网。这种情况下需要进一步确认路由器的配置。

第 4 步：ping 测试连通性

在电脑的 cmd 中，ping 手机的 IP 地址：

ping <手机的IP>

能 ping 通：说明电脑能找到手机，网络层是通的。
ping 不通：电脑和手机之间有网络隔离。可能是路由器的 AP 隔离功能开启了（见第 6 步）。

第 5 步：手机浏览器测试

在手机自身的浏览器中打开桌面版同步地址末尾加 /hello：

http://<电脑的IP>:23332/hello

如果能打开并显示 Hello~

✅ 网络完全畅通。此时问题在洛雪音乐内部：

确认手机端版本 ≥ v1.1.0。
回到手机的洛雪音乐同步设置，删除原来的地址后重新输入，输入完务必按回车键让地址生效。
尝试在桌面版上「立即同步」后再在手机上「立即同步」。

如果打不开

网络层还是有问题，继续第 6 步。

第 6 步：AP 隔离检查

AP 隔离是路由器的一个安全功能，开启后同一局域网内的设备互相之间无法通信，但都能正常上网。很多公共 Wi-Fi（咖啡厅、酒店）和部分家用路由器默认开启。

检查方法：

进入路由器管理页面（通常在浏览器输入 192.168.1.1 或 192.168.0.1）。
找到「AP 隔离」或「客户端隔离」相关选项。
如果开启了，关闭它。
保存设置，等待路由器重启。

第 7 步：防火墙放行

Windows Defender 防火墙或第三方安全软件可能拦截了洛雪音乐的入站连接。临时关闭防火墙测试一下：

电脑设置 → Windows 安全中心 → 防火墙和网络保护 → 专用网络 → 关闭 Microsoft Defender 防火墙。
关闭后，手机浏览器再次打开同步地址测试。

如果关了防火墙手机就能打开 → 确定是防火墙问题。重新打开防火墙，然后去「允许应用通过防火墙」中找到洛雪音乐，勾选「专用网络」和「公用网络」。
如果关了还是打不开 → 防火墙不是原因，继续排查。

第 8 步：检查用了哪个网卡

如果电脑同时连接了 Wi-Fi 和有线网络，洛雪音乐可能显示了有线网卡的地址，而手机在 Wi-Fi 上。确认：

电脑的同步地址显示的是 Wi-Fi 网卡的 IP（不是有线网卡）。
如果显示了有线网卡的地址，临时拔掉网线，只保留 Wi-Fi，重启洛雪音乐后看地址是否正确切换。

第 9 步：更换测试方式

以上都不行的话，可以尝试：

把手机的热点开起来，让电脑连手机热点（相当于反过来让手机做路由器），然后重新配置同步。
或者换另一个局域网环境测试（比如朋友家的路由器）。

成功后的标志

手机浏览器打开 /hello 能看到文字 → 在洛雪音乐里输入地址 → 按回车 → 启用同步 → 几秒钟后提示连接成功或弹出首次同步合并对话框。