# NetSeed App

NetSeed App 支持 iOS、Android、macOS 和 Windows。登录后选择组织与网络，即可连接获授权的节点、服务和出口。

<div class="guide-overview">
  <div><strong>账号</strong><span>退出登录不会删除设备身份；再次登录后可继续使用该账号的网络。</span></div>
  <div><strong>当前网络</strong><span>Space 是 Organization + Network 的组合，决定你能看到和访问哪些资源。</span></div>
  <div><strong>一次一个连接</strong><span>使用 App 前请断开本机的 <code>ns</code> 命令行连接，反之亦然。</span></div>
</div>

## 主界面

| 区域      | 可以做什么                                  |
| ------- | -------------------------------------- |
| 连接开关    | 连接或断开当前网络                              |
| 当前组织与网络 | 查看所在的 Organization 和 Network，切换到其他可用网络 |
| 账号      | 查看当前登录者、切换或退出账号                        |
| 服务      | 查找自己发布或获授权的服务                          |
| 节点      | 查看本机及获授权节点的地址与域名                       |
| 出口      | 选择获授权的互联网出口                            |
| 设置      | 调整连接选项，查看活动日志与版本信息                     |

## 登录与切换 Space

1. 点击登录，在浏览器中确认账号并完成授权，返回 App。详见[登录与设备授权](/getting-started/realm-owner-activation.md)。
2. 打开组织与网络选择器，选择要使用的 Space。只有一个可用 Space 时无需切换。
3. 等待切换完成，确认组织、网络及资源列表正确，再打开连接开关。切换后不会自动连接。

切换耗时较长时，可在出现取消选项后取消。若界面与资源列表不一致，保持断开，按[恢复指南](/clients/nsc-recovery.md)处理。

## 节点与服务

- **节点**支持“我的节点”和“已授权给我的节点”两个范围；授权整个 Node 后可见其 L3 信息并按策略访问。
- **服务**目录可能在未连接时仍可见，因为授权目录可独立刷新；真正访问私网服务仍要求当前 Space 已连接。
- 找不到预期服务时，先核对当前 Network，再请管理员检查访问授权。

## 出口交互

先在出口页选择一个已授权出口，再打开出口开关。看到 **请先选择出口** 时，返回列表完成选择；按提示重新连接后使用该出口。

## 高级连接设置

默认 **自动** 适合大多数网络。数据传输可在 WG/WSS 间自动选择；控制通道可在 SSE、Noise、QUIC 中按 NSD 广告能力和信任 pin 选择。强制某个模式仅用于排障，企业代理、UDP 限制和平台 VPN 权限都可能影响结果。

信任 pin 用于确认 NSD 服务身份，切换 Organization 或 Network 不需要修改。遇到信任不匹配时，请向管理员核实服务地址与证书变更，不要关闭校验。

## App 与命令行同时安装

App 与 `ns` 命令行分别安装和更新，但不能同时管理本机网络连接。需要改用 CLI 时先在 App 断开并退出；CLI 的 `ns update` 不会更新 App，App 更新也不会替换系统 `ns`。

## 更新兼容性

从[官网下载页](https://www.haiyand.com/download.html)获取对应平台的更新。正常更新会保留设备身份、账号和网络配置；遇到异常先记录版本和日志，退出并重新打开 App，再按[恢复指南](/clients/nsc-recovery.md)处理。不要直接删除状态目录或完整重置设备。
