跨端同步连接失败——端口被防火墙拦截的排查清单

症状

移动版在「客户端模式」中输入了桌面版显示的同步服务地址（比如 http://192.168.1.50:23332），但连接失败或长时间无响应。

排查的核心思路是逐层缩小范围：确认服务真的启动了 → 确认电脑自身能访问 → 确认手机浏览器能访问 → 排除防火墙 → 排除 AP 隔离。

快速定位法：手机浏览器测试

这是最快的诊断方法，能一次性把「电脑端问题」和「网络层问题」分开：

第 1 步：电脑上确认服务正常

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

http://127.0.0.1:23332/hello

应该看到文字：Hello~::^-^::~v3~。

电脑自己都打不开 → 同步服务没正常启动，回到桌面版洛雪音乐重新检查「启用同步」是否勾选。
电脑能打开 → 服务正常，继续第 2 步。

第 2 步：手机浏览器测试

在手机自身的浏览器中打开：

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

比如电脑显示的同步服务地址是 http://192.168.1.50:23332，手机就打开 http://192.168.1.50:23332/hello。

⚠️ 手机必须用同一 Wi-Fi，不能用 4G / 5G 流量。

情况 A：手机浏览器也能打开 ✅

网络畅通，防火墙没拦。那问题在洛雪音乐内部：

确认手机端输入地址后按了回车键让地址生效。
确认两端版本满足最低要求：桌面版 ≥ v2.4.0，移动版 ≥ v1.1.0。
重新尝试连接。

情况 B：手机浏览器打不开 ❌

网络层有问题，重点排查防火墙和 AP 隔离。继续下面的步骤。

防火墙排查

临时关闭防火墙测试

最快的验证方法：临时关闭 Windows Defender 防火墙，然后手机浏览器重新打开同步地址测试。

Windows 10/11：

设置 → Windows 安全中心 → 防火墙和网络保护。
在「专用网络」和「公用网络」下方点击「关闭」（⚠️ 只是临时测试，测试完要重新开启）。
回到手机浏览器重新打开同步地址。

关了防火墙后手机就能打开 → 100% 是防火墙拦截。下面教你正确放行。
关了还是打不开 → 防火墙不是原因，继续排查 AP 隔离。

正确放行洛雪音乐（永久）

重新开启 Windows Defender 防火墙。
还是在防火墙设置页面，点击「允许应用通过防火墙」。
点击「更改设置」→「允许其他应用」。
找到洛雪音乐的可执行文件（lx-music-desktop.exe）。
如果列表里没有，点击「浏览」手动找到可执行文件。
勾选「专用」和「公用」两个复选框。
保存。

如果是第三方安全软件（360、腾讯管家、火绒等），在各自的防火墙 / 网络防护模块中找到「允许程序联网」相关设置，手动添加洛雪音乐为白名单。

手动放行 23332 端口（可选）

如果允许程序还是不行，可以单独放行端口：

Windows Defender 防火墙 → 高级设置。
入站规则 → 新建规则 → 端口 → TCP → 输入 23332 → 允许连接。
对出站规则也做同样设置。

AP 隔离排查

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

检查方法

在电脑 cmd 中：

ping <手机的IP地址>

（手机的 IP 地址可以在手机的 Wi-Fi 设置中查看）

能 ping 通 → 网络层互通，不是 AP 隔离。
ping 不通 → 电脑和手机不在同一个可通信的网络环境中，大概率是 AP 隔离。

解决方法

进入路由器管理页面（浏览器输入 192.168.1.1 或 192.168.0.1）。
找到「AP 隔离」或「客户端隔离」或「无线隔离」选项。
关闭它。
保存设置，可能需要重启路由器。

验证修复

路由器改完后，手机重新连接 Wi-Fi，再试 ping 手机 IP。能 ping 通后再回到同步设置测试。

端口号检查

默认同步端口是 23332。如果你在桌面版同步设置中修改过端口，记得：

手机端输入的地址里要用新端口号。
防火墙放行时也要放行新端口号（不是默认的 23332）。