Redis 7.0是常用的高性能键值数据库,很多用户通过宝塔面板部署后,本地可以正常访问,但远程客户端连接时会出现超时、拒绝连接等错误,这类问题大多和配置限制、端口未放行有关。

问题排查前置准备
在修改配置前,先确认Redis 7.0服务已经在宝塔面板正常运行,同时记录当前Redis的监听端口,默认端口是6379,若自定义过端口需要提前记好。可以通过宝塔面板的软件商店,找到Redis 7.0查看运行状态,确认服务没有报错。
修改Redis 7.0配置文件
Redis默认配置只允许本地回环地址访问,需要修改配置文件开放远程访问权限,具体步骤如下:
1. 打开配置文件
在宝塔面板左侧导航栏找到软件商店,点击已安装的Redis 7.0,选择配置修改选项,即可打开Redis的配置文件redis.conf。
2. 修改核心配置项
在配置文件中找到以下两个关键配置,按照要求修改:
- bind配置:默认是
bind 127.0.0.1 -::1,表示只允许本地IPv4和IPv6访问,需要将其注释掉或者修改为bind 0.0.0.0,允许所有网络地址访问。 - protected-mode配置:默认是
protected-mode yes,开启保护模式会拒绝外部未授权的访问,需要将其修改为protected-mode no,关闭保护模式。 - 如果需要设置访问密码,找到
requirepass配置,去掉前面的#注释,后面跟上自定义密码,比如requirepass my_redis_password。
修改完成后点击保存,然后重启Redis 7.0服务,让配置生效。
3. 配置修改示例
修改后的关键配置片段如下:
# 允许所有地址访问Redis bind 0.0.0.0 # 关闭保护模式 protected-mode no # 设置访问密码,按需开启 requirepass my_redis_password
放行系统防火墙端口
修改完Redis配置后,还需要确保系统防火墙放行了Redis的监听端口,否则外部请求还是无法到达服务。
1. 宝塔面板防火墙放行
在宝塔面板左侧导航栏找到安全选项,进入系统防火墙页面,在端口放行区域,输入Redis的监听端口(默认6379),备注填写Redis,协议选择TCP,然后点击放行按钮。
2. 云服务器安全组放行(按需操作)
如果你的服务器是阿里云、腾讯云等云厂商的实例,还需要登录云厂商控制台,找到对应实例的安全组规则,添加入方向规则,端口范围填写Redis端口,授权对象填写0.0.0.0/0,协议选择TCP,保存规则。
验证远程连接
完成以上所有步骤后,可以通过远程客户端验证连接是否成功,以下是使用Python客户端验证的示例:
import redis
# 替换为你的服务器公网IP、Redis端口和密码
redis_client = redis.Redis(
host='你的服务器公网IP',
port=6379,
password='my_redis_password', # 若未设置密码则删除该参数
decode_responses=True
)
# 测试写入和读取数据
redis_client.set('test_key', 'hello_redis')
result = redis_client.get('test_key')
print(result) # 输出hello_redis表示连接成功
如果执行后正常输出结果,说明Redis 7.0已经可以正常远程连接。如果还是连接失败,可以检查服务器公网IP是否正确、端口是否和配置一致、密码是否填写正确,再逐步排查问题。
注意事项
- 关闭保护模式、开放所有地址访问后,建议一定要设置强密码,避免Redis被未授权访问导致数据泄露。
- 如果修改配置后重启服务失败,可以查看Redis的错误日志,日志路径可以在宝塔面板的Redis管理页面找到,根据错误提示调整配置。
- 生产环境不建议直接开放0.0.0.0访问,可以按需设置bind的IP地址,只允许指定的客户端IP访问,提升安全性。