Berth
Berth 使用说明书
SFTP·终端·串口控制台，尽在一窗 — 从添加服务器到快捷键
🚀快速上手
界面构成
一个窗口里有四个区域。
- 站点侧边栏 — 位于左侧。服务器、串口控制台和文件夹以树状结构排列。
- 会话栏 — 已连接的各个会话。用颜色条区分对应的服务器。
- 工作区 — 上方是文件面板（本地·远程），下方是终端。拖动分割线可调整比例。
- 状态栏 — 位于最下方。显示当前正在发生的操作。
添加第一台服务器
- 在侧边栏空白处右键点击，或按 ⌘N。
- 填写名称和服务器地址。用户名和端口留空则使用默认值。
- 在列表中双击即可连接。单击只是选中。
ssh alias 连接，就不需要重新填写。
用侧边栏菜单中的从 ~/.ssh/config 导入（⌘⇧I）一次性导入。
FileZilla 的站点列表也可以导入。切换语言
在菜单的Berth › 设置（⌘,）中，从 20 种语言里选择一种。 默认跟随系统语言，选定的语言仅应用于此应用。 更改后重新启动应用即可生效。
🗂服务器与文件夹
用文件夹归类并向下继承
用文件夹（⌘⇧N）归类服务器后，设置会向下传递。 在文件夹上设置一次用户名或警示等级，其下所有服务器都会沿用。 这个机制就是为了不用在二十台服务器上把同一个值填二十遍。
设置窗口的每个字段下方都会标明这个值来自哪里（是自己设定的，还是从某个文件夹继承来的）， 并提供一个还原按钮，可恢复为继承值。
警示等级 — 开发 · 预发布 · 生产
等级优先于颜色。设为生产后，危险操作前会额外确认。在会话列表中以你选择的颜色填充，并用红色边框标示为生产，因此多个生产服务器仍可用颜色区分。在一次只显示一个的地方（如确认对话框），它保持红色作为强提醒。
点击规则
- 单击 — 选中（用于查看设置或移动位置）
- 双击 — 服务器会连接，文件夹会展开/折叠
- 文件夹前的三角形点一下即可展开。
🔑连接与认证
首次连接时 — 文件夹权限
Berth 遵循 App Store 的规则（沙盒），不会随意读取主文件夹。首次打开服务器
时，会请您选择一次存放 SSH 设置、密钥、known_hosts 的文件夹（通常是
~/.ssh）。选择一次后会记住，此后不再询问。如果您把密钥放在别处，也可以选择主
文件夹。
出于同样的原因，本地文件面板也会以您选择的文件夹作为根目录 — 可以用面板标题栏的 打开本地文件夹来更改，这个选择同样会被记住。
直接沿用 ~/.ssh/config
用别名连接时，会读取该配置块中的主机·端口·用户·密钥文件·ProxyJump·
StrictHostKeyChecking。即使保存的端口已经过时，也以配置文件为准。
ProxyCommand 会启动外部程序，
因此在沙盒中被禁止 — 跳板机请改用 ProxyJump 来配置。
也无法访问 ssh-agent，因此会直接读取密钥文件，带密码保护的密钥会在连接时
询问密码。认证方式
- 自动 — 交给 ssh 处理。会依次尝试所有默认密钥，失败时在终端中询问密码。
- 密钥文件 — 只使用指定的那一个密钥。
- 密码 — 跳过密钥认证。
ssh 就能连接，选择自动即可。
出于好意指定密钥反而会导致无法连接 — 因为这样只会尝试指定的那一个密钥。服务器发来请求时
保存密码后，连接时会代为回答一次。其余的问询 — 两步验证 代码、重新输入错误密码、带密码保护的密钥的密码 — 会在"服务器发来了请求" 窗口中原样显示服务器发来的问题，需要您自行作答。为了不让账户被锁定，保存的密码只会 自动填入一次，最多只询问三次。
想不再手动输入密码
右键点击服务器，选择在此服务器注册公钥…，即可把 ~/.ssh 中的公钥
上传到服务器。此后即可用密钥连接。
保存的密码只存在于macOS 钥匙串中。设置文件里只会留下"已保存"的标记 ，不会写入具体的值。
首次连接的服务器与主机密钥变更
首次连接的服务器会显示密钥的种类和指纹，并询问是否记住。若选择记住，
会以与 ssh 相同的格式写入 ~/.ssh/known_hosts，此后不再询问。
当服务器的身份与上次不同时也会出现此提示。可能是中间人攻击，也可能是服务器重新安装
了。Berth 不会替您判断，只提供判断所需的材料 — 新旧密钥的种类和
指纹，以及可以在设备控制台上直接核对的命令。确认无误后点击"删除旧密钥并记住新密钥"，会删除
旧记录（备份为 known_hosts.old）并写入新密钥。
known_hosts。生产等级下无法开启此项。文件面板（SFTP）
上传与下载
左侧是本机 Mac，右侧是服务器。可以拖放，也可以用 ⌥⌘→（上传） · ⌥⌘←（下载）发送文件。进度会累积显示在传输队列中。
跟随终端的文件面板
在终端里执行 cd，远程面板会跟着切换到同一个文件夹。如果这种跟随造成干扰，用
⌘⇧L 关闭它。
常用位置 · 视图
- ⌘D — 将当前路径固定或取消固定。固定的路径会成为树状结构的根。
- ⌘↓ — 进入所选文件夹。⌘↑ 可返回上一级。
- ⌥⌘T — 切换树状 ↔ 列表视图。文件数量上千的文件夹更适合用列表视图。
- ⌘R — 重新读取。
- ⌘⇧F — 在服务器上查找。不是应用逐条扫描列表，而是由服务器执行
find。
差异显示
用 ⌘⇧Y 开启后，会把本地和远程并排比较，标出内容不同、只在一侧存在的文件。 适合只想发送必要文件时使用。
删除
⌘⌫ 默认会移动到服务器端的回收站，并且始终需要确认。 如果服务器未启用回收站，会事先提示此操作无法撤销。
⌨️终端
这是可以直接运行 vim·tmux·less 的真实 shell。 用鼠标拖选，再用 ⌘C 复制，命令粘贴时不带行尾多余的填充空格，干净利落。
粘贴确认
粘贴多行内容时，会先显示将要执行的内容。因为带换行的粘贴内容 会当场变成命令执行。看起来有风险的部分会连同原因一起标出。
放大查看
用 ⌘↩ 放大当前区域，再按一次返回。⌥⌘↩ 只放大单个面板。 字号快捷键是 ⌘+ · ⌘- · ⌘0。 用 ⌘L 清空终端——屏幕和滚动记录被清除，只留下当前提示行。
🔌串口控制台（UART）
选择设备
用 ⌃⌘N 添加串口控制台，然后在设置中选择已连接的设备。Berth 记住的不是路径，而是 设备本身 — 有序列号就用序列号识别，没有就用型号识别。插到不同的 USB 接口 也能找到同一台设备。
速率与线路设置
速率可以从列表中选择，也可以直接输入（像 1,500,000 这样的非标准值也可以 — 前提是适配器能接受 该值）。默认是8N1 · 无流控制，大多数控制台都用这个值。
- 流控制 — 只有使用四线线缆（RTS/CTS）时才开启。在三线线缆上开启反而会导致通信受阻。
- 高级（校验位·位数） — 点击该行即可展开。仅在需要 STM32 引导程序（8E1）这类特殊设置时使用。
记录板
在串口会话中，输入的命令及其响应会连同时间一起累积显示在右侧。 输入密码的位置会被遮盖。
⚡快捷键
应用快捷键中始终包含 ⌘。⌃·⌥ 组合键属于 shell 和 TUI（vim·tmux），应用不会占用它们。
| 按键 | 作用 |
|---|---|
| ⌘N · ⌃⌘N · ⌘⇧N | 添加服务器 · 添加串口控制台 · 新建文件夹 |
| ⌘I · ⌘⇧I | 此服务器设置 · 从 ~/.ssh/config 导入 |
| ⌘K | 去哪里 — 按名称查找并直接跳转 |
| ⌘1 … ⌘9 | 切换会话 |
| ⌃⌘← → ↑ ↓ | 在面板间移动 |
| ⌘↩ · ⌥⌘↩ | 放大 / 还原 · 仅放大此面板 |
| ⌘⇧S · ⌥⌘↑ ⌥⌘↓ | 侧边栏 · 移动分割线 |
| ⌥⌘→ · ⌥⌘← | 上传 · 下载 |
| ⌘D · ⌘R · ⌥⌘N | 固定/取消固定 · 重新读取 · 新建文件夹 |
| ⌘↓ · ⌘↑ · ⌥⌘T | 进入 · 返回 · 树状↔列表 |
| ⌘⌫ · ⌘⇧F | 在远程删除 · 在服务器上查找 |
| ⌘⇧V · ⌘⇧L · ⌘⇧Y | 将路径放入终端 · 终端自动跟随 · 差异显示 |
| ⌘+ ⌘- ⌘0 · ⌘⇧W | 字号 · 关闭此会话 |
| ⌘L · ⌘] ⌘[ | 清空终端 · 切换右侧面板标签 |
| ⌘C · ⌘⇧P · ⌘⇧U · ⌘? | 复制 · 存入记录 · 重发清单 · 使用手册 |
❓常见问题
密码保存在哪里？
只保存在 macOS 钥匙串中。设置文件里只会留下"已保存"的标记。 钥匙串只在连接的那一刻打开一次。
会收集使用记录吗？
不会。应用内没有任何埋点。不会统计打开了什么、连接到了哪里。
串口控制台中途停止。
这是在没有流控制的 UART 上进行大量通信时出现的线路特性。如果是四线线缆，请在设置中 开启流控制（RTS/CTS）；如果是三线，请尝试降低开发板一侧的速率，或将输出分批 发送。
已有的 SSH 配置需要重新填写吗？
不需要。从 ~/.ssh/config 导入后会直接使用原来的别名连接，并读取该配置块中的主机·端口·
用户·密钥·ProxyJump。
我的配置里用了 ProxyCommand。
ProxyCommand 会启动外部程序，因此在 App Store 的沙盒中无法使用。如果配置是为了
经由跳板机连接，改用 ProxyJump 即可照常使用。出于同样的原因也无法使用 ssh-agent，
会直接读取密钥文件，带密码保护的密钥会在连接时询问密码。
支持的 macOS 版本是？
macOS 14（Sonoma）及以上版本，Apple Silicon 和 Intel 机型均可使用。
如果这份说明对您有帮助
Berth 是免费的。您可以通过赞助支持来帮助它持续开发。