登录、切换与恢复
先确认当前账号与网络、是否同时运行了 App 和命令行,再按下面的顺序排查。
退出登录结束当前账号会话,不等于删除 Device、Node 或其他账号 Profile。
普通重置修复运行时、路由、DNS 或 TUN 状态,默认保留身份与 Profiles。
完整重置把本机作为新 Device 注册;仅在身份确实废弃时使用。
推荐顺序
info核对版本、Device、NSD、Space 与运行持有者;status --all核对连接和当前数据;doctor只读检查权限、DNS、进程和 NSD 可达性;- 必要时
ns down,关闭 App 后重试; - 系统网络残留时执行普通
ns reset; - 只有身份本身必须废弃时才
ns reset --all --yes。
不要用完整重置代替诊断
完整重置会改变设备身份和后续 Node 注册关系。遇到无法退出、切换或连接时,请先尝试关闭重复实例并重启客户端;仍无法恢复时,保留日志联系支持,不要直接删目录或重装。
先判断要恢复哪一层
多账号登录异常
退出 A 账号后登录 B 账号时,先取消尚未完成的登录,关闭旧授权页面,再从 App 重新发起。若一直“等待授权”,核对浏览器当前账号后重试。不要直接卸载 App:系统安全存储可能在卸载后仍然保留。
Space 切换卡住
切换时请等待完成,或在出现取消选项后取消。之后核对当前生效的 Space。CLI 可执行:
切换成功后,确认当前网络正确,再用 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 状态与客户端一致,没有重复连接。