SpectaShell 图标 SpectaShell · 安全

安全

Shell 在你的服务器上,密钥在你的设备里。

SpectaShell 由两部分组成:一个 SSH 客户端,加上服务器上一个替你守住 shell 的小程序 keeper。它只用你自己的 SSH 登录进入服务器,不开端口,不用 root。私钥不会离开生成它的设备。Calida Lab 的服务器看不到你的终端:我们只运营一台服务器,就是通知中继,而通知在你的服务器上就已用 HPKE 加密,只有你的设备能解开。下面逐条说明这些话具体指什么,以及你怎样自己验证。

会做的

  • 用你的 SSH 登录连接服务器
  • 只在你同意的服务器上,把 keeper 装进 ~/.local/share/spectashell
  • 在 authorized_keys 中加入你设备的公钥(注释以 SpectaShell 开头)
  • 把主机列表等设置同步到你的 iCloud 私有数据库
  • 仅在你开启通知时,把加密后的通知发给中继

不会做的

  • 在服务器或设备上开端口
  • 使用 root 或 sudo,安装系统服务
  • 修改 .bashrc、.zshrc 等 shell 配置文件
  • 保存密码,或发送私钥和密码
  • 收集使用统计、做数据分析、追踪
01 · keeper

服务器上运行的程序:spectashell-keeper

通过 SSH 打开的 shell 是这条连接的子进程。连接一断,它会收到 SIGHUP,里面跑着的任务也跟着结束。tmux 和 screen 靠一个服务器端进程解决这个问题,SpectaShell 的做法类似:每个 shell 都由一个 spectashell-keeper 进程启动并托管。keeper 持有 PTY 和最近的输出,所以连接断开、设备休眠、甚至退出 App,shell 都照常运行;重新连上时,屏幕原样回来。

你的 Mac、iPad、iPhone

  • SpectaShell
  • Secure Enclave 中的设备密钥
→ssh user@host

你的服务器,以你的账号运行

  • sshd → spectashell-keeper attach
  • keeper → shell(PTY)
  • Unix socket,位于 0700 目录中
  • 没有网络端口,没有 root
02 · 列表密钥

不用 Face ID、只能查看 shell 列表的密钥

设备密钥每次登录都要 Face ID。可 App 的 “Running” 页面要随时查看每台服务器上有哪些 shell 在运行,所以每台设备还有第二把密钥:签名时不询问的列表密钥。它只能做一件事,就是查询 keeper 列表;这个限制由服务器上的 sshd 强制执行,不靠 App。

列表密钥在 ~/.ssh/authorized_keys 中的那一行。restrict 关闭 PTY 分配,以及端口、agent、X11 转发;command= 让服务器无论客户端请求什么,都只执行这一条命令。打不开 shell,也传不了文件。
restrict,command="$HOME/.local/share/spectashell/current/spectashell-keeper list" ecdsa-sha2-nistp256 AAAA… SpectaShell listing on iPhone
没有账号,
也就无从泄露。

没有注册,没有登录,没有密码数据库。

同步和团队共享都通过设备上已登录的 Apple 账户的 iCloud 完成。Calida Lab 这边没有你的账号,没有你的主机列表,也没有你的密钥。我们唯一运营的通知中继,掌握的也只是设备的通知 token、主机的公钥这类信息(详见 05)。

03 · 验证 keeper

怎样确认服务器上跑的是什么

04 · 密钥与认证

私钥在芯片里,密码哪里都不存

设备密钥(ECDSA P-256)

每台设备自己生成密钥。在 iPhone、iPad,以及搭载 Apple 芯片或 T2 芯片的 Mac 上,密钥在 Secure Enclave 中生成,私钥无法导出:SpectaShell 不行,拿着设备的人也不行。没有这类芯片的 Mac,私钥放在标记为不同步的钥匙串项里。每次服务器接受这把密钥,都要先通过 Face ID、Touch ID 或设备密码,才会签名。SpectaShell 不支持导入外部密钥。

会先问你的 agent 转发

为某台服务器开启 agent 转发后,那台服务器可以请你的设备密钥签名,用来登录别的机器,或给 git commit 签名。每次请求都会显示是哪台服务器、要签什么,并单独验证一次 Face ID、Touch ID 或设备密码;对别的请求给出的批准,不会拿来复用。取消一次,这条连接之后的请求都会被拒绝。通过转发的 agent 添加或删除密钥,也不允许。

Mac 上的 ~/.ssh 只读不写

在 Mac 上,SpectaShell 像 ssh 一样读取 ~/.ssh/config、~/.ssh 里的密钥、SSH agent 和 known_hosts,从不修改、复制或上传。但要注意:Mac SSH agent 里的密钥会像 ssh 那样不经询问直接转发,所以只在你信任的服务器上开启转发。

不保存密码

密码、密钥口令、一次性验证码,都是用到时问你,交给登录过程后立即丢弃。对话框上也写着 “Not stored anywhere”。输入框支持系统的自动填充,“密码” App 或 1Password 可以填入密码和一次性验证码:保存密码的是这些密码管理器,不是 SpectaShell。用密码登录一次后,App 会提议把设备密钥加到服务器上,以后直接用密钥登录。

主机密钥校验

做法和 OpenSSH 一样。第一次连接时显示密钥类型和指纹,问你是否信任。信任过的密钥会同步到你的其他设备。密钥一旦变化,所有设备都拒绝连接;只有你主动执行 “Forget Old Key…”,才会接受新密钥。在 Mac 上,~/.ssh/known_hosts 里已有的主机也照样信任。

设备丢了怎么办

在另一台设备上打开 “Keys”,在丢失的设备旁边选 “Remove from Every Host…”,SpectaShell 会登录主机列表里的每台服务器,删掉那台设备的密钥。当时没开机的服务器,会在你的设备下次登录时删掉。这些密钥不会再被放回任何服务器,那台设备也无法再列出你的 shell,发往它的通知同样停止。

05 · 通知中继

我们唯一的服务器,以及它看不到的东西

服务器上有程序需要你处理(比如智能体在等你批准),而你没有任何一台设备正看着那个 shell 时,keeper 可以给你的 iPhone 发通知(“Settings ▸ Notifications ▸ Notify This Device”)。问题在于,Apple 只投递持有 App 推送密钥的一方发来的通知,而这把密钥不可能分发到每个用户的服务器上。所以中间有一个 Calida Lab 的中继(push.calidalab.ai)。它从设计上就看不到通知内容。

你服务器上的 keeper

  • 用你设备的公钥加密通知
  • 用主机专属的 Ed25519 密钥签名请求
→HTTPS

中继 → APNs

  • 验证签名后,把密文原样转发
  • 不保存内容
→APNs

你的 iPhone

  • 用设备私钥解密
  • 主机名取自设备自己的记录

中继知道的

  • 你设备的通知 token
  • 给这台设备发通知的主机的公钥(因此也知道有几台主机)
  • 每台主机什么时候发、发得多频繁
  • 大小完全相同的密文
  • 请求的 IP 地址。不做记录。前面的 Cloudflare 也能看到同样的内容。

中继永远不知道的

  • 通知内容
  • 是哪台服务器(名称、地址)
  • 你的命令和 shell 的输出
  • 任何文件
  • 任何用于签名或解密的私钥
06 · 数据

哪些会同步,哪些只留在设备上

同步到你的 iCloud 私有数据库

  • 主机和分组、代码片段、触发器
  • 保存的端口转发、收藏的文件夹
  • 添加的云(不含凭据)
  • 信任的主机密钥、你各台设备的公钥
  • 终端字体和主题
  • 通知规则、通知用的主机公钥

不会离开设备

  • 私钥(设备密钥、列表密钥)
  • 密码、密钥口令、一次性验证码(根本不保存)
  • shell 的输出
  • 命令历史(可能混有 token,只在本机保留 30 天)
  • 窗口、标签页、字号等本机专属设置
07 · 网络

SpectaShell 会连接的所有地方

08 · 服务器上留下的东西

查看并删除装上去的东西

SpectaShell 放在服务器上的,就是下面这些。服务器上的其他地方,它一概不碰。

SpectaShell 放在服务器上的东西。删除之前,先关闭这台服务器上的所有 shell。
~/.local/share/spectashell/           # keeper 程序(按构建版本分目录)和 shell 集成脚本
~/.local/share/spectashell-push/      # 仅在开启通知时:每台接收设备一个文件
/tmp/spectashell-$(id -u)/            # Linux:keeper 的 socket 和元数据
~/Library/Application Support/SpectaShell/keepers/   # Mac 服务器:同上
~/.ssh/authorized_keys                # 注释以 "SpectaShell"(早期版本为 "sdTerm")开头的行
09 · 常见问题

安全 Q&A

Calida Lab 能看到我的 shell、服务器列表或密钥吗?

不能。shell 只在你的设备和你的服务器之间、通过 SSH 传输;同步数据在你的 iCloud 私有数据库里;私钥和密码只在设备上。SpectaShell 不向我们发送任何使用数据,也没有数据分析。Calida Lab 唯一经手的,是你开启通知后经过中继的加密通知,而解密它的密钥只在你的设备上。

需要在服务器上开端口,或者用 root 吗?

都不需要。keeper 以你的账号在家目录里运行,只用 0700 目录里的 Unix socket。唯一的入口是你的 SSH 登录,也不会在系统范围内安装任何东西。

同一台服务器上的其他用户能进入我的 shell 吗?

其他普通用户不能。你自己的账号和 root 可以,这和 tmux、screen 一样。如果你不信任某台服务器的管理员,就别在那里的 shell 里放任何机密。

开启 agent 转发安全吗?

SSH agent 转发的协议特性决定了,那台服务器上的 root 也能使用被转发的 agent。SpectaShell 每次使用设备密钥都会单独要求验证,所以不会被人悄悄使用,服务器也无法借此添加或删除密钥;但 Mac SSH agent 里的密钥会像 ssh 一样不经询问直接转发。只在你信任的服务器上开启。

Apple 账户被盗了会怎样?

同步的主机列表和代码片段会被对方拿到。但密钥和密码不同步,对方登录不了你的服务器;新设备的列表密钥在你现有设备批准之前,也不会被放到服务器上。别在代码片段里放密码或 token。

和团队成员共享分组,会共享什么?

分组共享是 Apple 账户之间的 CloudKit 共享,只有你邀请的人能打开,除非你在系统的共享面板里选择允许任何持有链接的人加入。共享的只有服务器名称和地址,不包括密钥或密码,光靠共享谁也登录不了。谁能登录,由服务器上的 authorized_keys 决定:每个成员用自己的设备密钥,由能登录那台服务器的人放行。把成员放进你的账号,他就能看到并操作这个账号下的所有 shell,所以请给每个人单独开账号。

Mac App 为什么不用沙盒?

在 Mac 上打开的本地 shell 必须能访问你的文件,而沙盒 App 里的 shell 做不到。所以它和 iTerm2、Ghostty 一样,用 Developer ID 签名、经 Apple 公证后直接分发。iPad 和 iPhone App 来自 App Store,运行在沙盒里,没有本地 shell,只打开服务器上的 shell。

iPhone 丢了怎么办?

在另一台设备上打开 “Keys”,在丢失的设备旁边选 “Remove from Every Host…”。所有服务器上那台设备的密钥都会被删掉,发往它的通知也会停止。另外,请在“查找”中抹掉这台设备,并把它从 Apple 账户中移除。

怎样把 SpectaShell 从服务器上彻底删干净?

先关闭这台服务器上的所有 shell,然后删除 08 · 服务器上留下的东西 里列出的目录,再从 ~/.ssh/authorized_keys 中删掉注释以 SpectaShell(早期版本为 sdTerm)开头的行。

报告安全问题
返回概览 → 下载 Mac 测试版加入 iPad 和 iPhone 测试免费 · 支持 macOS 15、iPadOS 18、iOS 18 及更高版本