# 核心概念

> 账号、网络、设备、链路、路径与预付额度之间的关系。

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

## 账号

一个账号管理自己的网络、额度和账单。目前不支持邀请其他成员共同管理账号；切换网络不会改变账号和余额。

## 网络

网络是隔离的组网单元。一个账号可以创建多个网络，各网络的设备、链路和配置互不可见。

每个网络包含：

- **名称**：显示名称，可修改。
- **内网地址段**：虚拟网络地址段（Overlay CIDR），用于分配虚拟网络 IP（Overlay IP），不得与账号下其他网络重叠。
- **网络编号**：12 位小写字母和数字，供设备注册使用。

网络编号是标识符，不是密钥。持有编号的设备只能发起注册，必须通过控制台审批才能进入网络。

## 设备

设备是安装软件并注册到某个网络的主机。一个安装实例同时只能属于一个网络。

在「配置 → 设备」管理审批与访问权限，主要状态如下：

| 状态 | 含义 |
| --- | --- |
| 待审批 | 已注册，尚未获得通信权限 |
| 已批准 | 正常参与组网和路径选择 |
| 已阻断 | 访问被暂停，设备记录仍保留 |

## 链路

链路是同一网络内两台已批准设备之间的逻辑连接。设备获批后，系统自动生成它与其他设备的链路；无需手工创建或命名。

在「配置 → 链路」调整允许使用的连接方式和切换敏感度；在「总览」查看当前路径，在「洞察 → 传输」查看质量趋势。

## 三种路径

系统按以下顺序选择可用路径，并根据质量自动切换：

| 路径 | 说明 | 费用 |
| --- | --- | --- |
| 直连（`direct`） | 两台设备直接建立端到端加密连接 | 免费 |
| 网内设备转发（`peer_relay`） | 由同一网络中的另一台设备转发 | 免费 |
| 全球专线传输（`cloud_relay`） | 由网连网络骨干转发 | 按成功转发的流量计费 |

禁用的路径不会进入候选。无论使用哪种路径，设备间流量均为端到端加密，中继只负责转发密文数据包。

## 预付额度

在「账户 → 账单」查看账号级余额，分为：

- **赠送额度**：注册首次验证成功赠送 ¥10；上月有已批准设备上线的账户，每月 1 日（北京时间）再赠送 ¥10，每账户每月一次；发放时账户需要至少有一条两端均为已批准设备、且已开启全球专线传输的链路。奖励活动入账也计入此类额度。
- **购买额度**：充值获得。

全球专线传输用量先扣赠送额度，再扣购买额度。额度耗尽只会阻止新的全球专线传输转发，不影响账号、设备、直连或网内设备转发。详见[定价](https://www.widewired.com.cn/page/docs/billing-model)。

## 终端软件

在 Linux 和 Windows 上，终端软件安装后会在后台保持连接；使用 `wwnet` 命令查看状态、更新或卸载。macOS 使用 App Store 中的应用，Android、iOS 和 HarmonyOS 使用移动应用连接。macOS 与移动设备不作为转发出口，也不运行设备自动化脚本；网内设备转发在所有平台都可开关，Linux、Windows 和 macOS 默认开启，iPhone、Android 和 HarmonyOS 默认关闭。

网络和策略配置统一在控制台完成。桌面和服务器端的命令用法见[设备](https://www.widewired.com.cn/page/docs/devices)中的命令行参考。

## 能力边界

网连网络用于连接你拥有或管理的设备与站点。需要出口转发时，使用自有的 Linux 或 Windows 设备作为出口；WideWired 不提供公共代理出口。

## 故障速查

| 现象 | 对应概念与入口 |
| --- | --- |
| 设备已注册但不能通信 | 检查设备是否仍为**待审批**，见[设备](https://www.widewired.com.cn/page/docs/devices) |
| 直连失败但链路仍可用 | 系统可能已切换到网内设备转发或全球专线传输，见[链路](https://www.widewired.com.cn/page/docs/paths) |
| 全球专线传输不可用 | 检查额度、工作时段和账号状态，见[定价](https://www.widewired.com.cn/page/docs/billing-model) |
| 设备需要加入另一个网络 | 先执行 `wwnet leave`，再使用新网络的安装命令 |