Shell 在你的服务器上,密钥在你的设备里。
SpectaShell 由两部分组成:一个 SSH 客户端,加上服务器上一个替你守住 shell 的小程序 keeper。它只用你自己的 SSH 登录进入服务器,不开端口,不用 root。私钥不会离开生成它的设备。Calida Lab 的服务器看不到你的终端:我们只运营一台服务器,就是通知中继,而通知在你的服务器上就已用 HPKE 加密,只有你的设备能解开。下面逐条说明这些话具体指什么,以及你怎样自己验证。
~/.local/share/spectashellauthorized_keys 中加入你设备的公钥(注释以 SpectaShell 开头).bashrc、.zshrc 等 shell 配置文件通过 SSH 打开的 shell 是这条连接的子进程。连接一断,它会收到 SIGHUP,里面跑着的任务也跟着结束。tmux 和 screen 靠一个服务器端进程解决这个问题,SpectaShell 的做法类似:每个 shell 都由一个 spectashell-keeper 进程启动并托管。keeper 持有 PTY 和最近的输出,所以连接断开、设备休眠、甚至退出 App,shell 都照常运行;重新连上时,屏幕原样回来。
sshd → spectashell-keeper attach0700 目录中spectashell-keeper attach 接入它。你不需要改任何防火墙规则。keeper 也不主动向外连接,唯一的例外是:你开启通知后,它会通过 HTTPS 把加密的通知发给中继(见 05 · 通知中继)。/tmp/spectashell-<uid>/keepers,Mac 上是 ~/Library/Application Support/SpectaShell/keepers。keeper 会确认它是真实目录而不是符号链接、属于你、权限为 0700,有一项不满足就拒绝启动。其他用户抢先建好同名路径的攻击,也在这一步被挡住。socket 本身的权限是 0600。/tmp,而不是 $XDG_RUNTIME_DIR。最后一个会话登出时,$XDG_RUNTIME_DIR 会被清空,这和“断线后 shell 继续运行”的目的正好冲突。tmux 用 /tmp/tmux-<uid> 也是这个原因。为了不被 systemd-tmpfiles 这类按时间清理的机制删掉,keeper 每小时刷新一次 socket、元数据文件和目录的时间戳;万一还是被删了,它会重新创建。Mac 会定期清理 /tmp,所以放在 Application Support 下。~/.local/share/spectashell/ 下按构建版本区分的目录。选了 “Plain Shells” 的服务器不装任何程序,按普通 SSH 使用。.bashrc、.zshrc 和 fish 配置都不会被修改。TMUX、编程智能体给子进程加的标记,这类变量都不会传下去。在此之上,再设置 TERM=xterm-256color、COLORTERM=truecolor、TERM_PROGRAM=sdTerm。设备密钥每次登录都要 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 iPhoneauthorized_keys 删除某一行时,比对的是密钥本身,而不是注释里的设备名;团队共享加入的行,只动带有该团队标记的那些。你自己加的其他行,一概不动。同步和团队共享都通过设备上已登录的 Apple 账户的 iCloud 完成。Calida Lab 这边没有你的账号,没有你的主机列表,也没有你的密钥。我们唯一运营的通知中继,掌握的也只是设备的通知 token、主机的公钥这类信息(详见 05)。
sha256sum ~/.local/share/spectashell/*/spectashell-keeper 对照。每台设备自己生成密钥。在 iPhone、iPad,以及搭载 Apple 芯片或 T2 芯片的 Mac 上,密钥在 Secure Enclave 中生成,私钥无法导出:SpectaShell 不行,拿着设备的人也不行。没有这类芯片的 Mac,私钥放在标记为不同步的钥匙串项里。每次服务器接受这把密钥,都要先通过 Face ID、Touch ID 或设备密码,才会签名。SpectaShell 不支持导入外部密钥。
为某台服务器开启 agent 转发后,那台服务器可以请你的设备密钥签名,用来登录别的机器,或给 git commit 签名。每次请求都会显示是哪台服务器、要签什么,并单独验证一次 Face ID、Touch ID 或设备密码;对别的请求给出的批准,不会拿来复用。取消一次,这条连接之后的请求都会被拒绝。通过转发的 agent 添加或删除密钥,也不允许。
~/.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,发往它的通知同样停止。
服务器上有程序需要你处理(比如智能体在等你批准),而你没有任何一台设备正看着那个 shell 时,keeper 可以给你的 iPhone 发通知(“Settings ▸ Notifications ▸ Notify This Device”)。问题在于,Apple 只投递持有 App 推送密钥的一方发来的通知,而这把密钥不可能分发到每个用户的服务器上。所以中间有一个 Calida Lab 的中继(push.calidalab.ai)。它从设计上就看不到通知内容。
~/.local/share/spectashell-push 下各对应一个文件,只有你本人可读。里面是签名密钥(在服务器上生成)和这台设备用于加密的公钥。keeper 只在有事要通知时才通过 HTTPS 发送,依然不监听任何端口。0600。命令历史、上次同步状态等 SpectaShell 文件,只有你本人可读。push.calidalab.ai。www.calidalab.ai 请求更新列表(/spectashell/appcast.xml)。请求里只有 App 名称和版本,不发送系统信息。只有用 SpectaShell 专属密钥签名的更新才会安装。iPad 和 iPhone App 通过 App Store 更新。127.0.0.1,同一网络里的其他设备用不了。SpectaShell 放在服务器上的,就是下面这些。服务器上的其他地方,它一概不碰。
~/.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")开头的行authorized_keys 里的行分三种。用密码登录后通过 “Add Key” 加入的设备密钥(SpectaShell on <设备>);已批准的、你各台设备的列表密钥(以 restrict,command=… 开头,以 SpectaShell listing on <设备> 结尾);以及通过 “Who May Log In…” 放行的团队成员的密钥。设备换了新密钥后,App 会删掉这台设备旧密钥的那一行。不能。shell 只在你的设备和你的服务器之间、通过 SSH 传输;同步数据在你的 iCloud 私有数据库里;私钥和密码只在设备上。SpectaShell 不向我们发送任何使用数据,也没有数据分析。Calida Lab 唯一经手的,是你开启通知后经过中继的加密通知,而解密它的密钥只在你的设备上。
都不需要。keeper 以你的账号在家目录里运行,只用 0700 目录里的 Unix socket。唯一的入口是你的 SSH 登录,也不会在系统范围内安装任何东西。
其他普通用户不能。你自己的账号和 root 可以,这和 tmux、screen 一样。如果你不信任某台服务器的管理员,就别在那里的 shell 里放任何机密。
SSH agent 转发的协议特性决定了,那台服务器上的 root 也能使用被转发的 agent。SpectaShell 每次使用设备密钥都会单独要求验证,所以不会被人悄悄使用,服务器也无法借此添加或删除密钥;但 Mac SSH agent 里的密钥会像 ssh 一样不经询问直接转发。只在你信任的服务器上开启。
同步的主机列表和代码片段会被对方拿到。但密钥和密码不同步,对方登录不了你的服务器;新设备的列表密钥在你现有设备批准之前,也不会被放到服务器上。别在代码片段里放密码或 token。
分组共享是 Apple 账户之间的 CloudKit 共享,只有你邀请的人能打开,除非你在系统的共享面板里选择允许任何持有链接的人加入。共享的只有服务器名称和地址,不包括密钥或密码,光靠共享谁也登录不了。谁能登录,由服务器上的 authorized_keys 决定:每个成员用自己的设备密钥,由能登录那台服务器的人放行。把成员放进你的账号,他就能看到并操作这个账号下的所有 shell,所以请给每个人单独开账号。
在 Mac 上打开的本地 shell 必须能访问你的文件,而沙盒 App 里的 shell 做不到。所以它和 iTerm2、Ghostty 一样,用 Developer ID 签名、经 Apple 公证后直接分发。iPad 和 iPhone App 来自 App Store,运行在沙盒里,没有本地 shell,只打开服务器上的 shell。
在另一台设备上打开 “Keys”,在丢失的设备旁边选 “Remove from Every Host…”。所有服务器上那台设备的密钥都会被删掉,发往它的通知也会停止。另外,请在“查找”中抹掉这台设备,并把它从 Apple 账户中移除。
先关闭这台服务器上的所有 shell,然后删除 08 · 服务器上留下的东西 里列出的目录,再从 ~/.ssh/authorized_keys 中删掉注释以 SpectaShell(早期版本为 sdTerm)开头的行。