快速上手
创建网络、安装并批准两台设备,然后验证虚拟网络 IP(Overlay IP)互通。
选择站点
网连网络提供中国站和国际站,两站的数据存储位置不同,账号、网络和余额相互独立。注册前按期望的数据存储位置选择站点。本指南介绍中国站的使用方法。
准备条件
- 两台 Linux 或 Windows 设备;无需公网 IP,也无需位于同一网络。macOS 与移动设备按设备中的应用步骤接入,再继续下文的审批和互通验证。
- 两台设备的管理员权限:Linux 使用
sudo,Windows 使用管理员 PowerShell。 - 可访问控制台的浏览器。
注册账号
打开注册登录页,使用用户名、密码和手机号注册,再完成短信验证。字段和验证规则见注册登录。
创建网络
登录后,在控制台顶部网络选择器中选择「新建网络」;首次进入时按创建网络提示操作。填写:
- 名称:用于识别网络,可随时修改。
- 内网地址段:虚拟网络地址段(Overlay CIDR),应从私有地址范围中选择,并避开各设备所在 LAN 及其他虚拟网络的地址段;没有特定规划时可保留默认值。
创建后会生成一个 12 位网络编号,例如 k7m2p9x4rt6n。该编号用于设备注册,不是认证凭据;设备仍需审批后才能通信。
安装软件
进入控制台「配置 → 设备」,在“它如何工作”中选择安装平台。安装命令已写入当前站点域名和网络编号,直接复制,不要手工替换示例中的尖括号内容。
Linux:
curl -fsSL https://<你的站点 API 域名>/wwnet/install/join/<网络编号>.sh | sudo sh
Windows(管理员 PowerShell):
# 在管理员 PowerShell 中执行
iex (irm "https://<你的站点 API 域名>/wwnet/install/join/<网络编号>.ps1")
安装器会下载并验证软件、完成安装,再用网络编号注册设备。分别在两台设备上执行一次。平台要求见设备。
批准设备
新设备注册后显示为待审批。在「配置 → 设备」核对主机名和平台,然后批准两台设备。状态变为已批准后,设备开始建立连接。
验证互通
在两台设备上分别运行:
wwnet
确认 status 为 connected,并记录 network address(虚拟网络 IP)。同一张表里每个对端各占一行 peers,标注路径类型和健康状态。
从一台设备访问另一台的虚拟网络 IP:
ping <对端虚拟网络 IP>
收到响应表示基础网络可达。继续测试实际业务端口,业务所在设备的防火墙和访问权限仍需允许该连接;在「总览」核对当前网络和两台设备。
后续操作
故障速查
| 现象 | 检查与处理 |
|---|---|
| 安装命令立即失败 | 确认管理员权限、curl 可用,并从「配置 → 设备」重新复制完整命令 |
status 为 awaiting approval |
在控制台批准该设备;这是注册后的正常状态 |
status 不是 connected |
按状态表中的处理提示和错误码操作 |
| 两台设备无法互通 | 确认两端均已批准、使用的是虚拟网络 IP,并检查虚拟网络地址段是否与本地 LAN 重叠 |
完整处理流程见故障排查。