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

装机

到 下载页 拿到 MaxTerm_x.y.z_universal.dmg(Universal Binary,Apple Silicon + Intel 双架构,约 12.7 MB),双击挂载,把 MaxTerm 拖到「应用程序」文件夹。

已 Apple 签名 + 公证(Maxta, Inc.): 0.9.4 起每个 dmg 都过 Apple 官方公证,下载双击就开,不再弹「无法验证开发者」,也无需任何额外命令。
0.9.3 及之前版本: 未签名,首次打开可能弹「无法验证开发者」或「已损坏」。终端跑 xattr -cr /Applications/MaxTerm.app 即可。装上之后自动更新到最新公证版,以后无需再跑这条命令。

首次启动

启动 MaxTerm,主窗口长这样:

首次启动会问要不要打开「贴心提醒」(运维主题的鼓励话语,每 10-15 分钟弹一句,可关)。也会注入 120+ 条预设命令片段(在「设置 → 命令片段」里管理)。

加第一台主机

  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. 以后这台主机直接免密登录

AI 运维助手 ⌘/ ⭐ 0.9.4 新

不熟命令、又不想开浏览器查?按 ⌘/,用中文打「查一下哪个进程占了 8080 端口」,AI 当场翻译成 lsof -nP -iTCP:8080 -sTCP:LISTEN 并标好风险等级。删库、改权限这类高危操作强制二次确认,而生成的命令永远要你自己按回车才执行。

开启

  1. 顶部工具栏点 AI 按钮(或快捷键 ⌘/)
  2. 首次会弹设置弹窗,粘贴管理员发给你的 License Token(JWT 字串)→ 点保存
  3. 页面顶部出现橙色输入条,光标已就位

用法

  1. 在输入条用中文描述要做的事(Enter 换行 / ⇧+Enter 或 ⌘+Enter 发送),例如:
    • 查看是否安装了宝塔面板
    • 列出占用 80 端口的进程
    • 把 nginx 重启一下
    • 看磁盘还剩多少空间
    • 找出最大的 10 个日志文件
  2. 发送 → AI 返回一个命令预览卡片,包含:
    • 命令:大字显示
    • 风险等级:
      • 🟢 绿(safe):只读 / 查询,直接执行
      • 🟡 黄(modify):改文件 / 重启服务,提示确认
      • 🔴 红(destructive):删除 / 关机 / 改权限等,强制二次确认
    • 说明:这条命令在干嘛(给不熟的人理解用)
  3. 四个动作:
    • 执行 — 直接发到当前会话(高风险会再问一次)
    • 插入 — 只粘贴不回车,留给你自己看完再敲回车
    • 改一下 ⭐ — 0.9.6 起:点了之后,命令文本块原地变成可编辑(光标到末尾),改完直接点「改完执行」即可(Esc 取消编辑)
    • 拒绝 — 关掉卡片
0.9.6 改进:
  • 输入条改成多行 textarea,Enter 换行、⇧+Enter 发送(跟 ChatGPT 一致)
  • 右侧加齿轮 ⚙ 按钮 — 配置好 License 后,随时点开看用量 / 换 token
  • 「改一下」原地编辑,不再弹 prompt 重写
  • 服务端强制 JSON + 客户端兜底解析,再也不会把脏 JSON 倒进终端

报错一键问 AI ⭐ 1.0.0 新

命令报错了不用复制去查 —— 在终端里选中报错输出 → 右键 → 「✨ 问 AI 这段输出」,AI 解释这段报错是什么意思,并直接给出修复命令(照常走风险分级预览卡)。这是运维最高频的 AI 场景,从「事前帮你写」扩展到「事后帮你修」。选区超过 2000 字符会自动截断省流量。

主机环境感知 ⭐ 1.0.0 新

连上主机后,MaxTerm 静默探测一次发行版 / shell / 是否装宝塔(一条只读命令,不污染终端),之后每次 AI 生成命令都带着这份环境信息 —— CentOS 上不再写 apt、fish 里不再写 bash 语法,宝塔机器优先给 bt 命令。无需任何配置,连上即生效。

三种模式:命令 / 诊断 / 脚本 ⭐ 1.1.0 新

1.1 起,AI 输入条顶部多了三个模式标签,按 ⌘1 / ⌘2 / ⌘3(输入条打开时)或点击切换:

快捷键补充:⌘/ 或 ⌘I 都能唤起/收起 AI 输入条(部分中文输入法下 ⌘/ 会被输入法占用,备用 ⌘I)。

AI 诊断 Agent — 多步排查找根因 ⭐ 1.1.0 新

命令模式是「你问一句、AI 答一条」;诊断模式是 AI 像工程师一样连续排查:你描述故障(如「网站 502 了」「磁盘莫名快满了」),AI 提出一条只读诊断命令 → 你批准 → 静默执行(不污染终端)→ AI 读输出继续推理 → 最多 5 步后给出 Markdown 根因报告(结论 / 依据 / 修复建议 / 下一步)。

AI 运维脚本 — 分段标风险,审阅后执行 ⭐ 1.1.0 新

要做的事不止一条命令?脚本模式把需求(如「nginx 日志按天切割并保留 30 天」)生成分段 bash 脚本:按「检查前提 → 备份 → 修改 → 验证」分段,每段独立标注风险等级和原因,逐段审阅。诊断报告底部也有「生成修复脚本」一键串联,按报告里的修复建议出脚本。

License Token

生产环境护栏 ⭐ 1.0.0 新

数据 / 隐私

书签管理

几十台服务器记不住?左侧 sidebar 是书签列表,主机一键直连,密钥 / 密码 / SSH agent 全支持,还能直接导入你现成的 ~/.ssh/config 批量生成书签。生产、测试用颜色标签一眼区分。

持久会话 — 防客户端假死丢工作 ⭐ 0.9.8 新

跑长任务(数据导入、训练、滚动升级)时最怕的就是:走开一会回来,MaxTerm 假死了,只能强退,任务全没了。0.9.8 引入持久会话解决这个问题。

原理

在主机编辑弹窗里把「持久会话」从「关闭」改成 screen 或 tmux。登录后 MaxTerm 透明地 exec screen -xRR maxterm-<主机ID>(或对应的 tmux 命令)。你看到的终端实际上是 screen 里的一个 window。

前置:服务端先装 screen 或 tmux

# Debian / Ubuntu
sudo apt install screen
# CentOS / RHEL / AlmaLinux
sudo dnf install screen
# Alpine
sudo apk add screen

没装也不会卡 — App 会看到错误后友好地降级到普通 shell,只是这次会话不能持久。

screen vs tmux 怎么选

标签栏(20+ tab 怎么管)0.9.5 增强 · 0.9.8 加右键

终端使用

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

终端内交互:

SFTP 双栏传输

不想为传个文件单独开 FileZilla?在会话内点工具栏「SFTP」标签切到双栏文件视图,左本地右远端,拖拽上传(目录递归),远端文件 hover 点 ✎ 就地编辑、保存自动回传。SSH 和文件传输一个窗口搞定。

互传:

多机操作

要在 20 台机上查同一件事、或同时给多台机改 nginx 配置?MaxTerm 提供两种模式:批量执行(一次跑一条命令汇总结果)和 广播(在一个终端打的字同步发到所有打开会话)。

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

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

0.9.6 起每台机的状态显示具体退出码 + 命令耗时,hover 看常见退出码解读(127 找不到命令、130 Ctrl-C 中断 等):

0.9.7 修复: 之前部分服务器(把 ExitStatus 放在 EOF 之后)会返回「? 未知退出码」,现在改成等到 Close 才退,加 3 秒兜底超时。再也不会丢退出码。

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

工具栏「更多」→「广播」开关。开启后:

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

本地终端不参与广播。历史说明:0.9.6 把独立的「平铺」按钮删了,但发现广播没了平铺看不见效果;0.9.7 把两者绑成一个开关。

命令片段(在「设置」里)0.9.6 降级

把常用命令存下来一键执行。0.9.6 起,工具栏不再有「片段」按钮,改入口:左侧「设置 → 命令片段」tab → 「打开片段管理面板」。

降级原因: AI 助手能覆盖大部分查询场景(中文描述比记片段名快),片段保留给固定的重复运维操作。数据没有任何丢失,⌘K 命令面板里也照样能搜片段。

命令面板 — ⌘K 万能搜索

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

↑↓ 选,Enter 执行,Esc 关。

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

怕错过服务器告警?终端输出匹配正则(如 No space left)时自动弹通知或自动响应,内置 8 个常用模板。在右上角「触发」管理面板配置:

使用例子:

端口转发 / 跳板机 / SOCKS5

内网最深处的数据库连不上,或者不想背 ssh -L / ssh -D 参数?MaxTerm 在书签编辑里有「端口转发(本地隧道)」段落 + 「跳板机(可选)」字段,表单填一下就开,点连接 → 隧道和跳板自动建好,断开时中间连接也自动清理。

本地转发

对应 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 的中间连接自动清理

一键装机 1.0.0 扩到 9 项

新服务器要装一堆工具?右上角「装机」打开应用清单,选要的,远端自动安装并显示实时进度。装完直接用,不用记长串安装命令。

应用说明配置项
Claude CodeAnthropic 官方 AI 编程终端API Key(可选)
OpenAI CodexOpenAI 官方 AI 编程终端API Key(可选)
Node.js (fnm)通过 fnm 装 Node,无需 sudo版本号(默认 22)
Docker官方一键脚本无
btop比 htop 漂亮的资源监控无
Tailscale零配置 P2P VPN无,事后浏览器登录
Nginx 1.0.0反向代理 / 静态服务,装完自启无
tmux 1.0.0配合「持久会话」防断线无
MaxTerm Shell 集成 1.0.0OSC 133 注入,开启长任务完成通知无,幂等可重复跑
  1. 点应用 → 右侧显示介绍 + 配置项 + 完整脚本预览
  2. 底部选目标主机 → 「开始安装」
  3. MaxTerm 会自动开 SSH 会话,把脚本通过 bash heredoc 喂进去
  4. 你看实时进度,装完终端不关,直接试 claude / codex 等命令

本地终端

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

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

备份与还原

换电脑要重配所有书签?MaxTerm 把书签 + 片段 + 触发器 + 引用到的 SSH key 文件打包成单个 JSON,新机器一键完整还原。在左侧「⚙ 设置 / 备份」:

⚠ 备份文件含完整 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 或更新版本,之后自动更新就生效了。

主题 / 字号 1.0.0 双主题

长任务完成通知 ⭐ 1.0.0 新

跑编译 / 备份 / 数据迁移时切去干别的,任务一结束 macOS 原生通知告诉你 成功还是失败 + 退出码 + 耗时。只在「窗口在后台 或 你切到了别的会话」时才通知,正盯着看的不打扰。

两步开启

  1. 远端装 Shell 集成:装机面板 → 「MaxTerm Shell 集成」→ 选目标主机 → 开始安装(往 ~/.bashrc / ~/.zshrc 注入标准 OSC 133 标记,幂等可重复跑)
  2. 重新连接这台主机即生效。阈值默认 20 秒,「设置 → 贴心提醒」里可改、可整体关闭
原理:OSC 133 是 Ghostty / WezTerm / iTerm2 通用的 shell integration 标准,MaxTerm 解析命令边界拿到退出码。远端没装集成时此功能静默不生效,其它一切照常。

故障排查

「MaxTerm 已损坏,无法打开」

0.9.4 起 dmg 已经 Apple 公证,这个错误一般只会发生在用 0.9.3 及以前的版本时。终端跑:

xattr -cr /Applications/MaxTerm.app

装上之后用应用菜单「检查更新」一次升到 0.9.4+,以后就再也不会遇到。

AI 提示「License 无效 / 已过期 / 配额用完」

💡 丢了授权码 / 收购买邮件的邮箱被删了? 到 maxta.com/maxterm/recover,用购买时填的邮箱 + 6 位验证码自助重发,2 分钟搞定,不用联系客服。

SSH 连接失败 os error 2

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

SSH 连接失败 认证失败

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

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

跳板机连不通

SFTP 显示「会话未连接」

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

自动更新失败

快捷键速查

快捷键功能
⌘/ 或 ⌘IAI 运维助手(中文描述 → AI 给命令)
⌘1/⌘2/⌘3AI 输入条打开时:切换 命令/诊断/脚本 模式
⌘Enter诊断面板:批准执行当前命令
⌘K命令面板(搜主机 / 片段)
⌘F终端内搜索(右上角搜索条)
⌘+ / ⌘=放大终端字号
⌘-缩小终端字号
⌘0重置字号 (13px)
⌘T新开本地终端
⌘W关闭当前标签
⌘1-⌘9跳转到对应标签
Esc关闭顶层弹窗
选中文本自动复制到剪贴板
右键终端复制 / 粘贴 / 全选 / 清屏菜单
拖动标签重排顺序

联系 / 反馈

💡 授权码邮件丢了 / 删了?不用联系客服,到 maxta.com/maxterm/recover 输入购买邮箱 + 6 位验证码,2 分钟自助重发该邮箱下所有授权码。

最后更新:2026-06-06 · 当前版本 v0.9.8