Ubuntu 安装 Redis 并配置远程连接指南

EEva·二月 28, 2026·2 min read

基础配置教程

1. 更新包列表

sudo apt update

2. 安装 Redis

sudo apt install redis-server -y

3. 启动并设置开机自启

sudo systemctl enable redis-server

4. 验证服务状态

sudo systemctl status redis-server

5. 基本配置
打开配置文件进行编辑:

sudo vim /etc/redis/redis.conf

找到并修改以下核心项:

# 允许外部连接(默认只允许本机)
bind 0.0.0.0

# 关闭保护模式
protected-mode no

# 设置密码(必须!否则裸奔极其容易被入侵挖矿)
requirepass 你的强密码

常用配置项说明表:

配置项 说明 建议值
bind 监听地址 仅本机用 127.0.0.1,需远程访问改为 0.0.0.0
requirepass 设置密码 生产环境必须设置
maxmemory 最大内存限制 256mb
supervised 进程管理方式 改为 systemd

6. 重启生效

sudo systemctl restart redis-server

7. 开放防火墙端口

sudo ufw allow 6379/tcp

注意:如果是云服务器(如腾讯云/阿里云等),还需要在云控制台的“安全组”中放行 6379 端口的入站规则。

8. 本地连接测试
在客户端机器上执行:

redis-cli -h 你的服务器公网IP -p 6379 -a 你的强密码

连上后输入 ping,如果返回 PONG 即代表连接成功。

连接失败排查指南

如果连接不上,请按照以下 5 步由浅入深逐步排查:

1. 先确认服务端 Redis 是否在运行
在线上服务器执行:

sudo systemctl status redis-server

2. 检查 Redis 监听地址
确认配置文件中的 bind 设置是否正确:

sudo grep "^bind" /etc/redis/redis.conf

确保输出是 bind 0.0.0.0,而不是 bind 127.0.0.1

3. 确认 Redis 实际监听端口
查看网络端口占用情况:

sudo ss -tlnp | grep 6379

正常应显示监听 0.0.0.0:6379。如果是 127.0.0.1:6379,说明 bind 没改对或改完没有重启服务。

4. 检查防火墙状态
查看防火墙规则,确认 6379 端口已放行:

sudo ufw status

5. 最关键:检查云服务器安全组
如果是云服务器(例如腾讯云 119.91 开头的 IP),必须去云厂商的控制台增加安全组规则。
操作路径举例:腾讯云控制台 → 安全组 → 入站规则,添加如下配置:

协议 端口 来源
TCP 6379 0.0.0.0/0