正确写法是ssh -L 6379:10.20.30.40:6379 user@jump-host(Redis在内网服务器)或ssh -L 6379:127.0.0.1:6379 user@jump-host(Redis在跳板机),必须加-N且确认隧道生效、端口未被占用、跳板机能访问Redis、Redis绑定地址匹配。
ssh -L 命令怎么写才真正转发到 Redis
本地连不上 redis,十有八九是 ssh -l 的地址写错了。关键不是“能不能连跳板机”,而是“隧道是否精准指向 redis 服务端口”。
- 如果 Redis 在内网服务器
10.20.30.40上、监听默认6379,跳板机可直通该 IP:用ssh -L 6379:10.20.30.40:6379 user@jump-host - 如果 Redis 和跳板机在同一台机器(比如跳板机自己跑着 Redis),目标地址必须写
127.0.0.1,不是localhost(某些系统下localhost会走 socket):用ssh -L 6379:127.0.0.1:6379 user@jump-host -
-N必须加——它表示“不执行远程命令”,只维持隧道;漏掉会导致 SSH 登录后卡住或隧道秒断 - 别用
sudo启动隧道除非必要,否则redis-cli连127.0.0.1:6379时可能因权限被拒绝(如 macOS 的 port 保留机制)
redis-cli 连不通?先确认隧道真在跑
隧道看着起来了,redis-cli -h 127.0.0.1 -p 6379 却报 Connection refused,大概率是隧道没生效或被意外中断。
- 检查隧道进程:运行
ps aux | grep "ssh.*-L.*6379",确认输出里有你刚起的那条命令 - 本地端口是否被占:用
lsof -i :6379(macOS/Linux)或netstat -ano | findstr :6379(Windows WSL)看 6379 是否真被 ssh 占用 - 跳板机防火墙是否放行了它到 Redis 的出向连接?即使本地隧道通,跳板机仍需能
telnet 10.20.30.40 6379(从跳板机上测) - Redis 服务本身是否绑定了
127.0.0.1?若只监听127.0.0.1,而你隧道指向的是内网 IP,就会失败——此时得改 Redis 配置里的bind或用127.0.0.1作为 remote_bind_address
Python 脚本里用 SSHTunnelForwarder 怎么避免阻塞
用 SSHTunnelForwarder 时程序卡死、超时、或 local_bind_port 拿不到,基本是初始化或生命周期没管好。
- 必须显式调用
server.start(),且应在redis.Redis(...)之前;漏掉就等于没建隧道 - 别在脚本末尾忘了
server.stop(),否则下次运行可能因端口被占失败(尤其调试时反复 Ctrl+C 容易留僵尸隧道) -
remote_bind_address是 Redis 服务的真实地址+端口,和你在跳板机上能否ping或nc通它完全一致——不是跳板机的地址 - 密码/密钥选一个就好:
ssh_pkey和ssh_password别同时传,否则可能触发认证冲突 - 若 Redis 有密码,
redis.Redis(..., password="xxx")的password是数据库密码,不是 SSH 密码——这个错新手常犯
IDEA / TablePlus 等 GUI 工具连 Redis 的隐藏限制
图形工具看似点点就完事,但底层仍依赖 SSH 隧道,很多失败源于它们对隧道生命周期的“黑盒处理”。
- IDEA 的 Database 工具里填的
Host必须是127.0.0.1,Port填你本地映射的端口(如6379),**不能**填跳板机地址或 Redis 内网地址 - TablePlus 的 “SSH Tunnel” 选项卡里,“SSH Host” 填跳板机,“Remote Host” 填 Redis 内网地址(如
10.20.30.40),“Remote Port” 填6379——这里 Remote 不是“你本地”,而是“跳板机视角下的目标” - 所有 GUI 工具都要求 SSH 连接保持活跃;如果跳板机设置了
ClientAliveInterval,而工具没配保活,几分钟后隧道静默断开,再操作就报 timeout - 别指望 GUI 自动帮你重连隧道;断了就得手动重启连接,或换用命令行隧道 + GUI 连本地端口更可控
Connection refused 就准时出现。

















