一、基础知识

SSH 除了远程登录,还能把别的 TCP 流量塞进加密通道里中转,这就是端口转发(也叫 SSH 隧道)。它常用于临时访问内网服务,不用真的在防火墙上开洞。

三种基本类型:

  • 本地转发 -L:在你自己的机器上开一个端口,访问它的流量经 SSH 服务器中转到目标服务。典型场景是你在外面,想访问公司内网的数据库或网站。
  • 远程转发 -R:在 SSH 服务器上开一个端口,访问它的流量经你的机器中转到目标。典型场景是你在本机跑了个服务,想让远端机器访问到。
  • 动态转发 -D:开一个 SOCKS 代理端口,按目标地址动态转发,适合浏览器等复杂场景。

命令格式要记牢:

# -L 格式:-L 本地地址:本地端口:目标主机:目标端口
# -R 格式:-R 远程地址:远程端口:目标主机:目标端口

理解 -L 和 -R 的区别,抓住一句话:谁监听,流量就从谁那侧进入;"目标主机"总由隧道另一端(数据出口)去连接。对 -L,出口是 SSH 服务器,目标由 SSH 服务器去连;对 -R,出口是你的本机,目标由你的本机去连。方向搞反是最常见的错误。

另外,-N 表示不执行远程命令(只建隧道),-f 表示后台运行,建隧道时通常两个一起用。

还有两个容易混淆的点。一是端口转发只转发 TCP,不转发 UDP,需要 UDP 的场景不适合用它。二是隧道完全依赖那条 SSH 连接,连接一断,所有经它的转发立刻失效。偶尔用一下,前台运行最省心;要长期挂着,就得考虑心跳和进程守护。另外要记住,转发只是在两端之间搭桥,并不会替你做身份认证,被转发的业务服务该有的鉴权一样都不能少,否则等于把后门敞开。

二、实操步骤

假设场景:跳板机 192.0.2.10,内网网站 192.0.2.20:80,你的本机要访问它;另外你本机 127.0.0.1:3000 有个服务,想让跳板机访问。

第 1 步:本地转发访问内网网站。

# 本机 8080 端口 -> 经跳板机 -> 192.0.2.20 的 80
ssh -L 8080:192.0.2.20:80 -N -f demo@192.0.2.10
# 验证:访问本机 8080 应拿到内网网站内容
curl -v http://127.0.0.1:8080

第 2 步:远程转发把本机服务暴露给跳板机。

# 跳板机 9000 端口 -> 经本机 -> 本机 3000 端口服务
ssh -R 9000:127.0.0.1:3000 -N -f demo@192.0.2.10

第 3 步:查看监听是否建立。

ss -lntp | grep -E '8080|9000'

第 4 步:在跳板机上验证远程转发。

ssh demo@192.0.2.10 'curl -v http://127.0.0.1:9000'

第 5 步:如需让外部访问 -R 的端口,检查并调整 GatewayPorts。

# 在跳板机(服务端)查看配置
sudo grep -i GatewayPorts /etc/ssh/sshd_config
# 若需对外监听,配置为 clientspecified(或 yes)后重载,具体取值以官方文档为准
sudo systemctl reload sshd
# 客户端改为绑定 0.0.0.0
ssh -R 0.0.0.0:9000:127.0.0.1:3000 -N -f demo@192.0.2.10

第 6 步:关闭隧道。 后台隧道不会自动消失,需要找出进程并结束:

ps -ef | grep 'ssh .*-[LR]'
# 找到对应 PID 后
kill <PID>

三、关键细节

  1. 默认只监听回环地址。 -L 开的本地端口、-R 开的远程端口默认都绑在 127.0.0.1,只有本机能连;想让局域网或公网访问,必须显式绑定地址并配合相应配置。
  2. GatewayPorts 是 -R 的常见卡点。 远程转发默认拒绝非本地连接,服务端 GatewayPorts 未配置时,外部机器连跳板机的 9000 端口会失败。
  3. 目标地址的解析视角不同。 -L 的目标 192.0.2.20 是跳板机去连,所以要在跳板机上能访问;-R 的目标 127.0.0.1:3000 是你本机去连。
  4. 端口被占用会建隧道失败。 报 bind: Address already in use 时,先 ss -lntp 看端口归属,换一个端口最省事。
  5. 空闲连接可能被断开。 长时间没流量,中间设备可能掐断隧道,可配合 ServerAliveInterval 等心跳参数(具体取值以官方文档为准)。
  6. 调试时别用 -f。 想看实时日志就把 -f 去掉,或加 -v,前台运行能直接看到建立过程和错误。
  7. 动态转发 -D 是另一种思路。 当你不确定要访问哪些目标、哪些端口时,SOCKS 代理比逐条 -L 灵活得多,但使用的客户端软件要支持 SOCKS 协议。

四、常见错误

现象 原因 修正
-L 后 curl 本地 8080 报连接被拒 隧道没成功建立,或绑到了别的地址 ss -lntp 确认监听;去掉 -f 前台运行看报错
-R 后别的机器连跳板机 9000 不通 只绑了 127.0.0.1,且 GatewayPorts 关闭 服务端配置 GatewayPorts,命令用 0.0.0.0:9000
报 bind: Address already in use 本地或远端端口已被占用 ss -lntp 查占用,改用空闲端口
隧道建好后过一会儿自动断开 空闲超时被中间设备掐断 配置心跳参数,或保持流量;必要时用进程守护
-L 访问目标一直超时 从跳板机视角目标不可达 在跳板机上 nc -vz 192.0.2.20 80 验证连通性
后台隧道找不到、关不掉 -f 让进程脱离终端 ps -ef | grep ssh 找到 PID 后 kill

五、排查方法

按下面顺序逐层排查:

# 1. 隧道有没有在监听、绑在哪个地址
ss -lntp | grep -E '8080|9000'

# 2. 从入口端测试连通
curl -v http://127.0.0.1:8080

# 3. -L 场景:确认目标从跳板机视角可达
ssh demo@192.0.2.10 'nc -vz 192.0.2.20 80'

# 4. 前台运行看详细建立日志
ssh -L 8080:192.0.2.20:80 -vvv demo@192.0.2.10

# 5. -R 场景:确认服务端 GatewayPorts 设置
sudo grep -i gatewayports /etc/ssh/sshd_config

先看"监听有没有起来",再看"目标从对端能不能连通",最后看"监听地址对不对",三步走完基本能覆盖所有隧道不通的情况。还要特别注意:隧道"建立成功"不等于"数据能通",命令没报错只说明 SSH 连上了、端口监听上了,一定要从入口实际访问一次业务地址,才算真正验证通过。

六、注意事项

  • 端口转发会绕过部分防火墙策略,使用前应遵守所在单位的安全规范,不要擅自把内网服务暴露到公网。
  • -R 把本机服务暴露出去风险较高,务必限制来源地址并对服务本身加认证,避免成为跳板。
  • 1024 以下的特权端口需要管理员权限,普通用户建议用 1024 以上的端口。
  • 各 OpenSSH 版本对 GatewayPorts、心跳参数的支持和默认行为可能不同,请以官方文档和 man ssh 为准。
  • 文中 192.0.2.10、192.0.2.20 均为文档保留地址,仅用于演示,请勿替换为任意真实第三方站点。

免责声明:本文为个人学习与实操经验总结,仅代表个人观点,不构成任何技术或商业决策建议。不同系统环境与版本可能存在差异,实际操作请以官方文档为准并自行验证。