用一台跳板机连通内网服务器：XPipe 中转 SSH 隧道配置实操

【免费下载链接】xpipeAccess your entire server infrastructure from your local desktop项目地址: https://gitcode.com/GitHub_Trending/xp/xpipe

当本地机器无法直连内网里的服务器时，一台公网可达的跳板机加一条 SSH 隧道就能解决问题。下面以 XPipe 为例，把跳板机从注册到连通内网服务器完整走一遍，全程图形化填写，不需要敲任何命令行。

一、准备工作

本节列出开始前需要具备的条件，避免配置到一半卡住。

• 已安装 XPipe，且本地装有 SSH 客户端（XPipe 基于你本机的命令行程序工作，远端无需任何安装）
• 一台公网可达的跳板服务器，且该机能直连内网目标服务器
• 跳板机的 SSH 账号、端口（默认 22），认证密钥或密码
• 目标内网服务器的 IP、端口及其 SSH 账号
• 如跳板机改过默认端口，确认防火墙已放行该端口

二、它是怎么工作的（原理速览）

本节用几句话讲清数据走向，让你明白隧道建在哪一段。

你在 XPipe 里发起连接时，应用先用本地 SSH 客户端登录公网上的跳板机；随后在这条 SSH 会话之上建立一条端口转发通道，把内网目标机器的服务端口映射到本机。之后你的终端或客户端请求走这个本地端口，由跳板机转发进内网，内网服务端口始终不暴露到公网。整条链路是"本地→跳板机→内网"两跳，网关（Gateway）就是这个中转跳。隧道接口定义可参考 NetworkTunnelStore.java，功能总览见 README.md。

三、实操流程

① 注册跳板机连接

本步把公网跳板机登记进 XPipe，供后续作为网关选择。

1. 打开连接中心，点击新建连接
2. 选择 SSH 系统类型，填写跳板机的公网 IP 或域名
3. 认证方式优先选密钥，其次密码；填写用户名，端口默认 22
4. 保存，连接会出现在连接列表中

② 为目标服务器挂上隧道

本步新建内网服务器连接，并把跳板机指定为它的网关。

1. 回到连接中心再次点击新建连接
2. 填写内网 IP（如 192.168.1.100）与服务端口
3. 在"网关"（可选的网关系统，可通过该系统访问此主机）下拉框中选择步骤 ① 注册的跳板机
4. 网关类型按需选择：网关隧道由 XPipe 管理隧道会话，ProxyJump 则由 SSH 客户端直接完成跳转，一般保持默认即可
5. 填写目标机认证信息并保存

网关字段在源码中即主机存储里的gateway属性，定义见 AbstractHostStore.java。

③ 首次连通验证

本步真正建立连接，确认隧道链路可用。

1. 选中内网服务器连接条目，点击启动终端（或你需要的服务）
2. XPipe 会先建立到跳板机的 SSH 连接，再开启转发端口登录内网机器
3. 看到目标机的登录提示符，即表示配置完成

四、验证与排错

本节给出判断连通的依据，并回答三个高频问题。

判断连通的依据：终端里hostname显示的是内网机器的名字；或从终端访问目标机服务（如 8080 端口）有响应。

• 连接超时：多为跳板机端口未放行，或跳板机到内网目标不通。先检查跳板机防火墙，再在跳板机上验证到内网端口的连通性。
• 认证失败：密钥或密码不对、用户名缺失。核对 XPipe 身份存储里登记的凭据，确认两端账号都存在。
• 提示父主机不支持隧道：网关必须是可以承载隧道的 SSH 类主机。检查选中的网关类型，校验逻辑见 NetworkTunnelStore.java 的checkTunnelable。

五、进阶与延伸

• 把跳板机设为某类连接的默认网关，该分类下的新连接自动走这条通道，免逐台指定
• 密钥文件与凭据统一在身份存储中维护，便于轮换，配置结构见 SshIdentityStrategyChoiceConfig.java
• 隧道打通后，RDP、VNC 等服务可挂同一条跳转链路打开，参考 README.md 的 Connection hub 章节

跳板配置一次配好后基本不用动，新增内网机器时只需在建连接时选一下网关即可。如果你有多跳网关或混合网络下的特殊情况，欢迎在评论区描述场景，一起看看 XPipe 里怎么配。

【免费下载链接】xpipeAccess your entire server infrastructure from your local desktop项目地址: https://gitcode.com/GitHub_Trending/xp/xpipe