SSH 主机管理与 SFTP 文件传输

主机管理器用来保存、编辑、导入主机并连接。有三种打开方式：

• 在左侧边栏的 SSH 区域，点击滑块按钮（提示为管理 SSH & SFTP 服务器）。它旁边的 + 按钮会打开管理器，并停在空白的新建主机表单上。
• macOS 上按 Cmd+Shift+H，Linux 上按 Ctrl+Shift+H。代码里 Windows 用同一个快捷键，但还没有在 Windows 上测试过。快捷键可以在设置里修改。
• 在命令面板中选择 SSH & SFTP 会话管理器。

左栏列出 已保存会话，每个分组有一个筛选标签。右栏是新建主机或所选主机的表单。按 Esc，或点击窗口外的深色区域，都会关闭管理器。左侧边栏的 SSH 区域也会列出每台已保存的主机：点一个就在新标签页里打开，和点连接一样。添加、编辑和删除主机要在管理器里做。其他快捷键见键盘快捷键。

1. 打开主机管理器，点击 新建主机。
2. 填写下面的字段。书签名称、IP 地址 / 域名 和 用户名 为必填。
3. 在 身份验证方式 下选一种方式。
4. 点击 保存 SSH 会话。

要修改主机，点击它的卡片，编辑表单后点击 更新 SSH 会话。卡片上的垃圾桶图标会在你确认后删除该主机。如果你输入了新密码而系统钥匙串拒绝保存，不会有任何改动：表单保持原样，并显示无法将密码保存到钥匙串，因此未做任何更改，后面跟着原因。

导入 只读取你选的文件，不会自动读取 ~/.ssh/config。

1. 在主机管理器里，点击主机列表上方的 导入。
2. 选择 OpenSSH 配置文件、MobaXterm 会话文件、iTerm2 配置导出文件或 JSON 文件。选择器接受 .config、.mxtsessions、.json、.txt 和 .ini 文件。
3. 逐个打开导入的主机，补上导入时没带过来的内容（见下面的说明）。

OpenSSH 的配置文件没有扩展名，还放在隐藏文件夹里。最省事的做法是先复制一份，例如 cp ~/.ssh/config ~/Desktop/ssh-config.txt，再导入这份副本。

Session Manager Pro 可以把 iTerm2 配置导入为已保存会话和 SSH 主机。从命令面板打开它，或在 macOS 上按 Cmd+Shift+O（Linux 上按 Ctrl+Shift+O），再点击 导入 / 导出 标签页。

在 macOS 上，点击 在此 Mac 上查找配置。应用会用 plutil 读取 iTerm2 的偏好设置文件；如果 iTerm2 设为从自定义文件夹加载，则读取该文件夹里的文件。这个按钮仅限 macOS。任何系统上都可以改为点击该标签页的文件区域选择 iTerm2 的 JSON 导出文件，或把文本粘贴到 JSON 框里，然后点击 导入会话。两种方式得到的是同一份供你勾选的列表。

点击 导入选中的配置 (N) 之前不会写入任何内容，N 是已勾选的数量。被跳过的配置无法勾选。全选 和 全不选 用来改变勾选状态。重复导入同一个配置会更新它的已保存会话，而不会再加一个。与已保存主机的 user@host:port 相同的主机会被跳过，结果行里会算上它们。

1. 打开主机管理器。
2. 可选：点击主机卡片上的 Ping。它只检查该地址和端口是否接受来自你这台机器的 TCP 连接。它不会登录，也不经过跳板机。
3. 点击 连接。会打开一个名为 [SSH] <name> (<address>) 的新标签页。
4. 回答终端里 ssh 的提示，例如首次连接时确认主机密钥，以及输入密码、口令或验证码。

分屏里直接运行 ssh，就是你电脑上已装好的那一个：MXterm 自己没有 SSH 库，文件面板也是运行 ssh 和 scp。在 Windows 上指的是 OpenSSH 客户端，尚未在那里测试过。它底下没有本地 shell，也没有往 shell 里敲命令行：应用根据你保存的字段拼出参数，直接交给 ssh，之后它的表现和在任何终端里一样。MXterm 会加上这些选项：

• -o ControlMaster=auto -o ControlPath=~/.mxterm/sockets/%r@%h:%p -o ControlPersist=10m：每台主机共用一条连接，文件面板、状态栏和端口转发都复用它。没人使用后，它还会在后台保持 10 分钟。
• -o ServerAliveInterval=30 -o ServerAliveCountMax=3：keepalive 探测，这样连接断开后约 90 秒就能发现，而不是等到你下次输入。
• -i、-J、-A 和 -p，分别来自主机的密钥文件、跳板机、agent 转发和端口。只有使用密钥文件的主机才会传 -i。
• 目标地址前加 --，这样以 - 开头的主机名或用户名永远不会被当成选项。

尝试连接之前会先检查每个字段：主机、用户和跳板机按 OpenSSH 自己的规则检查，端口、密钥文件路径和工作目录则检查是否含有无法安全传递的值。如果某个字段被拒绝，点击连接不会打开标签页，管理器会显示一条消息，指出是哪个字段以及原因。已保存的标签页在启动时被拒绝，则会在分屏顶部的栏里显示同样的消息。

如果主机没有设置 默认工作目录，而你在设置 → 终端的 默认 SSH 工作目录 下选了 自定义目录路径，标签页就会在该目录启动。见设置。

同一台主机的所有分屏、文件面板、状态栏和端口转发共用一条后台 ssh 连接。它只登录一次，并保留当时的状态。如果当时服务器密码已过期，即使你在终端里改了密码，文件面板仍可能一直失败，因为它用的还是旧连接。

重置连接 会关闭这条连接，下一次连接就从头登录。当失败原因是密码过期或登录被拒绝时，文件面板的错误卡片会显示这个按钮。点击它：应用会关闭连接，并为该主机打开一个新的 SSH 标签页。在那里登录，然后点击 重试。如果标签页打不开，面板会提示你自己打开一个。经由旧连接的所有会话都会随之结束，包括分屏和正在运行的端口转发。

出现以下情况时，应用也会自己关闭共用连接：

• 你保存了对主机的修改，且改动了它的地址、端口、用户、认证方式、密钥文件、跳板机或 agent 转发，或保存了新密码；
• 你删除了主机，或移除了它保存的密码；
• 你添加了一台主机，而到该地址的连接仍然开着。

重命名主机，或修改它的分组或工作目录，不会关闭连接。当另一台已保存主机有相同的 user@host:port 时，编辑、删除或添加主机，或者保存或移除密码，也不会关闭连接。这种情况下，如果连接已经失效，请用重置连接。

每个 SSH 标签页都有一个对应其主机的文件面板，默认在左侧。面板顶部的按钮依次用来：打开端口转发、把面板移到另一侧、开关跟随终端目录、刷新当前文件夹、显示或隐藏隐藏文件、隐藏面板。面板隐藏后，点击 FILES (SFTP) 条即可恢复。拖动面板边缘可调整宽度。它打开时约占工作区宽度的 30%，不会小于 420 px，也不会大于 640 px，你拖动后的宽度会被记住。顶部的下拉菜单可以把面板和状态条切换到另一台已保存的主机，终端不会变。

文件面板只是服务器文件的一个视图。它没有本地的一半，所以不是双栏文件管理器，也不会在你的电脑和服务器之间同步或镜像文件夹：只有你上传或下载时，文件才会移动。你自己的文件在资源管理器标签页里（见编辑你本机上的文件）。

面板默认打开你登录账号的主目录，这个路径由面板向服务器查询得到。主目录按钮会回到这里，但它的提示文字始终是 转到 Root 目录 (/root)，不管登录的是哪个账号。想去别处，点击路径栏，输入绝对路径（如 /var/www）并按 Enter。点击路径中的某一段，可以跳回上层。

在快速文件过滤...里输入内容可按名称过滤，也可以用“全部”“文件夹”“代码”“图片”“归档包”几个筛选标签。点击文件名、大小或修改时间的表头可排序。过滤框旁的搜索按钮会打开远程 Grep 搜索：它搜索当前文件夹下文件的内容，跳过 .git、node_modules、vendor、storage、dist、build 和 .cache，最多列出 60 行匹配结果，点击某条结果会在编辑器里打开对应文件。

目标不存在的链接仍会列出。服务器上有 python3 时，列表用它生成，否则退回到 ls -la。用 ls -la 时，名称里连续的多个空格可能显示成更少的空格，链接显示为 name -> target。

点击面板内部后，下列按键可用：

工具栏里的上传文件和上传文件夹…，以及右键菜单里的上传文件，可以把电脑上的一个文件或文件夹复制到当前文件夹。你也可以把文件从 Finder 拖到面板上，它们会上传到你正在看的文件夹。把文件拖到 SSH 分屏上同样会上传（见“把文件拖到 SSH 分屏上”），拖到本地分屏上则仍然是输入本地路径。右键菜单里的下载文件，或文件行上的下载按钮，会把文件保存到你的 Downloads 文件夹。文件夹可以上传但不能下载，也不支持从面板里往外拖来下载。进度显示在面板底部的传输队列里。

在 SSH 终端里 cd 之后，文件面板可以跳到同一个文件夹。跟随默认开启。面板顶部的跟随终端目录按钮可以关闭或重新开启，面板会记住你的选择。按钮上出现绿点，说明终端正在上报它的当前文件夹。

文件夹来自服务器上的 shell，它必须用 OSC 7 转义序列上报。fish 自带这个功能。bash 和 zsh 需要在服务器的 ~/.bashrc 或 ~/.zshrc 里加一行。MXterm 绝不会为了让它上报而往你的 SSH 会话里输入任何内容。

如果终端第一次有输出大约 8 秒后仍没有任何上报，面板会显示一条提示，带有复制适用于 bash (~/.bashrc) 和复制适用于 zsh (~/.zshrc) 两个按钮，用来复制那一行。把它加到服务器的启动文件里，再打开一个新终端。不再针对此服务器显示会对该主机隐藏这条提示。

• 面板打开时，它会跟随同一标签页里、运行着面板所示主机的 SSH 分屏：已经上报过文件夹的焦点分屏优先，否则跟随最近一次上报的那个。本地分屏不会被它跟随。
• 只有终端的文件夹发生变化时它才会移动。每次出现命令提示符时重复上报同一个文件夹，不会把面板从你自己打开的文件夹拉回来。
• 你在路径栏里输入时它不会移动，而是等到下一次上报。
• 如果你连续快速地 cd 多次，面板只会列出最后一个文件夹。

把文件或文件夹从 Finder 拖到 SSH 分屏上。MXterm 会把它们上传到服务器上的一个文件夹，并在命令提示符处输入它们在服务器上的路径，方便你用在正在写的命令里。不需要打开文件面板。拖到面板上会上传到它所显示的文件夹，拖到本地分屏上则输入本地路径。

• 目标文件夹按这个顺序确定：终端上报的文件夹（见上文），其次是该标签页文件面板所显示的文件夹，最后是你在服务器上的主目录。除非终端上报的就是 /，否则拖放绝不会上传到 /。这时它什么也不上传，并提示你先 cd 到某个文件夹。
• 已存在的名称绝不会被覆盖。上传的文件会命名为 name (1).ext、name (2).ext，依此类推，输入的路径是这个新名称。
• 路径在最后一个上传完成后输入，以空格分隔，末尾带一个空格。需要加引号的名称会放进单引号里。只输入已成功上传的文件，并且只输入到那个分屏里，即使开着广播也是如此。名称里含单引号、反斜杠、! 或控制字符的文件会上传，但不会输入，提示里会列出它。
• 上传项会出现在传输队列里。如果读不了该文件夹，就不会上传任何内容，提示里会写明原因。每台主机同一时间只处理一次拖放，所以第二次拖放会提示你等第一次完成后再拖。

分屏底部有一条进度条，显示进度和结果。成功的结果 6 秒后消失。失败或被拒绝的结果会一直保留，直到你关闭它。

双击文本文件，选中后按 Space，或右键 → 查看/编辑。编辑器支持语法高亮、主题选择、字号选择和自动换行，并会记住这些选择。只有 UTF-8 文本能打开，其他文件请下载。

编辑器按服务器上的原样显示文件，保存时写回，并保持相同的结尾换行：没有结尾换行的文件（例如 authorized_keys）保存后仍然没有，有结尾换行的则保留。

保存时会先检查文件自你打开或上次保存以来是否在服务器上被修改过，例如被一次部署改过。如果改过，此文件已在服务器上被修改会提供取消、从服务器重新加载（丢弃你的修改，载入服务器上的版本）和仍然覆盖。这项检查用的是服务器上的 python3，没有它，保存会不经检查直接执行。

保存时先写入原文件旁边的一个临时文件，再复制覆盖原文件，所以连接中断不会留下空文件，文件的权限和所有者也保持不变。

同一个编辑器现在也能打开本地文件。右侧面板的资源管理器标签页会显示焦点分屏当前工作目录的文件树（是你自己的机器，不是服务器），点击文件就会在你刚读过的那个编辑器里打开。不需要选主机，也不涉及任何连接。

• 在 macOS 上用 Cmd+Option+B、在 Linux 上用 Ctrl+Alt+B 打开右侧面板，然后选择资源管理器标签页（文件夹树图标）。
• 文件树以焦点分屏的工作目录为根，当你聚焦到在别处工作的分屏时，会自动换根。
• 用顶部的按钮可以按名称过滤、显示或隐藏隐藏文件，以及刷新。
• 点击文件即可编辑。Cmd+S（Linux 上是 Ctrl+S）把它保存回磁盘。

这里只能打开 SFTP 面板本来就允许编辑的文件：不超过 5 MB 的 UTF-8 文本。其他文件不会动。

端口转发让你从自己的机器访问服务器上监听在 127.0.0.1 的端口，例如数据库。转发会加到该标签页共享的 SSH 连接上。

1. 连接到主机，并在终端里登录。
2. 在文件面板顶部，点击端口转发按钮（SSH 端口转发与隧道管理器）。
3. 在添加新端口转发下，填写名称、本地端口和远程端口，然后点击添加规则。
4. 点击规则上的启动。ssh 接受该转发后，它会显示运行中。
5. 让你的客户端连接 127.0.0.1 和本地端口。点击停止会移除这个转发。

每条规则对应 ssh -L 127.0.0.1:<local port>:127.0.0.1:<remote port>。本地端口只监听你机器的本机回环地址，远端的 127.0.0.1 是从服务器角度看的。这个对话框不能转发到服务器所在网络里的其他机器，不能在服务器上开放端口 (-R)，也不能启动 SOCKS 代理 (-D)。

如果点启动后的错误里提到 Control socket，说明这台主机还没有打开的连接。请先在终端标签页里登录，再试一次。

SSH 标签页底部有一个状态条，显示主机名、运行时间和三项读数：

读数在 65% 以内为绿色，高于 65% 为琥珀色，高于 85% 为红色。状态条每 20 秒刷新一次，点击刷新 VPS 统计会立即读取。它通过共享连接运行一小段 python3 脚本，并读取 Linux 的 /proc 文件，所以服务器上需要有 python3；对密码登录的主机，还需要终端已经登录。状态条在第一次读取成功后才会出现；没有 python3 就不会出现。

Command Recipes 把你输入的内容和一组固定的现成 Linux 命令做匹配：大文件、内存和 CPU 用量、磁盘用量、开放端口、Docker、Nginx、UFW、系统日志和重启。不会运行任何 AI 模型。点击 SSH 标签页右下角的圆形按钮，或在 macOS 上按 Cmd+J 打开。

输入需求，或点击一条快捷提示。匹配到配方时，你会看到命令和一行说明。复制会复制命令。插入并在终端中运行会把命令输入到当前标签页的焦点分屏，按下 Enter，同时也复制它。没有匹配项时，不会给出任何命令。