登录、切换与恢复

先确认当前账号与网络、是否同时运行了 App 和命令行,再按下面的顺序排查。

退出登录结束当前账号会话,不等于删除 Device、Node 或其他账号 Profile。
普通重置修复运行时、路由、DNS 或 TUN 状态,默认保留身份与 Profiles。
完整重置把本机作为新 Device 注册;仅在身份确实废弃时使用。

推荐顺序

ns info
ns status --all
ns doctor
  1. info 核对版本、Device、NSD、Space 与运行持有者;
  2. status --all 核对连接和当前数据;
  3. doctor 只读检查权限、DNS、进程和 NSD 可达性;
  4. 必要时 ns down,关闭 App 后重试;
  5. 系统网络残留时执行普通 ns reset;
  6. 只有身份本身必须废弃时才 ns reset --all --yes。
不要用完整重置代替诊断

完整重置会改变设备身份和后续 Node 注册关系。遇到无法退出、切换或连接时,请先尝试关闭重复实例并重启客户端;仍无法恢复时,保留日志联系支持,不要直接删目录或重装。

先判断要恢复哪一层

现象首选动作不应先做
登录授权未完成取消当前登录,关闭旧授权页面,再重新登录卸载 App、删除 Device
登录正常但资源来自旧 Space保持断开,重新确认并切换 Space继续连接后再观察
连接 busy 或一直正在启动等待当前事务结束,关闭重复实例,必要时 ns down连续点击开关、完整重置
系统路由、DNS 或 TUN 残留正常 down/退出后执行普通 reset直接 reset --all
身份确实损坏或设备退役记录 Device/Node ID 后完整重置,并在 NSD 清理旧记录假设卸载等于完整重置

多账号登录异常

退出 A 账号后登录 B 账号时,先取消尚未完成的登录,关闭旧授权页面,再从 App 重新发起。若一直“等待授权”,核对浏览器当前账号后重试。不要直接卸载 App:系统安全存储可能在卸载后仍然保留。

Space 切换卡住

切换时请等待完成,或在出现取消选项后取消。之后核对当前生效的 Space。CLI 可执行:

ns info
ns space list
ns space switch <NETWORK_ID>

切换成功后,确认当前网络正确,再用 ns up 连接。若界面显示目标 Network,但资源仍来自旧 Network,保持断开并反馈。

连接返回 busy

先等待当前登录或切换完成;若持续 busy,关闭重复 App 实例,或执行 ns down 后重连。不要连续快速点击连接开关。仍无法恢复时,记录发生时间和日志,联系支持。

卸载与完整重置的区别

卸载通常删除 App 文件,但钥匙串/系统安全存储、系统 VPN 配置或共享状态可能保留。普通更新和普通 reset 应保留身份。只有确认要让服务端把本机视为新 Device 时,才完整重置并在 NSD 清理旧 Device;操作前记录 Node/Device ID 以便审计。

退出登录、切换账号和重置前,先断开连接。桌面端确认没有同时运行的 App 和命令行连接;移动端确认系统 VPN 配置与 App 中选择的网络一致。若加载提示一直不消失,保存日志后重新打开 App。

反馈最小材料

  • 发生时间与时区;
  • App/ns --version;
  • 平台与 OS 版本;
  • 预期 Space(Organization + Network)和实际界面状态;
  • ns doctor、ns info --json(上传前移除任何敏感字段);
  • 一张错误界面或短录屏。不要上传 token、私钥、完整邀请或真实客户数据。

恢复完成标准

状态可信界面、ns info 与 ns status --all 指向同一账号和 Space。
操作可重试失败弹层或加载遮罩已退出,登录、切换、连接和退出可再次执行。
网络恢复断开后本机正常上网,系统 VPN 状态与客户端一致,没有重复连接。