交互式终端与 SSH

Web 终端（控制台）

沙箱详情页的终端 tab 是真 PTY：按键、窗口尺寸、输出流与本地终端一致，适合在浏览器里直接操作。

SSH

先在控制台「设置 → SSH 密钥」注册公钥（或创建沙箱时内联注册；对应接口见凭证与密钥）， 然后按沙箱详情页「SSH 连接」卡给出的命令连接（地址与端口以卡片为准，不同部署不同）。

没有「SSH 连接」卡？ 说明当前部署没有开启 SSH 直连（宿主侧 SSH 服务默认关闭）。 这不是公钥或绑定的问题，也不影响 Web 终端与 CLI；需要 SSH 请联系平台管理员。 「服务」tab 的入向发布只反向代理 HTTP，不能用来连 SSH。

SSH 的边界（刻意的取舍，不是缺失）：

• 只做 shell 与 exec；sftp、端口转发（-L / -R）、agent 转发不支持；
• 公钥是唯一认证方式（不走密码、不走 DNS —— 用实例地址直连）。

CLI：直接起交互程序

rayrun exec -it demo

跑的是镜像声明的交互程序（claude-code@1 即 Claude Code），不接受另指定命令。

三种方式之上是同一套终端会话 API（POST /sandboxes/{id}/terminals 等）， 需要自己接前端时见 执行与终端。