如何使用 SharkTTY

添加第一台主机

打开「设置」，进入「主机」标签页，点右上角的 +。一台新主机有四项必须填，另外几项一开始可以先不管。

• 「显示名称」「主机名」和「用户」。显示名称只给你自己看；留空就用地址代替。
• 「SSH 端口」。这里是直接输入数字，而不是点步进器。除非服务器监听在别处，保持 22 即可。
• 「认证」→「方式」：密码、密钥、键盘交互 / 2FA，或未选择。
• 「连接方式」：SSH（直接）或 Mosh（加速）。以后随时可以改，其他设置不受影响。

密码有两种方式。「保存密码」把它存进本机的 iOS Keychain；开启同步后，它会经由 iCloud Keychain 端到端地跟着你走，绝不经过我们的服务器。「连接时输入」什么都不存，每次连接都问你一遍。如果服务器会自己发出提示 —— 一次性验证码、硬件令牌 —— 那就改选「键盘交互 / 2FA」：你在连接时逐条作答，什么也不会被保存。

保存主机，然后点它连接。在主机列表里，单击是选中，双击直接连接。

永不离开设备的 SSH 密钥

密钥放在「设置」的「账户」标签页里。点 +，从三条路里挑一条：「生成密钥」「粘贴文本添加」或「从文件导入」。

• 生成：给密钥起个名称，比如 id_ed25519，写个备注，比如 me@iPhone，再选一种算法。Ed25519（推荐）是默认项；ECDSA 和 RSA 留给较老的服务器，而在手机上生成 RSA 4096 要等上几秒。
• 粘贴或导入已有密钥：如果私钥是加密的，添加时输入它的口令。这个口令只用于在设备上推导并保存对应的公钥。
• 装到服务器上：打开密钥，用「复制公钥」或「分享公钥」，把那一行加进主机的 ~/.ssh/authorized_keys，或者交给管理这台机器的人。

私钥留在 iOS Keychain 里。为某个密钥打开「使用 iCloud 同步」，它就会经由 iCloud Keychain 传到你的其他设备 —— 这与 Apple 同步密码走的是同一条端到端通道，不是我们的服务器。如果你登录了 SharkTTY 云账号，主机、脚本、驱动器映射和模板会同步，而密码、私钥和口令明确不会。

回到主机编辑器，「认证」→「方式」→「密钥」就能为这台主机挑选密钥。如果列表是空的，编辑器会直说，并让你先去「账户」标签页。

首次连接的指纹，以及它变了该怎么办

第一次连到一台服务器时，SharkTTY 会取回它的主机密钥，显示 SHA256 指纹，并给出「信任并连接」。请把它和服务器管理员公布的指纹对照，或者和在服务器上执行 ssh-keygen -lf 打印出来的结果对照。你一旦接受，它就被记录下来。

如果这个密钥后来变了，连接会停下并给出警告，而不是继续。老实的解读是：服务器重装过或轮换了密钥，或者有人正坐在你和它中间。只有在你清楚是哪一种时，才使用「信任新密钥并重连」。

如果要主动重新固定一台服务器 —— 比如你自己刚重建过它 —— 打开这台主机，用「清除已记录的主机密钥」。下一次连接会请你从头确认新的指纹。

SSH、Mosh 还是 ET

三者都能给你一个交互式 shell。区别在于服务器端需要准备什么，以及网络在你脚下变动时会发生什么。

Mosh 会预测你输入的内容，让屏幕在服务器回应之前就有反应。「设置」→「终端」→「默认预测模式」提供「自适应」—— 只在链路慢时才开启预测 —— 以及「总是」和「从不」。默认是自适应，对绝大多数人都合适。

ET 仍在测试中，要在「设置」里启用「ET (Eternal Terminal) 传输」之后才会出现。打开后，它会作为第三种连接方式出现在主机编辑器里。有一点需要提前想到：和 Mosh 的 UDP 一样，ET 的数据连接是从设备直接连到 etserver 端口的，不会经过跳板机转发。

回到你离开的那个会话

应用离开屏幕后不久，iOS 就会把它挂起，所以没有哪个移动终端能把一条 TCP 连接一直开着。SharkTTY 分两层来应对。

• 应用会保留它最后看到的那屏内容。重新打开一个断开的标签页，你看到的是那张快照加一个「重新连接」按钮，而不是一片空白。
• Mosh 和 ET 会在服务器一侧把会话本身保住，所以重连之后你回到的正是原地 —— 你离开时命令跑到一半，回来就还是跑到一半的地方。

在任何传输方式下，最靠得住的办法都是在服务器上用一个多路复用器。挂一个像 tmux new -A -s mobile 这样的连接脚本，每次重连都会重新接入同一个会话，而不是开一个新 shell。脚本在下一节。

还有一件小事能省下大量等待：在「设置」里打开「终端响铃系统通知」。当某个终端响铃、而那个会话又不是你正在看的那个时，iOS 会推送一条通知。在长时间运行的命令后面接上 printf '\a'，跑完时手机就会告诉你。

脚本 —— 连接时随手带上的片段

SharkTTY 里的脚本，就是一段在连接建立之后立刻在终端里执行的 shell 文本。「设置」→「脚本」，点 +，然后要么从空白脚本开始，要么选「从模板新建…」。

模板选择器是按人们真正会重连去做的那些事分组的：

• 会话保持 —— tmux、screen 和 zellij，每一个都写成重新接入，而不是再开一个。
• 系统状态 —— 系统总览，或者用 htop 做资源监视。
• 日志 —— 跟踪系统日志，或者跟踪某一个文件。
• 容器 —— Docker 容器、Compose 服务、容器日志。
• 服务管理 —— 服务状态与重启。
• 系统更新 —— Debian/Ubuntu、RHEL/Fedora、Alpine 和 Arch 各有各的模板。
• 备份 —— rsync 增量备份，或者运行你自己的备份脚本。

给主机设好「平台」，选择器就会自动收窄到适合那台机器的模板，不会在 Alpine 机器上给你 apt。模板生成的内容都可以再改，用「存为模板」把你自己的版本留到下次。

在主机编辑器里给主机挂上脚本，每次连接都会执行它。也可以让主机保持干净，连接时再选：主机列表里，「以脚本连接」和「直接连接」是两个独立的操作，双击某个脚本就用它连接。

输入：键盘辅助栏与悬浮键盘

系统键盘上方是一条键盘辅助栏，放着终端需要而 iOS 没有的键：Esc、Ctrl、Tab 和方向键，另外还有上传文件、显示或收起键盘、以及打开指点设备的按钮。

「设置」→「键盘」→「输入板」可以在系统键盘和「透明」—— SharkTTY 自带的屏幕键盘 —— 之间切换。这块悬浮键盘是一整块键盘，而不是一条：符号、Tab、回车、⌃⌥⌘ 修饰键、fn 键和 F 功能键，像真键盘那样排布，回车是跨两行的 L 形。你可以把它拖到任何位置、调整大小，并用设置浮层里的透明度滑块让它在终端上淡下去 —— 也可以一路调到完全不透明，如果你根本不想透过它看东西。

同一处设置里的「排列」涵盖美式英语、英式英语、日语 JIS、法语 AZERTY、德语 QWERTZ 和西班牙语。按键上方有一条候选栏，会随着你的输入给出可能的词和常用命令。顶栏的麦克风按钮有两种用法：轻点切换到语音板，长按则是按住说话，直接把结果送进候选栏。

「鼠标上报」决定触控板归谁。打开时，外接触控板或鼠标的点击和拖动会送给能理解它们的程序 —— vim、tmux、htop、less。关闭时，指针改为选择文本。只有在程序确实开启了鼠标支持时，这个开关才有区别。在 iPad 上，外接键盘和触控板全程可用。

语音输入，以及把话变成命令的 AI

按住麦克风说话。识别在设备本地进行：免费、离线、即时，什么都不往外送。听到的内容会作为可编辑文本落在语音板里，「注入」把它敲进终端。

录音按片段保存，所以你可以裁掉一段、只对那一段「重新识别」，而不必把整句重说一遍。「历史记录」保留过往录音，可以试听，也可以再识别一次。在 iPad 上，语音板像透明键盘一样悬浮，也能缩放。

AI 是可选的，也和识别相互独立。在「设置」里用你自己的密钥添加一个提供商 —— 支持 OpenAI、Claude、Gemini、Kimi 和 GLM 的 API 格式 —— 设好对话模型，如果这家提供商有转写模型，也一并设上。Claude 只做对话、没有音频 API，所以在它那里录音会回落到本地识别。提供商密钥留在本机 Keychain，绝不同步。

接上提供商之后，提示词模式会把你说的话改写成整洁的文本，或者一条可以直接跑的命令；「附带终端上下文」则让模型在回答前看到屏幕上的内容。对话面板把一段对话放在会话旁边，让你不用离开就能问。

如果你不想自备密钥，登录 SharkTTY 账号后就能使用官方云端模型。它们用点数支付，点数通过应用内购买获得，并在你的各台设备之间共享。无论走哪条路，本地识别始终免费。

传输文件

把文件送上服务器有两条路，适合的场合不一样。

• 在会话里：键盘辅助栏上的「上传文件」按钮会把文件直接送到当前工作目录。上限是每个文件 64 MB，而且主机必须有一份应用能重复使用的凭据 —— 只用一次性验证码登录的服务器没法这么用。
• 从主机列表：「通过 SFTP 浏览文件」会在那台服务器上打开一个文件管理器，可以新建文件夹、上传、下载，遇到重名时还会让你确认是否覆盖。

「设置」里的「文件」标签页把设备能访问到的存储映射成驱动器：iCloud Drive、共享文件夹、应用本地文件夹，或者按 URL 添加的 WebDAV 服务器。映射之后，驱动器就能在同一个文件管理器里浏览 —— 一份文件从 NAS 走到服务器，中间不需要一台笔记本。

一块屏幕上的多个会话

连接以标签页的形式打开，可以重命名。「平铺所有连接」把它们一起显示；「左右拆屏」和「上下拆屏」把两个并排放；「聚焦此连接」再把其中一个放回全尺寸。在 iPad 上，这是「盯着一次部署」和「一边跑部署一边看日志」之间的差别。

远程桌面和终端住在同一个工作区里，所以一个 Mac 会话和三个 shell 可以共享同一张网格。

通过堡垒机连到主机

在主机编辑器里设置「跳板机 (ProxyJump)」，就会先连到堡垒机，再经由它到达真正的主机。跳板机用它自己保存的密钥或密码做非交互式认证；要求键盘交互登录的堡垒机目前还不支持。

只有 SSH 连接会经过跳板机。Mosh 的 UDP 和 ET 的数据连接都是从设备直连目标 —— 在你打算从网络外部依赖它们之前，这一点值得先确认。