Python利用SSHTunnelForwarder通过跳板机连接Redis实战

木白

发布时间：2026-10-13 | 5人浏览过

原创

本文介绍如何在Python中利用SSHTunnelForwarder模块，通过SSH跳板机建立隧道以连接内网Redis服务。文章对比了直接在跳板机执行命令与本地端口转发两种方案，重点推荐后者。提供了基于paramiko和SSHTunnelForwarder的具体代码实现，包括密钥加载、隧道开启及Redis客户端连接配置，帮助解决跨网络访问受限的Redis连接问题。

背景说明：我司的Redis服务器部署在亚马逊云服务上，本地环境访问该服务时，必须经过跳板机进行中转，只有获得相应权限后才能成功访问Redis。

连接原理：利用SSHTunnelForwarder模块，首先通过本地22端口使用SSH协议连接到跳板机，随后在本地开启一个转发端口，该端口将流量通过跳板机转发至远程的Redis服务。

实现此需求主要有两种思路：

第一种思路：利用SSHTunnelForwarder结合paramiko模块，先通过SSH登录到跳板机（或内部服务器），获取执行权限后，直接在跳板机上远程调用Redis服务。

第二种思路：使用SSHTunnelForwarder模块，通过本地22端口SSH连接至跳板机，并在本地开启一个转发端口，由该端口负责将请求转发给跳板机背后的远程Redis服务。

针对思路一的具体实现：

private_key_path = '/Users/xxx/.ssh/id_rsa'
rsaKey = paramiko.RSAKey.from_private_key_file(private_key_path)

ssh = paramiko.SSHClient()
ssh.set_missing_host_key_policy(paramiko.AutoAddPolicy())
ssh.connect(跳板机或者内网服务器IP或者域名, 22, username, rsaKey)
stdin, stdout, stderr = ssh.exec_command('redis-cli -h {} -p {} -n {} {}'.format(host, port, db, script))
result = stdout.read(), stderr.read()
for out in result: # 需要通过循环拿到stdout，否则为空值
  if out:
    return out

参考代码示例如下：

import paramiko
from sshtunnel import SSHTunnelForwarder

with SSHTunnelForwarder(
  (REMOTE_SERVER_IP, 443),
  ssh_username="",
  ssh_pkey="/var/ssh/rsa_key",
  ssh_private_key_password="secret",
  remote_bind_address=(PRIVATE_SERVER_IP, 22),
  local_bind_address=('0.0.0.0', 10022)
) as tunnel:
  client = paramiko.SSHClient()
  client.load_system_host_keys()
  client.set_missing_host_key_policy(paramiko.AutoAddPolicy())
  client.connect('127.0.0.1', 10022)
  # do some operations with client session
  client.close()

print('FINISH!')

针对思路二的具体实现：

# 使用SSHTunnelForwarder隧道，通过跳板机链接Redis
with SSHTunnelForwarder(
    ('xxx.xxx.xx.xx', 22), # 跳板机
    ssh_username=username,
    ssh_pkey="/Users/xxx/.ssh/id_rsa",
    remote_bind_address=('xx.xx.xx.xxx', 6379), # 远程的Redis服务器
    local_bind_address=('0.0.0.0', 10022) # 开启本地转发端口
) as server:
  server.start() # 开启隧道
  print(server.local_bind_port)
  # 本地通过local_bind_port端口转发，利用跳板机，链接Redis服务
  cls.red = redis.Redis(host='127.0.0.1', port=server.local_bind_port, db=db, decode_responses=True)
  server.close() # 关闭隧道

建议：

通常情况下，跳板机是一个相对干净的环境，而公司内网服务器大多未赋予相关权限或未安装redis-client客户端。因此，推荐采用方法二，即本地端口转发的方式。

SSHTunnelForwarder模块的使用文档可参考：https://pypi.python.org/pypi/sshtunnel/

以上关于Python通过SSHTunnelForwarder隧道连接Redis的方法即为分享的全部内容，希望能对读者有所帮助，也欢迎大家继续支持本站。