Astra Shell 文档下载 macOS
文档目录 当前:Shell 与多端接续

文档 / 日常使用 / Shell 与多端接续

EVERYDAY · SHELL

一个 Shell,从不同设备继续。

Shell 是一个由远端长期持有的交互终端。设备负责进入和显示它,而不是决定它是否继续存在。

生命周期

创建 Shell 时,服务端生成一个 Terminal,持有 PTY、进程和权威终端状态。关闭一个客户端窗口只会移除对应的 Attachment,不会自动终止 Terminal。

创建 Terminal→设备 Attach→暂时断开→再次 Attach

断开与恢复

连接恢复后,客户端用 canonical UUID 找回仍在运行的 Terminal,并接收当前状态。支持 input_resume v2 的服务器可验证同设备 Keychain 中的恢复凭据;凭据缺失、失效或不可用时保持只读,由用户明确接管。恢复身份不通过 iCloud 同步,也不承诺所有网络切换都无缝。

多设备进入

电脑和手机可以进入同一个 Shell,看到同一份服务端权威状态。某一时刻由 Controller 持有输入与 resize 权限,其余 Attachment 作为 Viewer 保持可见;需要时可以安全接管。

重启边界

  • 客户端退出或网络中断:Terminal 继续运行。
  • Managed gateway 重启:仅兼容的同版 worker 可复用;跨内部协议版本升级需要冷维护,不能保证 PTY 继续。
  • 用户 worker 或整台服务器重启:当前不会从磁盘恢复正在运行的 Terminal。