XPipe SSH 中转服务器配置：3 步直连内网服务器，不用记命令

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

XPipe 是一个桌面端服务器连接中枢，基于本地已装好的 ssh 等命令行工具，把终端、文件浏览等操作变成一次点击。如果你要从工作站访问防火墙后面的内网机器，而唯一公网入口只有一台跳板机，本文带你在 3 分钟内用 XPipe 的 SSH 隧道（中转）功能把链路打通。

痛点：内网机器为什么直连不了

• 内网服务器没有公网 IP，从家庭或办公网络直连必然超时
• 每次手敲ssh -J跳板语法很麻烦，主机、端口、账号都要靠记
• 想连 RDP、VNC 时还得再手动做端口转发，容易配错

对上号的话，往下看。

第 1 步：30 秒录入跳板机

1. 打开 XPipe 连接中心，点"新建连接"，协议选择 SSH
2. 主机地址填跳板机的公网 IP 或域名，端口默认 22（自定义端口需同步开防火墙）
3. 认证方式二选一：用户名 + 密码，或密钥文件；密钥认证直接在本地选私钥文件即可

做完后应该看到：保存后点"测试连接"出现成功提示（或点"启动终端"能进入跳板机 shell），说明这台跳板机已经可用。

认证策略的源码入口在 SshIdentityStrategy，密钥文件同步等选项由 SshIdentityStrategyChoiceConfig 控制。

第 2 步：内网地址填在哪里

1. 再新建一个连接，协议仍是 SSH
2. 主机地址填内网 IP，例如192.168.1.100
3. 在高级选项中启用"通过隧道连接"，下拉选择第 1 步配好的跳板机

做完后应该看到：列表里该主机带上隧道标识，点"测试连接"会先经跳板机再落到目标机，而不是直连超时。

底层的两层模型分别在 HostAddressTunnelStore（声明主机可走隧道）和 HostAddressGatewayStore（声明主机可当网关被别人借用）。

第 3 步：验证链路是否真正打通

点"连接"后，XPipe 自动完成三件事：

1. 建立本地到跳板机的 SSH 会话
2. 在其上创建端口转发，把内网端口映射到本地
3. 在你选定的终端启动 shell，或打开文件浏览器

验证方法：终端打开后先执行hostname，确认输出来自内网机器；再用curl访问一个内网服务，有响应即全链路 OK。文件浏览器模式下，进入家目录能看到文件列表同样算成功。

想弄清隧道机制的读者可以翻 NetworkTunnelStore，其中createTunnelSession(localPort, remotePort, address)就是"把内网端口映射到本地端口"的抽象，本地转发与远程转发都建立在这个接口上。

连不通时先查这 3 项

• 跳板机 22 端口被防火墙挡了：先用本地ssh 用户@跳板机单独验证能否登录
• 内网地址填成了公网 IP：应填跳板机视角能路由到的地址，通常是 10.x / 192.168.x 网段
• 目标机认证没配对：隧道只借用跳板机的网络通道，目标机的账号或密钥要单独验证

整套流程就是：登记跳板 → 目标挂到跳板上 → 点击连接。报错信息原文贴出来即可，欢迎留言；下期讲讲几十台机器的批量管理。

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