快速上手
创建网络、安装并批准两台设备，然后验证虚拟网络 IP（Overlay IP）互通。
准备条件
- 两台 Linux、Windows 或 macOS 设备；无需公网 IP，也无需位于同一网络。
- 两台设备的管理员权限：Linux 和 macOS 使用
sudo，Windows 使用管理员 PowerShell。 - 可访问控制台的浏览器。
注册账号
打开注册登录页，使用用户名、密码和手机号注册，再完成短信验证。字段和验证规则见注册登录。
创建网络
首次登录控制台后，新建一个网络：
- 名称：用于识别网络，可随时修改。
- 内网地址段：虚拟网络地址段（Overlay CIDR），应从私有地址范围中选择，并避开各设备所在 LAN 及其他虚拟网络的地址段；没有特定规划时可保留默认值。
创建后会生成一个 12 位网络编号，例如 k7m2p9x4rt6n。该编号用于设备注册，不是认证凭据；设备仍需审批后才能通信。
安装软件
进入控制台「配置 → 设备」，打开添加设备窗口。窗口中的命令已写入当前站点域名和网络编号，直接复制，不要手工替换示例中的尖括号内容。
Linux 和 macOS：
curl -fsSL https://<你的站点 API 域名>/wwnet/install/join/<网络编号>.sh | sudo sh
Windows（管理员 PowerShell）：
powershell -c "irm https://<你的站点 API 域名>/wwnet/install/join/<网络编号>.ps1|iex"
安装器会校验发布清单和程序文件，注册系统服务，并用网络编号注册设备。分别在两台设备上执行一次。平台要求见设备。
批准设备
新设备注册后显示为待审批。在「配置 → 设备」核对主机名和平台，然后批准两台设备。状态变为已批准后，设备才会获取对端配置并建立链路。
验证互通
在两台设备上分别运行：
wwnet
确认 status 为 connected，并记录 network address（虚拟网络 IP）。同一张表里每个对端各占一行 peers，标注路径类型和健康状态。
从一台设备访问另一台的虚拟网络 IP：
ping <对端虚拟网络 IP>
收到响应即完成基础组网。
后续操作
故障速查
| 现象 | 检查与处理 |
|---|---|
| 安装命令立即失败 | 确认管理员权限、curl 可用，并从「配置 → 设备」重新复制完整命令 |
status 为 awaiting approval |
在控制台批准该设备；这是注册后的正常状态 |
status 不是 connected |
表格会多出一行 reason，给出详细原因和错误码 |
| 两台设备无法互通 | 确认两端均已批准、使用的是虚拟网络 IP，并检查虚拟网络地址段是否与本地 LAN 重叠 |
完整处理流程见故障排查。