vLanIO 故障排查指南

当设备无法互相发现、传输失败或速度异常时，可按本文逐步排查。

找不到其他设备

现象

局域网内其他已运行 vLanIO 的机器不出现在列表中。

请检查：

1. 同一网络 — 同一 Wi‑Fi 或同一交换机，非访客/VLAN 隔离网
2. 应用已运行 — 双方 vLanIO 在前台或允许后台发现
3. 关闭 VPN — VPN 常把流量导向隧道，导致局域网不可达
4. 防火墙 — 在 Windows Defender / macOS 防火墙中允许 vLanIO
5. AP 隔离 — 路由器上临时关闭「客户端隔离」做对比测试

快速测试： 用 ping 测试对方内网 IP。若 ping 不通，先解决网络再排查 vLanIO。

连接被拒绝或超时

现象

能看到设备但无法开始传输。

尝试：

• 双方重启 vLanIO
• 开关 Wi‑Fi 或改用有线
• 确认未使用限制客户端互联的热点
• 在 设置 → 设备 中移除后重新配对

传输速度很慢

现象

能传但速率远低于预期局域网带宽。

常见原因与对策：

另可参考 传输速度优化技巧。

传输中途中断

现象

进度条停止。

1. 关闭睡眠/合盖休眠（大文件传输期间）
2. 笔记本接电源，避免省电模式限网
3. 重试；未完成文件可能需手动清理目标目录

权限问题（macOS / Linux）

macOS 需授予 本地网络 权限；Linux 请在 firewalld/ufw 中放行 vLanIO 相关端口。

# 示例：ufw 放行（路径按实际安装调整）
sudo ufw allow from 192.168.0.0/16 to any app vLanIO

文件损坏或大小不符

局域网场景较少见；发送前确认磁盘空间。关键数据可在传输后校验哈希。

移动端说明

若使用移动版，请在 iOS 设置 → 隐私 → 本地网络 中允许 vLanIO。

仍需帮助？

若以上均无效：

• 查阅 文档
• 在 关于我们 获取支持联系方式
• 反馈时请附上：系统版本、网络类型（Wi‑Fi/有线）、是否开启 VPN

最后更新： 2024 年 11 月 11 日

适用版本： vLanIO 1.x 及以上