第 10 章SSH 隧道
数据库只允许内网访问时,通过一台跳板机把连接转发进去。 配置好之后,用户不需要在终端里手动开隧道——连接行为和直连完全一样。
它是怎么工作的
复用你本机的 SSH 配置
隧道复用 macOS 上标准的 SSH 配置,所以你已有的 ~/.ssh/config、
known_hosts、ssh-agent 直接生效:
- 各种密钥类型、跳板机、代理都已经处理好了,不用额外配置。
- 隧道必需的连接超时、保活、首次自动接受主机指纹这几项由 TableLite 统一决定,会覆盖 SSH 配置里的同名项(见「三种认证方式」)。
隧道只在你连接期间存在,关闭连接或退出 App 时会被清理干净。
配置项
都在连接配置表单的「SSH 隧道」区域里。
| 字段 | 说明 |
|---|---|
| 通过 SSH 连接 | 连接表单顶部的「直连 / SSH 隧道」分段控件;选「SSH 隧道」后下面这些字段才可用 |
| SSH 主机 | 跳板机的域名或 IP。开启「使用 ssh config 别名」时,可以填 ~/.ssh/config 里的 Host 名 |
| SSH 端口 | 默认 22 |
| SSH 用户 | 登录跳板机的用户名 |
| 认证方式 | 三选一,见下 |
| 使用 ssh config 别名 | 勾选后由系统 SSH 配置解析该主机(包括别名、端口、用户、密钥) |
| 跳板机 | 形如 user@proxy:22,用于「先连 A 再跳 B」的场景 |
三种认证方式
连接过程中的提示
连接时连接列表里那一行依次显示两条:
正在建立 SSH 隧道…正在连接 MySQL…
隧道建立成功后,隧道信息会出现在工具栏连接切换器的悬停详情里,而且只在那里显示—— 主界面不显示本地端口,避免干扰。
首次连接一台新主机
自动接受新指纹,但不接受变化的指纹
系统 SSH 会记录主机指纹。TableLite 的行为是:
- 首次连接一台新主机时,自动接受它的指纹——等同于系统 SSH 默认的
accept-new。 这样你不用先在终端里连一次。 - 如果主机指纹发生了变化(可能是服务器重装,也可能是中间人攻击), 直接失败并展示完整警告,不会静默忽略。
隧道断开
- 连接状态变成红点。
- 连接切换器的悬停详情与内容区遮罩显示
SSH 隧道已断开。 - 不自动重连——避免在你不知情的时候反复建立隧道。
- 点「重新连接」后,会重开隧道并重连数据库。
断开与退出时的清理
隧道不会残留
- 关闭连接时同时关掉隧道。
- 退出 App 时清理所有隧道。
不会出现「界面里已经断开、后台还留着隧道」的情况。
错误提示
| 情况 | 提示 |
|---|---|
| 跳板机无法连通 | 无法连接到 SSH 主机 bastion.example.com:22(连接超时) |
| 用户 / 密码错误 | SSH 认证失败:Permission denied (password). |
| 私钥错误或需要口令 | SSH 认证失败:私钥需要口令,或密钥未被接受 |
| 目标数据库不可达 | SSH 隧道建立成功,但无法从跳板机访问 10.0.2.5:3306 |
| 主机指纹变化 | 见上方的警告面板 |
| 跳板机上没有权限 | 原样展示 SSH 的错误输出 |
明确不做
关于 SSH 的边界
- 不支持在界面里生成或管理 SSH 密钥(用
ssh-keygen) - 不支持端口转发之外的其他 SSH 功能(远程执行命令、SFTP)
- 不支持保存多个跳板机的层级——只支持一个「跳板机」字段
- 不支持在 App 内编辑
~/.ssh/config,请用文本编辑器 - 不覆盖
known_hosts里已存在的主机记录——新主机指纹会自动记录,但指纹变化时绝不静默改写