Redis连接被拒绝(Connection refused)问题的完整解决指南_Redis

问题现象

当尝试连接redis时出现以下错误：

could not connect to redis at 192.168.1.48:6379: connection refused

问题诊断流程

1. 基础状态检查

# 检查redis服务状态
systemctl status redis

# 检查redis是否安装
redis-server --version
redis-cli --version
which redis-server

# 检查redis进程
ps aux | grep redis
pgrep -lf redis

# 检查端口监听状态
netstat -tlnp | grep 6379
ss -tlnp | grep 6379

2. 连接测试

# 本地连接测试
redis-cli ping

# 远程连接测试
redis-cli -h 目标ip ping

常见原因及解决方案

情况一：redis服务未安装

症状：redis-server --version命令无输出

解决方案：

# ubuntu/debian
sudo apt update && sudo apt install redis-server

# centos/rhel
sudo yum install redis
# 或
sudo dnf install redis

情况二：redis服务未启动

症状：服务已安装但进程不存在

解决方案：

# 临时启动redis
redis-server --daemonize yes

# 或使用配置文件启动
redis-server /etc/redis/redis.conf

# 创建系统服务（推荐）
sudo systemctl enable redis
sudo systemctl start redis

情况三：配置限制

症状：本地可连接，远程无法连接

解决方案：
编辑redis配置文件 /etc/redis/redis.conf：

# 允许远程连接
bind 0.0.0.0

# 关闭保护模式（测试环境）
protected-mode no

# 设置密码（可选）
requirepass yourpassword

# 后台运行
daemonize yes

重启服务使配置生效：

sudo systemctl restart redis
# 或
pkill redis-server && redis-server /etc/redis/redis.conf

情况四：防火墙阻挡

症状：服务运行正常但无法连接

解决方案：

# 检查防火墙状态
sudo ufw status
sudo iptables -l

# 开放redis端口
sudo ufw allow 6379
# 或
sudo iptables -a input -p tcp --dport 6379 -j accept

# 永久保存iptables规则
sudo service iptables save  # centos
# 或安装iptables-persistent (ubuntu/debian)

情况五：服务配置问题

创建完整的systemd服务文件：

sudo cat > /etc/systemd/system/redis.service << eof
[unit]
description=redis in-memory data store
after=network.target

[service]
type=forking
execstart=/usr/bin/redis-server /etc/redis/redis.conf
execstop=/usr/bin/redis-cli shutdown
restart=always
user=redis
group=redis
runtimedirectory=redis
runtimedirectorymode=0755

[install]
wantedby=multi-user.target
eof

启用服务：

sudo systemctl daemon-reload
sudo systemctl enable redis
sudo systemctl start redis

高级排查技巧

1. 查看redis日志

# 查看系统日志
sudo journalctl -u redis

# 或查看redis日志文件
sudo tail -f /var/log/redis/redis-server.log

2. 检查资源限制

# 检查内存
free -h

# 检查磁盘空间
df -h

# 检查文件描述符限制
ulimit -n

3. 网络诊断

# 测试端口连通性
telnet 目标ip 6379
nc -zv 目标ip 6379

# 检查端口占用
sudo lsof -i :6379

4. 配置验证

# 检查配置文件语法
redis-check-rdb /etc/redis/redis.conf

# 测试配置
redis-server /etc/redis/redis.conf --test

安全配置建议

1. 生产环境安全设置

# 在redis.conf中设置
requirepass 强密码
rename-command flushall ""
rename-command config ""
bind 指定ip地址
port 自定义端口

2. 网络隔离

# 使用防火墙限制访问ip
sudo ufw allow from 信任ip to any port 6379

# 或使用iptables
sudo iptables -a input -p tcp -s 信任ip --dport 6379 -j accept

自动化监控脚本

创建健康检查脚本：

#!/bin/bash
redis_host="localhost"
redis_port="6379"

if redis-cli -h $redis_host -p $redis_port ping | grep -q "pong"; then
    echo "redis is running"
    exit 0
else
    echo "redis is down"
    # 尝试重启
    sudo systemctl restart redis
    exit 1
fi