Guide

入门指南

MTerm 的独特之处,以及如何开始使用 — 从添加主机到终端基础操作

MTerm 入门指南

MTerm 是一款专为 iPad 和 iPhone 打造的 SSH 客户端,专门为使用 Claude Code、Cursor 和 Aider 等 AI 终端工具的开发者设计。与其他将移动端视为附属品的 SSH 应用不同,MTerm 让你的平板真正成为一台强大的开发设备。


为什么选择 MTerm?

App Store 上有很多 SSH 客户端。以下是 MTerm 的独特之处:

原生窗格分割

无需依赖 tmux,即可将屏幕分割为最多四个终端。每个窗格运行独立的会话,你可以自由组合终端、文件编辑器、文件浏览器或提示词面板。拖拽边框即可调整大小,简单直观。

精确的 CJK 字符渲染

中文、日文和韩文字符以正确的双字宽度渲染。这看似小事,但当你用过渲染不准确的 SSH 客户端后就会明白 — 光标错位、文字重叠、输出乱码随处可见。MTerm 做到了精确渲染,因为渲染引擎专门为此进行了重写。

tmux 鼠标模式集成

MTerm 自动检测 tmux 是否启用了鼠标模式,并将你的触控手势直接转发 — 轻触切换窗格,滑动浏览历史记录。无需任何配置。它会自动识别 set -g mouse on 并正确响应。

Mosh 支持

在 Wi-Fi 不稳定的咖啡馆工作?在列车上切换基站信号?Mosh 能在网络变化时保持你的会话活跃。MTerm 原生实现了 Mosh 协议,因此你的连接可以在 Wi-Fi 和蜂窝网络之间切换而不丢失任何按键。

内置文件浏览器和编辑器

通过 SFTP 浏览远程文件系统、预览图片,并使用语法高亮编辑代码 — 一切都在应用内完成。编辑器支持 11 种语言,采用 VSCode Dark+ 配色方案。

IDE 模式

将终端、文件浏览器和编辑器整合到一个界面中。在一个窗格中编辑代码,在另一个窗格中运行,在第三个窗格中浏览文件。这对 Claude Code 工作流特别有用,你可以在 AI 仍在工作时同时查看生成的代码。

命令面板

Cmd+Shift+P 即可快速访问任何操作 — 分割窗格、打开设置、切换主题、切换专注模式等。如果你习惯使用 VS Code,会立刻感到熟悉。

Webhook 通知

设置推送通知,当 Claude Code 完成任务、CI/CD 流水线完成或服务器发出警报时触发。你可以完全离开应用,在需要关注时收到通知。

iCloud 同步

你的主机配置、连接设置和偏好会自动在所有设备间同步。在 iPad 上设置一台主机,iPhone 上即可使用。


添加 SSH 主机

第 1 步:创建主机

在主屏幕上点击 添加主机 按钮。填写连接详情:

字段说明
主机名服务器的 IP 地址或域名(例如 192.168.1.100dev.example.com
端口SSH 端口号。通常为 22,除非你的服务器配置了不同的端口
用户名远程服务器上的登录用户名
认证方式密码或 SSH 密钥(强烈推荐使用密钥认证)

第 2 步:设置 SSH 密钥认证

MTerm 支持以下密钥格式:

  • Ed25519 — 推荐使用。现代、快速且安全。如果你要生成新密钥,请选择此格式。
  • RSA PKCS#1 — 传统格式,以 -----BEGIN RSA PRIVATE KEY----- 开头。兼容性广泛。
  • RSA OpenSSH — 较新的 OpenSSH 格式,以 -----BEGIN OPENSSH PRIVATE KEY----- 开头。同样完全支持。

所有私钥都安全地存储在 iOS 钥匙串中,受设备硬件安全保护。密钥永远不会离开设备,也不会包含在 iCloud 备份中。

要导入密钥,你可以直接粘贴、从文件导入或使用剪贴板。

第 3 步:高级连接选项

MTerm 支持多种高级配置,适用于更复杂的设置:

  • 跳板机(堡垒机):当目标机器无法直接访问时,通过中间服务器连接。MTerm 会为你处理多跳 SSH 链,包括通过跳板机的 RSA-SHA256 认证。
  • 端口转发:设置本地端口转发(将远程服务当作本地服务访问)或远程端口转发(将本地服务暴露给远程网络)。转发配置按主机保存并自动重连。
  • 自定义图标:为每台主机分配独特的图标,让你一眼就能区分生产服务器、预发布环境和开发机器。
  • iCloud 同步:主机配置自动在所有设备间共享。在 iPad 上添加主机,在 iPhone 上即可连接。

终端基础

点击任意主机即可建立 SSH 连接。连接成功后,终端视图打开,你就可以开始工作了。

滚动

完全支持触控和触控板滚动。在屏幕上单指滑动,或在 Magic Keyboard 触控板上双指滑动。滚动缓冲区最多可存储 5,000 行 历史记录(默认为 1,000 行,可在设置中调整)。

复制文本

在终端任意位置长按,打开 圆形菜单 — 一个从手指位置向外展开的环形上下文菜单,让你快速访问复制、粘贴、全选等操作。选中需要的文本,然后点击复制。

粘贴文本

使用软键盘栏上的粘贴按钮、圆形菜单,或在连接硬件键盘时使用标准的 Cmd+V 快捷键。

键盘

MTerm 在屏幕键盘上方提供可自定义的软键盘栏,包含修饰键(Ctrl、Alt、Escape)和方向键。当你连接 Magic Keyboard 等硬件键盘时,可使用超过 25 个键盘快捷键。查看键盘与输入指南了解完整列表。


下一步

现在你已经连接好了,请浏览以下指南以充分利用 MTerm: