# 快速上手

> 创建网络、安装并批准两台设备，然后验证虚拟网络 IP（Overlay IP）互通。

来源: https://www.widewired.com.cn/page/docs/quickstart

## 选择站点

网连网络提供中国站和国际站，两站的数据存储位置不同，账号、网络和余额相互独立。注册前按期望的数据存储位置选择站点。本指南介绍中国站的使用方法。

## 准备条件

- 两台 Linux 或 Windows 设备；无需公网 IP，也无需位于同一网络。macOS 与移动设备按[设备](https://www.widewired.com.cn/page/docs/devices)中的应用步骤接入，再继续下文的审批和互通验证。
- 两台设备的管理员权限：Linux 使用 `sudo`，Windows 使用管理员 PowerShell。
- 可访问控制台的浏览器。

## 注册账号

打开[注册登录页](https://www.widewired.com.cn/app/account/login)，使用用户名、密码和手机号注册，再完成短信验证。字段和验证规则见[注册登录](https://www.widewired.com.cn/page/docs/signup)。

## 创建网络

登录后，在控制台顶部网络选择器中选择「新建网络」；首次进入时按创建网络提示操作。填写：

- **名称**：用于识别网络，可随时修改。
- **内网地址段**：虚拟网络地址段（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")
```

安装器会下载并验证软件、完成安装，再用网络编号注册设备。分别在两台设备上执行一次。平台要求见[设备](https://www.widewired.com.cn/page/docs/devices)。

## 批准设备

新设备注册后显示为**待审批**。在「配置 → 设备」核对主机名和平台，然后批准两台设备。状态变为**已批准**后，设备开始建立连接。

## 验证互通

在两台设备上分别运行：

```
wwnet
```

确认 `status` 为 `connected`，并记录 `network address`（虚拟网络 IP）。同一张表里每个对端各占一行 `peers`，标注路径类型和健康状态。

从一台设备访问另一台的虚拟网络 IP：

```
ping <对端虚拟网络 IP>
```

收到响应表示基础网络可达。继续测试实际业务端口，业务所在设备的防火墙和访问权限仍需允许该连接；在「总览」核对当前网络和两台设备。

## 后续操作

- 管理设备状态和地址：[设备](https://www.widewired.com.cn/page/docs/devices)
- 规划更多网络：[属性](https://www.widewired.com.cn/page/docs/networks)
- 查看路径和链路质量：[链路](https://www.widewired.com.cn/page/docs/paths)
- 了解全球专线传输费用：[定价](https://www.widewired.com.cn/page/docs/billing-model)

## 故障速查

| 现象 | 检查与处理 |
| --- | --- |
| 安装命令立即失败 | 确认管理员权限、`curl` 可用，并从「配置 → 设备」重新复制完整命令 |
| `status` 为 `awaiting approval` | 在控制台批准该设备；这是注册后的正常状态 |
| `status` 不是 `connected` | 按状态表中的处理提示和错误码操作 |
| 两台设备无法互通 | 确认两端均已批准、使用的是虚拟网络 IP，并检查虚拟网络地址段是否与本地 LAN 重叠 |

完整处理流程见[故障排查](https://www.widewired.com.cn/page/docs/troubleshooting)。