2304 字
12 分钟
Redis 安装与初始配置
2026-11-15

为什么 Redis 的初始配置格外重要#

从这一篇开始进入 Redis 部分。在 数据库怎么选 里我们说过,Redis 是内存型键值数据库,定位是缓存、计数器、排行榜、分布式锁这类高速场景,不是拿来替代关系型数据库的主存储。

但 Redis 有个特点:默认配置是为「开箱即用」设计的,不是为「安全上线」设计的。历史上大量 Redis 被入侵事件,根源都是同一个:无密码、监听所有网卡、直接暴露公网。所以这一篇的主线是:装好只是第一步,把 bind、密码、内存上限这三件事配置对,才算真正能用。

路线一:Docker Compose 部署(推荐)#

目录与 Compose 文件(单机练习与小规模生产都适用):

Terminal window
mkdir -p ~/redis7/{data,conf} && cd ~/redis7
docker-compose.yml
services:
redis:
image: redis:7.4
container_name: redis7
restart: unless-stopped
ports:
- "127.0.0.1:6379:6379"
volumes:
- ./data:/data
- ./conf/redis.conf:/usr/local/etc/redis/redis.conf:ro
command: redis-server /usr/local/etc/redis/redis.conf

配置文件 conf/redis.conf 先写一份最小但正确的版本:

bind 0.0.0.0
port 6379
protected-mode yes
requirepass ChangeMe_Redis_2026!
daemonize no
dir /data
dbfilename dump.rdb
appendonly yes
appendfilename "appendonly.aof"
maxmemory 1gb
maxmemory-policy allkeys-lru
timeout 300
tcp-keepalive 300

启动与验证:

Terminal window
docker compose up -d
docker compose logs redis
# 带密码连接测试
docker exec -it redis7 redis-cli -a 'ChangeMe_Redis_2026!' PING
# 期望返回 PONG
docker exec -it redis7 redis-cli -a 'ChangeMe_Redis_2026!' INFO server | grep redis_version

注意容器里 bind 0.0.0.0 是对的:Docker 的网络隔离由宿主机端口映射负责,宿主机侧只绑 127.0.0.1 就不会暴露到公网。持久化细节(RDB 与 AOF 为什么这里两个都开)留到 Redis 持久化:RDB 与 AOF 怎么选 专门讲,本篇先让它跑起来。

路线二:系统包安装(Debian / Ubuntu)#

Redis 官方提供 APT 仓库,版本跟得比发行版自带源新:

Terminal window
# 添加官方仓库后
sudo apt update
sudo apt install -y redis
sudo systemctl enable --now redis-server
sudo systemctl status redis-server

系统包的配置文件在 /etc/redis/redis.conf,改完 sudo systemctl restart redis-server 生效。两种路线对比:

维度Docker Compose系统包安装
版本镜像 tag 锁定 7.4,升级换 tag跟官方 APT 仓库走
配置位置项目内 conf/redis.conf/etc/redis/redis.conf
数据目录宿主机 ./data/var/lib/redis
多实例改端口与目录即可并行多个需要多份配置与 systemd 单元,较繁琐
适合场景个人服务器、快速试错、多实例单实例长期运行、习惯系统服务管理

三合一的快速部署版本在 用 Docker 快速搭建三大数据库 里有,这里是把 Redis 单独拎出来细化配置。

初始配置的四个关键参数#

1. bind 与 protected-mode:决定谁能连上你#

bind 127.0.0.1 -::1 表示只监听本机回环,这是系统包安装的安全默认值。最危险的组合是 bind 0.0.0.0 + 无密码 + protected-mode no,等于把数据库大门敞开给整个互联网,自动化扫描几分钟内就能找上门。

需要远程连接时,正确顺序是:先设密码、再改 bind 到内网网卡地址、防火墙只放行应用服务器 IP。顺序反了,中间窗口期就可能被扫到。

2. requirepass:密码必须设,且要够强#

requirepass ChangeMe_Redis_2026!

Redis 的密码验证速度极快(每秒可尝试上百万次),短密码形同虚设,密码长度至少 16 位、随机生成,和其它服务的密码不要复用。Redis 6.0 起还支持 ACL 多用户权限,可以给不同应用发不同账号并限制可执行的命令与可访问的键前缀:

Terminal window
# 在 redis.conf 中追加,或运行时用 ACL SETUSER
# 创建只读账号,只能读 cache: 前缀的键
ACL SETUSER reader on '>ReadOnly_2026!' ~cache:* +get +mget +exists

验证 ACL 账号:

Terminal window
redis-cli --user reader --pass 'ReadOnly_2026!' GET cache:home

3. maxmemory:不设上限迟早被系统杀掉#

Redis 把全部数据放在内存里。如果不设 maxmemory,缓存只进不出,内存涨满后要么 Redis 自己 OOM,要么被 Linux 的 OOM Killer 连带干掉。给缓存型实例设上限是必修课:

maxmemory 1gb
maxmemory-policy allkeys-lru

上限的取值:专机可给物理内存的 60%–75%,混跑机器按规划预留。注意主存储型用法(当队列、锁服务)不要用会淘汰数据的策略,见下节。

4. maxmemory-policy:内存满了淘汰谁#

策略行为适合场景
noeviction不淘汰,写入直接报错队列、锁、不可丢数据
allkeys-lru所有键里淘汰最久未用的通用缓存,最常用
allkeys-lfu所有键里淘汰最不常用的热点明显的缓存
volatile-lru只在带过期时间的键里淘汰 LRU混存场景:持久键 + 缓存键
allkeys-random随机淘汰数据访问均匀、无冷热之分
volatile-ttl优先淘汰快过期的键缓存键过期时间有意义时

纯缓存场景默认选 allkeys-lru,拿不准就用它;存了不能丢的数据就必须 noeviction 并靠监控告警守内存。

WARNING

两个老生常谈但仍在不断出事的点:一是绝对不要用 root 身份直接把 6379 暴露公网且不设密码,被入侵后攻击者常用 CONFIG SET dir + 写文件的方式落 SSH 密钥;二是生产环境建议禁用或改名高危命令(如 FLUSHALL、CONFIG、KEYS),可以在 redis.conf 里用 rename-command FLUSHALL "" 禁用,防应用层误操作与注入。

连接、体检与常用管理命令#

Terminal window
# 交互连接(密码不写在命令里更安全,用 -a 会留在进程列表与历史中,练习环境可接受)
redis-cli -h 127.0.0.1 -p 6379 -a 'ChangeMe_Redis_2026!'
# 体检三件套
INFO memory # 内存使用:used_memory_human、maxmemory_human、碎片率
INFO stats # 命中率相关:keyspace_hits / keyspace_misses
DBSIZE # 当前库键数量
SLOWLOG GET 5 # 最近 5 条慢命令(默认阈值 10ms)

缓存命中率 = hits / (hits + misses),长期低于 80% 说明缓存策略或容量有问题。数据类型与具体用法在下一篇 Redis 五大数据类型与实战用法 展开,这里先会看状态。

运行时改配置(重启失效,重要变更务必同步写回 redis.conf):

Terminal window
CONFIG GET maxmemory*
CONFIG SET maxmemory 2gb
CONFIG REWRITE # 把当前运行时配置写回配置文件(系统包安装时常用)

上线前自查与压力自测#

配置改完别急着交付,跑一遍自查清单:

Terminal window
# 1. 确认监听范围与密码都已生效
redis-cli -a 'ChangeMe_Redis_2026!' CONFIG GET bind
redis-cli -a 'ChangeMe_Redis_2026!' CONFIG GET requirepass
redis-cli -a 'ChangeMe_Redis_2026!' CONFIG GET maxmemory*
# 2. 确认无密码连接被拒绝(下面这条应该报错 NOAUTH)
redis-cli PING
# 3. 确认持久化状态正常
redis-cli -a 'ChangeMe_Redis_2026!' INFO persistence | grep -E 'rdb_last_bgsave_status|aof_enabled'

再用官方自带的 redis-benchmark 做一次本机基准自测,心里有数量级概念即可,不要拿它的数字当生产承诺:

Terminal window
# 本机回环、带密码、测 SET/GET 的大致吞吐
redis-benchmark -h 127.0.0.1 -p 6379 -a 'ChangeMe_Redis_2026!' -t set,get -n 100000 -q

单机 Redis 的 SET/GET 通常在每秒数万到十万级,如果测出来只有几千,先查是不是跨网络测试、管道(pipeline)没开、或机器 CPU 被限频。真实业务压测要用贴近业务的键大小与命令组合,redis-benchmark 只适合安装验收阶段的冒烟测试。

日志方面,Docker 部署时 Redis 日志直接打到标准输出,docker compose logs 就能看;系统包安装则看 /var/log/redis/redis-server.log。重点关注启动时的警告信息,比如内存超分配(overcommit)与透明大页(THP)的提示,这两条是官方明确建议在宿主机层面处理的:

Terminal window
# 宿主机上执行(持久化写入 /etc/sysctl.conf 与开机脚本)
sudo sysctl vm.overcommit_memory=1
echo never | sudo tee /sys/kernel/mm/transparent_hugepage/enabled

常见问题#

Q:容器启动就退出,日志报 Can't open the append-only file? 多为 data 目录权限问题。官方镜像内以 redis 用户运行,确保宿主机挂载目录可写:sudo chown -R 999:999 ./data(999 是镜像内 redis 用户的常用 UID),再重启容器。

Q:连接报 NOAUTH Authentication required? 服务端设了密码而客户端没带。redis-cli 用 -a 密码 或连接后执行 AUTH 密码;用了 ACL 账号则要 AUTH 用户名 密码。

Q:明明设了 maxmemory,内存还是超过上限? maxmemory 限制的是数据内存,进程实际占用还包含客户端缓冲区、复制积压、内存碎片等开销。看 INFO memory 里的 mem_fragmentation_ratio,碎片率长期高于 1.5 可开启 activedefrag yes 主动碎片整理。

Q:改了 redis.conf 重启没生效? Docker 方式先确认 Compose 里 command 指向的是挂载进去的那份配置,且文件是只读挂载后容器重建过(docker compose up -d --force-recreate)。另外注意 CONFIG SET 的运行时修改会在重启后被配置文件覆盖,别把两者搞混。

小结#

  • Redis 上线三件套:bind 只听该听的网卡、requirepass 设 16 位以上强密码、maxmemory 必须设上限。
  • 纯缓存用 allkeys-lru 淘汰;存不可丢数据用 noeviction 并做好内存监控。
  • ACL 可以按应用发账号、限命令、限键前缀,比全员共用一个密码规范得多。
  • 高危命令该禁用的禁用,6379 永远不要无密码裸奔公网。

装好配好,下一篇开始真正用它:Redis 五大数据类型与实战用法。

Redis 安装与初始配置
https://www.anexns.cloudns.org/posts/redis-install-config/
作者
Anexns
发布于
2026-11-15
许可协议
CC BY-NC-SA 4.0