MaxTerm /使用文档
下载 技术支持

装机

到 下载页 拿到 MaxTerm_x.y.z_aarch64.dmg(目前 Apple Silicon 专版,约 5 MB),双击挂载,把 MaxTerm 拖到「应用程序」文件夹。

未签名应用必看: 首次打开会弹「无法验证开发者」或「已损坏」。打开「终端」app 跑一行:

xattr -cr /Applications/MaxTerm.app

移除 macOS 加的隔离标记。之后正常双击打开即可。从 0.9.2 起每次更新由 App 自动完成,不再需要这条命令。

首次启动

启动 MaxTerm,主窗口长这样:

首次启动会自动注入 120+ 条预设命令片段(覆盖 Docker / k8s / Nginx / 数据库 / 安全 / 网络诊断等 17 个分组)。

加第一台主机

  1. 点左侧「+ 新增主机」
  2. 填基本信息:
    • 名称:好记的标签,如「生产-Web01」
    • 主机地址:IP 或域名
    • 端口:默认 22
    • 用户:登录用户名
    • 分组:可输入新分组名或下拉选已有的(留空默认「默认」组)
    • 认证方式:三选一
      • 密钥文件:推荐。填 ~/.ssh/id_ed25519 等私钥路径
      • SSH 代理:走系统 ssh-agent
      • 密码:每次连接弹密码框输入,不落盘
  3. (可选)填跳板机、端口转发、标签颜色、自动会话日志
  4. 点「保存」→ 书签出现在左侧
  5. 点书签 → 弹密码框(如果是密码认证)→ 连上,首次出现 known_hosts 指纹确认弹窗,点「确定」信任并写入
已经有 ssh config? 点左侧「⬇ 导入 ssh config」,自动解析 ~/.ssh/config 里的所有 Host 段,批量生成书签。

推送公钥(免密登录)

密码认证连上后,推荐立刻部署公钥换成免密:

  1. 把鼠标移到书签上 → 点 ✎ 编辑
  2. 弹窗底部点「推送公钥」
  3. 填本地公钥路径(默认 ~/.ssh/id_ed25519.pub)→ 输服务器密码 → 等几秒
  4. 提示「公钥已部署。是否把此书签的认证改为密钥?」→ 点确定
  5. 以后这台主机直接免密登录

书签管理

终端使用

每个 SSH 会话是一个标签。标签上的按钮:

终端内交互:

SFTP 双栏传输

在会话内点工具栏「SFTP」标签切到双栏文件视图:

互传:

多机操作

三种场景三种解法:

广播 — 同步打字到所有打开的会话

右上角 广播 按钮开关。开启后,在任一终端输入的字会同步发到所有其它打开的 SSH 标签。活动会话边框变橙色提示。

适合:多台机改 nginx 配置、同时跑相同命令交互式确认。

本地终端不参与广播。

批量执行 — 选机器跑一条命令

  1. 右上角点「批量」
  2. 勾选目标主机(按分组列出,「全选 / 清空」)
  3. 输入命令(支持占位符 ${HOST} / ${USER} / ${PORT} 自动替换)
  4. 点「执行」→ 并行连接每台机 → 跑命令 → 结果汇总展示
  5. 结果页可「导出 Markdown / JSON 到剪贴板」

每台机的状态:✓ OK / 退出码 N / 连接失败。

平铺模式 — 同时看多个终端

右上角「平铺」开关。开启后,所有打开的会话以网格形式同时显示,而不是只看激活那一个。配合广播=同时盯多机执行结果。

命令片段

把常用命令存下来一键执行。右上角「片段」打开管理面板:

命令面板 — ⌘K 万能搜索

任何位置按 ⌘K(或 Ctrl+K)弹搜索框,自动模糊匹配:

↑↓ 选,Enter 执行,Esc 关。

触发器 — 输出关键字自动响应

右上角「触发」管理面板:

使用例子:

端口转发 / 跳板机 / SOCKS5

书签编辑里的「端口转发(本地隧道)」段落 + 「跳板机(可选)」字段。

本地转发

对应 ssh -L local_port:remote_host:remote_port host:

  1. 编辑书签 → 端口转发 → 点 ＋
  2. 选「本地转发」类型
  3. 填:本地端口 8888 → 远端主机 127.0.0.1 → 远端端口 22(在服务器视角)
  4. 保存 → 连接 → 终端会显示「[隧道] 127.0.0.1:8888 → 127.0.0.1:22」
  5. 此时本地访问 localhost:8888 等于在服务器内部访问 127.0.0.1:22

常见场景:访问云服务器内网的数据库、Redis、宝塔安全入口等。

SOCKS5 动态转发

对应 ssh -D 1080 host,把整条 SSH 连接变成 SOCKS5 代理:

  1. 编辑书签 → 端口转发 → 添加一行
  2. 类型切到「SOCKS5 动态」
  3. 只填本地端口(如 1080),远端两栏置灰不用填
  4. 保存 → 连接
  5. 浏览器/工具配 socks5://127.0.0.1:1080 即可走服务器出口

跳板机多跳

对应 ssh -J jump1,jump2 target。三台机示意:

笔记本 → [C 公网堡垒] → [B 内网跳板] → [A 数据库]
  1. 先建 C 的书签(普通直连,跳板栏空)
  2. 建 B 的书签,「跳板机(可选)」选 C
  3. 建 A 的书签,「跳板机(可选)」选 B
  4. 点 A 连接 → MaxTerm 会:笔记本→C→B→A 一路打通,每跳分别问密码(密钥/agent 自动跳过)
  5. 断开 A 时 C 和 B 的中间连接自动清理

一键装机

右上角「装机」打开应用清单(目前 6 个):

应用说明配置项
Claude CodeAnthropic 官方 AI 编程终端API Key(可选)
OpenAI CodexOpenAI 官方 AI 编程终端API Key(可选)
Node.js (fnm)通过 fnm 装 Node,无需 sudo版本号(默认 22)
Docker官方一键脚本无
btop比 htop 漂亮的资源监控无
Tailscale零配置 P2P VPN无,事后浏览器登录
  1. 点应用 → 右侧显示介绍 + 配置项 + 完整脚本预览
  2. 底部选目标主机 → 「开始安装」
  3. MaxTerm 会自动开 SSH 会话,把脚本通过 bash heredoc 喂进去
  4. 你看实时进度,装完终端不关,直接试 claude / codex 等命令

本地终端

左侧「▷ 本地终端」开一个本地 shell 标签(默认走 $SHELL 环境变量,通常是 zsh)。用真 PTY,支持 vim/htop 等交互式应用,跟 macOS Terminal 等价。

本地终端不参与广播 / 批量。Cmd-F / 历史 / 片段都对它生效。

备份与还原

左侧「⚙ 设置 / 备份」:

⚠ 备份文件含完整 SSH key,等同你的 ~/.ssh 副本。务必妥善保管(加密盘/1Password/私人 iCloud 加密文件夹),不要 commit 到 git、不要群里乱发。

配置文件位置

用途路径
书签 + 片段 + 触发器~/Library/Application Support/maxterm/bookmarks.json
已知主机 (known_hosts)~/.ssh/known_hosts(系统标准位置)
会话日志(如启用)~/Library/Application Support/maxterm/logs/
命令历史 / 最近连接 / 主题 / 字号localStorage(浏览器存储,无单独文件)
临时下载缓存(远端就地编辑)~/Library/Caches/maxterm/edits/

书签是纯 JSON,可手动编辑,也可丢 git/iCloud 同步(key 路径在里面,key 内容不在)。

自动更新

从 v0.9.2 起,启动时自动检查 https://maxta.com/maxterm/latest.json。有新版本时右下角弹卡片:

整个过程不需要再装机仪式,跟 Chrome 自动更新一样。

v0.9.1 用户注意: 0.9.1 的检查端点是旧 URL,已下线。0.9.1 需要手动到 下载页 装一次 0.9.2 或更新版本,之后自动更新就生效了。

主题 / 字号

命令历史

在终端里每按一次回车,前面输入的命令自动入库(最多 500 条)。右上角「历史」管理面板:

命令面板 ⌘K 里也能搜历史。

故障排查

「MaxTerm 已损坏,无法打开」

未签名应用 + 通过浏览器/微信下载被加了隔离标记。终端跑:

xattr -cr /Applications/MaxTerm.app

SSH 连接失败 os error 2

密钥文件路径不对或文件不存在。检查书签里「密钥路径」字段。常见路径:

SSH 连接失败 认证失败

首次连接弹「主机密钥变化」警告

如果你换过服务器但 IP 复用了,删除 ~/.ssh/known_hosts 里那行再重连即可。如果你没换过服务器收到这个警告,可能存在中间人攻击,谨慎连接。

跳板机连不通

SFTP 显示「会话未连接」

SFTP 复用 SSH 会话,所以必须先在终端里成功连上主机,再切到 SFTP 标签。

自动更新失败

快捷键速查

快捷键功能
⌘K命令面板(搜主机 / 片段 / 历史)
⌘F终端内搜索(右上角搜索条)
⌘+ / ⌘=放大终端字号
⌘-缩小终端字号
⌘0重置字号 (13px)
⌘T新开本地终端
⌘W关闭当前标签
⌘1-⌘9跳转到对应标签
Esc关闭顶层弹窗
选中文本自动复制到剪贴板
右键终端复制 / 粘贴 / 全选 / 清屏菜单
拖动标签重排顺序

联系 / 反馈