SSH 端口转发实战:-L、-R、-D 三种模式的差别与五个高频坑

举报
yd_257742204 发表于 2026/11/18 22:59:59 2026/11/18
【摘要】 从「谁监听、谁发起、谁受益」出发拆清本地转发、远程转发与动态转发的方向差异,附可直接复制的命令、GatewayPorts 与监听地址的关键细节,以及隧道建好却不通的五个排查点。

为什么值得把三种转发分清楚

几乎每个开发者都用过 ssh -L,但很多人分不清 -L、-R、-D 到底谁连谁。它们只差一个字母,方向却完全相反:-L 是把远端的服务拉到本地,-R 是把本地(或内网)的服务推到远端,-D 则是在本地起一个 SOCKS 代理。搞清楚「谁监听、谁发起、谁受益」这三件事,排障时间能从几小时降到几分钟。

下面按「作用、命令、典型场景、容易踩的坑」四段展开,命令都在 OpenSSH 8.x 上验证过。

本地转发 -L:把远端端口搬到本机

命令形态是 ssh -L [绑定地址:]本地端口:目标主机:目标端口 用户@跳板机。

它的语义是:SSH 客户端在本地监听一个端口,连到这个端口的数据,经加密隧道送到跳板机,再由跳板机去连「目标主机:目标端口」。

典型场景是数据库不对公网开放,只能从跳板机访问:

ssh -N -L 13306:10.0.1.20:3306 ops@jump.example.com
mysql -h 127.0.0.1 -P 13306 -u app -p

这里有两个细节经常被忽略。第一,目标主机 是从跳板机视角解析的,写 127.0.0.1 指的是跳板机自己,不是你的电脑。第二,监听地址默认是 127.0.0.1,只有写 -L 0.0.0.0:13306:... 时同网段的其他机器才连得进来——而这往往就是安全事件的起点,非必要不要开。

远程转发 -R:把本机服务暴露给远端

命令形态是 ssh -R [绑定地址:]远端端口:本地主机:本地端口 用户@远端机。

语义反过来:SSH 客户端请求远端机监听一个端口,连上该端口的数据经隧道回到本地,由本地去连「本地主机:本地端口」。

最常见的用途是给外部演示一个还在本机跑的服务:

ssh -N -R 8080:127.0.0.1:3000 demo@public.example.com
# 对方访问 http://public.example.com:8080 就能看到你本机的 3000 端口

注意远端监听地址同样受 sshd 的 GatewayPorts 控制。默认 no 时,即使你写 -R 0.0.0.0:8080:...,也只会监听在远端的回环地址上,别人连不上。这是「明明隧道建好了却访问不到」的第一大原因。

动态转发 -D:一个命令得到 SOCKS 代理

ssh -N -D 1080 用户@跳板机 会在本地 1080 起一个 SOCKS5 代理,所有经过它的连接都由跳板机发出。它适合临时让浏览器或命令行走某台机器的出口,而不必逐个端口配置 -L。

ssh -N -D 1080 ops@jump.example.com
curl --socks5-hostname 127.0.0.1:1080 https://ifconfig.me

--socks5-hostname 和 --socks5 的区别在于域名在哪一侧解析:前者把域名交给代理端解析,后者本地解析后再连 IP。做出口验证时用前者,才能真实反映代理侧的解析结果。

五个高频坑

其一,-N 与 -f 的取舍。 -N 表示不执行远程命令,只做转发;-f 让 SSH 转入后台。两者合用适合长期隧道,但后台化之后报错信息会消失,调试阶段建议先不加 -f。

其二,隧道活着但服务不通。 先用 ss -lntp | grep 端口 确认本地是否真的在监听,再用 ssh -v 看是否卡在认证或 channel open failure。channel 2: open failed: connect failed: Connection refused 通常是目标侧端口没开,而不是隧道坏了。

其三,连接空闲被掐断。 中间设备常清理长时间无数据的连接,加上 -o ServerAliveInterval=30 -o ServerAliveCountMax=3 可显著降低掉线率。

其四,端口被占用。 本地转发报 bind: Address already in use 时,不必换端口,先 lsof -i :13306 找到占用者;如果那是上一次没退干净的 ssh,直接结束它比换端口更干净。

其五,权限与审计。 生产环境里随手开 0.0.0.0 监听等于给内网开了一扇没有日志的门。至少要限制来源 IP,并在跳板机上保留 sshd 的连接日志,出问题时可回溯。

小结

记住一句话就够了:-L 是本机监听、远端发起;-R 是远端监听、本机发起;-D 是本机监听、远端替你出网。方向上想清楚了,参数就不会写反;再把 GatewayPorts、监听地址和保活三件事记住,绝大多数「隧道建好但不通」的问题都能在五分钟内定位。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。