小易说IT 小易说IT

Debian 11 安装 Redis 完整教程

Debian11 代号 bullseye,提供两种安装方式:官方 apt 源(简单稳定,版本偏旧)、Redis 官方源(最新稳定版,推荐)

方式一:Redis 官方源(推荐,新版 Redis 7.x)

1. 安装依赖

apt update && apt install -y lsb-release curl gpg

2. 导入 Redis GPG 密钥

curl -fsSL https://packages.redis.io/gpg | gpg --dearmor -o /usr/share/keyrings/redis-archive-keyring.gpg

3. 添加 Redis 官方软件源

echo "deb [signed-by=/usr/share/keyrings/redis-archive-keyring.gpg] https://packages.redis.io/deb $(lsb_release -cs) main" | tee /etc/apt/sources.list.d/redis.list

4. 更新源并安装 redis-server

apt update
apt install -y redis-server

方式二:Debian 11 自带 apt 源(Redis 6.x,无需额外加源)

apt update
apt install -y redis-server

基础配置与开机自启

1. 查看服务状态

systemctl status redis-server

安装完成默认自动启动。

2. 开机自启(默认已开启)

systemctl enable redis-server

3. 启停命令

# 重启
systemctl restart redis-server
# 停止
systemctl stop redis-server
# 启动
systemctl start redis-server

核心配置(远程访问 + 密码,生产必改)

配置文件路径:/etc/redis/redis.conf

vim /etc/redis/redis.conf

修改 1:开启密码认证(安全必备)

找到 # requirepass foobared 取消注释,修改密码:

requirepass 你的强密码

修改 2:允许外部远程连接

默认 bind 127.0.0.1 仅本地访问

  • 允许所有 IP 访问(测试环境):

bind 0.0.0.0
  • 仅指定网段访问(生产推荐):

bind 127.0.0.1 192.168.1.0/24

修改 3:关闭保护模式(远程访问必须)

找到 protected-mode yes 改为

protected-mode no

4. 保存重启生效

systemctl restart redis-server

防火墙放行端口(Redis 默认 6379)

Debian11 默认使用 ufw 防火墙

# 放行6379端口
ufw allow 6379/tcp
# 重载防火墙
ufw reload

连接测试

本地连接

redis-cli
# 输入密码认证
AUTH 你的密码
# 测试写入
SET test 123
GET test

远程连接(其他服务器 / 本地电脑)

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

后台持久化简单配置(可选)

在 redis.conf 开启 RDB 持久化,防止数据丢失

# 900秒有1个key变更则快照
save 900 1
save 300 10
save 60 10000

卸载 Redis(如需)

# 卸载保留配置
apt remove redis-server
# 彻底卸载删除配置
apt purge redis-server
apt autoremove

常见问题

  1. 远程连不上:检查 bind、protected-mode、防火墙、云服务器安全组(阿里云 / 腾讯云额外放行 6379)

  2. redis-cli 报错 NOAUTH:配置了密码后必须执行 AUTH 密码才能操作

  3. systemctl 启动失败:检查 redis.conf 语法是否有误,redis-server /etc/redis/redis.conf 前台运行看报错