故障排查

按安装、服务、审批、连通性和卸载阶段定位问题，并查询 E1xxx 错误码。

收集基础状态

先在受影响设备运行：

wwnet

记录整张表——status、network address、各行 peers——以及完整错误提示和 E1xxx 错误码。连通性问题需要在链路两端分别收集。

已有错误码时，可直接查看本页末尾的错误码对照。

安装失败

后台服务未运行

E1002 对应 status 为 background service not running。检查服务：

systemctl status wwnet            # Linux (systemd)
/etc/init.d/wwnet status          # OpenWrt
sudo launchctl list | grep wwnet  # macOS
Get-Service wwnet                 # Windows

服务不存在通常表示安装未完成，应重新执行安装命令。Linux 日志使用 journalctl -u wwnet -n 100 --no-pager，OpenWrt 使用 logread | grep wwnet。

E1003 表示服务正在初始化。等待数秒后重试，不要反复重启。

设备停留在待审批

status 为 awaiting approval 是注册后的正常状态。在控制台「配置 → 设备」批准设备后再测试通信。

若设备未出现在列表中，说明注册尚未完成；回到设备查看 wwnet 输出和错误码。

两台设备无法互通

按以下顺序检查：

1. 两端 status 均为 connected，且已在控制台批准。
2. 测试目标使用对端的 network address，而不是本地 LAN 地址。
3. 虚拟网络地址段（Overlay CIDR）不与任一端本地 LAN 或子网路由目标重叠。
4. 目标主机防火墙允许来自虚拟网卡的 ICMP 或实际业务端口。
5. wwnet 中该对端的 peers 行显示健康路径。
6. 控制台「配置 → 链路」没有禁用所有可用路径。

ping 被主机策略禁用时，应改用实际业务端口验证，不要只凭 ICMP 判断链路不可用。

使用中继而非直连

直连因对称型 NAT、UDP 被阻断或严格出站 ACL 失败时，系统会回落到网内中继或云端中继。这是正常选路，不影响端到端加密。

若业务要求直连，检查两端 NAT 类型、UDP 出站和主机防火墙；路径详情见连通性与路径。

云端中继未生效

在控制台「配置 → 链路」打开链路详情，按显示原因处理：

• 余额初始化中：等待同步，不要充值。
• 余额不足：充值到账后自动恢复。
• 时间计划未开启：检查计划、时区和当前时间。
• 地区信息不足、中继不可用、账号状态异常：等待恢复或联系支持。

切换网络时冲突

E1042 表示当前安装实例已经属于其他网络。先执行：

wwnet leave

完成后再运行新网络的安装命令。

离开或卸载未完成

E1060 对应 status 为 needs attention，表示路由、防火墙或虚拟网卡尚未完全还原。执行：

wwnet uninstall

该命令不依赖后台服务，可重复执行。报告成功前不要手工删除程序目录或恢复数据。

Windows 安全提示

首次下载或运行时，Windows 或企业终端防护可能要求确认。按组织策略完成管理员放行。若安装器报告签名或 SHA-256 校验失败，不要绕过。

错误码对照

终端错误末尾包含稳定错误码，例如：

wwnet: this command needs administrator/root privileges (E1001)

本机可处理

等待或检查网络

检查控制台

联系支持

仍未解决

联系支持时提供错误码、发生时间、系统版本和两端的 wwnet 输出，见获取支持。