连接不通怎样排查

先找到失败发生在哪一层

不要一开始就重装或清空配置。先把问题分成六层：账号是否正确、网络成员资格是否有效、设备是否连接、双方数据路径是否建立、目标应用端口是否可达、应用账号是否能登录。每次只处理最先失败的一层。

记录访问端和目标端各自的设备名称、系统、客户端版本、网络 ID、故障时间，以及你刚才执行的操作。复制错误原文比只说“不能用”更有帮助；如果问题偶发，故障时和恢复后分别保留一次状态与诊断。

先在本机或独立的管理通道操作。重启服务、断开网络或卸载会中断经过这台设备的连接，作为唯一远程通道时应先准备恢复方法。

我的网络中没有目标网络

1. 确认客户端和接受邀请的网页使用同一账号。
2. 点击“我的网络”中的“重新读取”。
3. 还没接受成员邀请时，先向所有者索取邀请链接；网络 ID 不能直接加入。

已经登录，但控制台没有这台设备

登录只是确认账号，设备还需连接网络。Windows 在“我的网络”点击“加入该网络”；Mac、Linux 或路由器执行专属接入命令，或在账号授权后执行 sudo wangyunlian networks connect 网络ID。再核对控制台选中的网络。

设备显示离线

1. 确认那台设备已开机并联网，没有休眠。
2. 确认客户端后台服务运行，并已连接到正确网络。关闭窗口不等于退出服务。
3. 命令行执行 sudo wangyunlian status，检查是否已分配网云连地址；Mac 可用 sudo launchctl print system/com.too1.wangyunlian.agent 查看服务。
4. 恢复联网后刷新设备列表。被移除的设备要重新接入。

在线，但访问不了远程桌面、SSH 或网页

1. 核对双方连接的是同一张网络；重名网络仍可能是不同网络。
2. 复制目标的网云连地址，不要把本机地址或示意地址当成目标。
3. 确认目标服务已开启，并监听可访问的地址和正确端口。
4. 检查目标防火墙以及网络访问规则，只放行所需应用或端口。

Ping 没有响应时，可同时检查实际服务；系统可能单独拦截 ICMP。查看服务访问方法。

远程桌面偶尔断开，过一会儿又恢复

1. 先核对并将连接两端更新到各自平台当前正式版本，并记录断开的大致时间和远程桌面的报错。
2. 故障时，在发起连接的 Windows 上运行 Test-NetConnection 目标的网云连地址 -Port 3389。设备显示在线不代表远程桌面端口可用。
3. 两端分别导出诊断包；恢复后再各导出一份。先保留现场，避免反复重装或删除网络配置。
4. 如果网云连链路正常而 3389 端口不通，检查目标电脑的远程桌面服务、休眠状态和防火墙；端口可通但登录失败时，同时提供远程桌面错误码。

显示“尚未建立”或没有延迟

在线状态和数据链路是两回事。在线只表明后台可联系；“尚未建立”表示还没有可用的对端链路观测。等待短暂测量并实际访问一次对端服务，再查看连接诊断。测量失败不等于设备离线。

同一局域网为什么还是中继？

正常情况下会优先尝试局域网直连。同一 Wi-Fi 不一定允许设备互访：访客网络、AP 隔离、其他 TUN 或代理软件、端点防火墙都可能影响直连。更新两端客户端，检查局域网是否能相互访问；不要把关闭全部防火墙作为常规解决办法。

连接速度低

先看“连接方式”。中继共享额度为免费 1 Mbps、个人 10 Mbps、团队 30 Mbps；P2P 直连不设套餐限速，但仍受两端上传带宽、Wi-Fi 和设备性能影响。查看速度口径。

切换失败或 GUI 与命令行状态不同

使用官网下载的最新客户端。GUI 与 CLI 应连接同一个系统后台；不要手动额外运行第二个 Agent。检查失败提示中的原网络恢复情况，再重试连接。网页切换查看的网络不会自动切换电脑上的网络。

导出诊断包

Windows 打开“连接诊断”→“导出诊断包”。排查偶发断连时，命令行可导出包含连接历史的诊断包：

wangyunlian diagnostics --include-debug-logs --output wangyunlian-diagnostics.zip

Mac、Linux 按安装方式在命令前加 sudo；Windows 图形客户端随附的命令行程序名为 wangyunlian-cli.exe。0.4.9 起默认保留有容量限制的连接事件，包含失败、重试、恢复和链路变化。诊断包会注明是否成功保存及是否截断；升级前未记录的历史无法补回。

反馈问题时说明系统、两端版本、网络 ID、出现时间和具体操作，并附诊断包。诊断包含设备和网络信息，请通过可信支持渠道发送。

通过工单提交问题与日志

1. 在 Windows 或 Mac 客户端打开“连接诊断”→“提交工单”，填写问题标题、发生时间、涉及设备和报错。
2. 勾选“附带当前诊断日志”后提交，客户端会自动采集并上传诊断 ZIP。若采集失败，可重试或取消勾选后先提交问题。
3. 也可以先用“导出诊断文件”保存到下载文件夹，再到控制台的“我的工单”上传。Linux 等命令行设备可上传上方命令导出的 ZIP。
4. 在“我的工单”查看技术支持回复，继续补充资料。问题解决后标记已解决或关闭，需要继续排查时可重新打开。

支持 ZIP、TXT、LOG、JSON、JSONL、PNG 和 JPG；每次最多 5 个附件，单个 10 MB、合计 20 MB。附件仅对你和支持人员可见。诊断包含网络和设备信息，请检查后上传，不要附上密码、验证码、私钥或认证令牌。

先收集状态，再按系统检查后台

Windows 图形版先查看“我的网络”和“连接诊断”，确认选中的具体网络；随附命令行可能名为 wangyunlian-cli.exe。Mac、普通 Linux 的 wangyunlian 命令按需要加 sudo；OpenWrt 在 root SSH 中直接使用，不要照抄 sudo。

查看状态可用 wangyunlian status --all，查看同网设备可用 wangyunlian peers。Linux 用 systemctl/journalctl 查看 wangyunlian-agent；Mac 用 launchctl 查看 com.too1.wangyunlian.agent；OpenWrt 用 /etc/init.d/wangyunlian 和 logread -e wangyunlian。不要把一种系统的服务命令粘到另一种系统。

先核对实际安装版本，再决定是否升级。不同平台可能发布不同版本号，统一从官方目录获取当前适用版本；不能因为 Windows 与 Mac 数字不完全相同，就使用另一个系统的安装包。

在线但应用打不开：先在目标本地试一次

目标电脑前能打开同一个应用吗？服务是否已经启动、监听正确地址和端口？如果只监听 127.0.0.1，它只接受本机连接。先处理目标应用，再从访问端使用目标网云连地址测试。

Windows 可在 PowerShell 用 Test-NetConnection 检查实际 TCP 端口，例如远程桌面通常用 3389，但修改过端口时以实际配置为准。端口可达而登录失败时，重点检查应用账号、权限和错误码；Ping 的结果不能替代这一步。

OpenWrt 单独出现 TUN、依赖或 53 端口报错

TUN 是固件内核能力。先检查 uname -r、/etc/openwrt_release 和 /dev/net/tun；已有支持时无需重复安装 kmod-tun。缺少设备或内核依赖不匹配时，暂停接入操作，联系固件维护者确认兼容模块，不强制安装、换源或据此认定只能刷机。

如果错误明确是本地 53 端口已占用，先看 OpenWrt 是否曾启用网云连 DNS 接管。新版默认保留路由器现有 DNS；按OpenWrt 教程核对 accept_dns，而不是直接删除 dnsmasq 或修改全家设备的 DNS。

现场无法提供日志时，暂时保留未知结论，先不要连续尝试高影响配置。固件异常、内核模块不匹配、DNS 冲突、设备内存不足和应用端口问题，需要不同证据，不能用同一种“重装”流程替代判断。

怎样提交一份容易定位的工单

标题写清“哪两个设备、什么操作失败”，正文按“预期结果、实际结果、发生时间、是否必现、已尝试的步骤”描述。附上两端版本、同一网络 ID、错误原文和诊断包；截图有帮助，但不要只给一张没有上下文的提示。

先检查附件是否包含密码、有效令牌、私钥或机器人地址，再通过我的工单发送。需要 Linux/OpenWrt 的 ZIP 文件时，从设备下载诊断文件到电脑再上传；终端显示保存路径不等于已经提交给支持人员。

问题恢复后也请补充恢复时间和采取的操作。如果只是自动恢复而原因尚不明确，照实说明，避免把未经证实的猜测当成以后所有客户的解决办法。

遇到这些情况，怎样继续？