连接拓扑

连接拓扑（也称连接矩阵）提供一个实时画布视图，将你的 SSH 连接图谱可视化——完整展示堡垒机链路、ProxyJump 层级及每个节点的当前状态。

它不只是一个装饰性的关系图。拓扑视图反映的是 OxideTerm 在 ProxyJump、自动路由和重连编排里实际使用的同一套路由模型。

概述

[本地机器]
    │
    ├──● bastion.example.com (Active)
    │       │
    │       ├──● prod-server-1 (Active)
    │       │       └──● internal-db (Idle)
    │       │
    │       └──● prod-server-2 (Link Down)
    │
    └──● dev.example.com (Active)

每个节点代表一个 SSH 端点。边表示连接路径（直连或通过 ProxyJump）。

这张图来自当前活跃会话和已保存的跳板关系：

• 直连主机会显示为根节点
• 从 ~/.ssh/config 导入的 ProxyJump 链会保留父子结构
• 可复用的堡垒机既可以作为独立会话，也可以作为下游路由的父节点
• active、idle、link_down、reconnecting 等状态来自连接池，而不是静态示意图

节点状态颜色

颜色	状态	含义
绿色 ●	Active	连接正常，有活跃 channel
蓝色 ●	Idle	连接中但无活跃消费者
红色 ●	Link Down	连接丢失，等待重连
橙色 ●	Reconnecting	正在尝试重连
灰色 ○	Disconnected	已断开，未在池中

画布控件

操作	功能
鼠标滚轮	缩放画布
拖拽空白处	平移视图
点击节点	选中并查看详情
右键节点	打开上下文菜单
全屏按钮	全屏视图

节点右键菜单

右键单击任意节点即可访问快捷操作：

• 打开终端 — 直接向该节点打开新终端标签页
• 打开 SFTP — 打开 SFTP 文件管理器
• 端口转发 — 快速添加转发规则
• 断开连接 — 断开此节点
• 查看详情 — 显示连接统计面板

级联状态传播

当堡垒机（ProxyJump 上游节点）进入 link_down 状态时，所有下游节点自动继承该状态并显示为断开——拓扑图会立即反映变化，便于快速定位故障根节点。

重连成功后，节点状态按层级逐步恢复（堡垒机优先，下游节点随后）。

路由规划与自动路由

当目标主机存在多条可选路径时，OxideTerm 可以从已保存的连接图中自动选择合适路由。

• ProxyJump 路径会在拓扑中表现为边
• Auto-Route 会从当前可达路径集合中选择目标路线
• 父级跳板会被复用，而不是重复拨号建立多条相同 SSH 隧道
• 画布可以帮助你快速看清目标为什么可达、降级或被某一跳阻塞

当你的 SSH config 和保存连接中同时存在多层堡垒机时，这一点尤其有用。

Grace Period 恢复过程

拓扑状态也会同步反映 OxideTerm 的重连行为：

• 父节点掉线时，下游子节点会一起进入 link_down
• 在 30 秒 Grace Period 内，OxideTerm 会先探测旧链路是否能恢复
• 如果旧路径恢复成功，整条链不会被强制拆掉重建
• 如果恢复失败，则会按父节点优先的顺序重连，让子路由按顺序重新挂接

使用场景

• 故障排查 — 一眼看出哪条 ProxyJump 链卡在何处
• 容量规划 — 直观掌握多少连接通过同一堡垒机聚合
• 运维演练 — 在操作之前确认拓扑结构正确