安装并加固 Redis
在 Debian 或 Ubuntu 上从官方软件源安装 Redis:ACL 用户、仅本地监听、RDB 与 AOF 持久化、内存限制、备份与恢复。
本页内容
您的参数
只需填写一次,指南中的命令会自动更新。
本指南将说明如何从官方软件源在您的 VPS 或独立服务器上安装 Redis,使用 ACL 用户保护它,选择合适的持久化方式,限制其内存并备份其数据。
Redis 设计为供受信任的客户端使用。因此在这里它仅允许本地访问,每个应用程序都使用一个权限受限的账户连接它。
订购服务器
Redis 将数据保存在内存中:请为您的数据以及后台备份预留足够的内存。HostMyServers 提供多种方案:
先决条件
- 运行 Debian 12 或 13,或 Ubuntu 22.04 或 24.04 的服务器
- 拥有
sudo权限用户的 SSH 访问 - 系统已更新(
sudo apt update && sudo apt upgrade)
需要开放的端口
无需开放。 Redis 监听 127.0.0.1 和 ::1 的 6379 端口。要从您的电脑访问它,请使用后文介绍的 SSH 隧道,它通过您已开放的 SSH 端口进行连接。
从官方软件源安装 Redis
截至撰写本文时,官方软件源为 Debian 12 和 13 以及 Ubuntu 22.04 和 24.04 提供 Redis 8.10。
sudo apt install -y lsb-release curl gpg
curl -fsSL https://packages.redis.io/gpg | sudo gpg --dearmor -o /usr/share/keyrings/redis-archive-keyring.gpg
sudo chmod 644 /usr/share/keyrings/redis-archive-keyring.gpg
echo "deb [signed-by=/usr/share/keyrings/redis-archive-keyring.gpg] https://packages.redis.io/deb $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/redis.list
sudo apt update
sudo apt install -y redis
sudo systemctl enable --now redis-server验证安装
redis-server --version
sudo systemctl status redis-server --no-pager
redis-cli ping
sudo ss -tlnp | grep 6379redis-cli ping 必须返回 PONG。ss 必须仅显示在 127.0.0.1:6379 和 [::1]:6379 上监听。
| 项目 | 位置 |
|---|---|
| 软件包自带的配置 | /etc/redis/redis.conf |
| 您的设置(后面创建) | /etc/redis/local.conf |
| 用户(后面创建) | /etc/redis/users.acl |
| 数据 | /var/lib/redis/ |
| 日志 | /var/log/redis/redis-server.log |
创建 ACL 用户
默认情况下,任何本地连接都可以执行所有命令。您将停用 default 用户,并创建三个账户:
| 用户 | 权限 |
|---|---|
admin |
完全管理权限 |
app |
对 app:* 键拥有读写权限,不能执行危险命令 |
backup |
仅能触发备份,无权访问键 |
-
生成密码和用户文件。其中仅记录密码的 SHA-256 哈希值:
终端ADMIN_PASS="$(openssl rand -hex 32)" APP_PASS="$(openssl rand -hex 32)" BACKUP_PASS="$(openssl rand -hex 32)" sha() { printf '%s' "$1" | sha256sum | cut -d' ' -f1; } sudo install -o redis -g redis -m 640 /dev/null /etc/redis/users.acl sudo tee /etc/redis/users.acl > /dev/null <<EOF user default off user admin on #$(sha "$ADMIN_PASS") ~* &* +@all user app on #$(sha "$APP_PASS") ~app:* resetchannels &app:* -@all +@read +@write +@connection +@transaction -@dangerous user backup on #$(sha "$BACKUP_PASS") resetchannels -@all +ping +bgsave +lastsave EOF -
保留备份密码供脚本使用,然后显示另外两个密码,以便将它们存入您的密码管理器:
终端printf '%s' "$BACKUP_PASS" | sudo sh -c 'umask 077; cat > /root/.redis-backup-pass' printf 'admin: %s\napp: %s\n' "$ADMIN_PASS" "$APP_PASS" unset ADMIN_PASS APP_PASS BACKUP_PASS -
创建您的设置文件。它与
redis.conf保持分离,这样更便于升级:终端sudo install -o redis -g redis -m 640 /dev/null /etc/redis/local.conf sudo nano /etc/redis/local.conf配置aclfile /etc/redis/users.acl maxmemory 512mb maxmemory-policy noeviction请根据您的服务器调整
maxmemory,具体说明见内存一节。 -
在配置末尾加载该文件,然后重启:
终端echo 'include /etc/redis/local.conf' | sudo tee -a /etc/redis/redis.conf sudo systemctl restart redis-server -
检查结果:
终端redis-cli ping redis-cli --user admin --askpass ping redis-cli --user app --askpass第一条命令必须返回
NOAUTH Authentication required.,第二条命令在输入admin密码后必须返回PONG。在第三条命令打开的会话中,使用app密码:文本SET app:test ok GET app:test DEL app:test SET autre:test non FLUSHALL前三条命令必须成功。后两条命令必须被拒绝,并返回
NOPERM错误。
在您的应用程序中,请指定用户 app 及其密码,并为键加上 app: 前缀。如果它需要其他命令,请调整 users.acl 中对应的行,然后在 admin 会话中使用 ACL LOAD 重新加载该文件。
从您的电脑访问 Redis
打开一条 SSH 隧道,并保持该命令运行:
ssh -N -L 6380:127.0.0.1:6379 您的用户名@您的服务器IP在另一个终端中,通过本地端口 6380 连接:
redis-cli -p 6380 --user admin --askpass如果某个远程应用程序确实无法使用隧道或专用网络,请在保留 ACL 的前提下配置 TLS,并在防火墙中将该端口限制为只允许此客户端的地址访问。
选择持久化方式
| 模式 | 工作方式 | 丢失风险 | 建议用途 |
|---|---|---|---|
| RDB | 定期在 dump.rdb 中生成快照 |
自上次快照以来的数据 | 可以部分重建的数据 |
| AOF | 写操作日志,默认每秒同步一次 | 约一秒 | 重要数据 |
| RDB + AOF | 两者同时使用 | 约一秒 | 需要长期保存的数据的最佳选择 |
| 无 | 重启后全部丢失 | 全部 | 纯缓存 |
RDB 默认启用,阈值为 3600 1 300 100 60 10000:如果至少有 1 个键发生变化,则在 1 小时后生成快照;100 个键变化则在 5 分钟后;10 000 个键变化则在 1 分钟后。
在不丢失数据的情况下启用 AOF
-
打开一个
admin会话:终端redis-cli --user admin --askpass -
启用 AOF 并跟踪其创建过程:
文本CONFIG SET appendonly yes INFO persistence请重复执行
INFO persistence,直到得到aof_rewrite_in_progress:0、aof_rewrite_scheduled:0和aof_last_bgrewrite_status:ok。 -
将下面这一行添加到
/etc/redis/local.conf,以保留该设置:配置appendonly yes -
重启 Redis,然后使用
DBSIZE检查键的数量没有变化:终端sudo systemctl restart redis-server
将 Redis 用作纯缓存
如果所有数据都可以重新构建,请将这些行添加到 /etc/redis/local.conf 并重启:
save ""
appendonly no
maxmemory-policy allkeys-lru控制内存
在 64 位系统上,Redis 默认没有内存限制。请务必设置 maxmemory,并为系统、您的其他服务以及 Redis 的缓冲区留出空间。在写入压力很大的实例上进行备份时,Redis 可能占用多达其通常内存的两倍。
| 策略 | 达到上限时的行为 | 用途 |
|---|---|---|
noeviction |
拒绝新的写入 | 不能丢失的数据 |
allkeys-lru |
删除最近最少使用的键 | 通用缓存 |
allkeys-lfu |
删除使用频率最低的键 | 存在大量热点键的缓存 |
volatile-lru |
在设置了过期时间的键中删除 | 缓存与数据混用 |
volatile-ttl |
删除过期时间最近的键 | 过期时间管理得当的场景 |
请启用 Redis 推荐的内核设置,以提高后台备份的可靠性:
echo 'vm.overcommit_memory = 1' | sudo tee /etc/sysctl.d/90-redis.conf
sudo sysctl --system要在 admin 会话中监控使用情况:
INFO memory
INFO stats
MEMORY DOCTOR请特别关注 used_memory_human、maxmemory_human、mem_fragmentation_ratio 和 evicted_keys。
自动执行备份
RDB 文件可以在 Redis 运行时复制:只有在新快照完整生成后,它才会被替换。该脚本会请求一个最新的快照,等待其完成,然后复制它。
-
创建脚本:
终端sudo nano /usr/local/sbin/redis-backup.sh终端#!/bin/bash set -euo pipefail umask 077 DEST="/var/backups/redis" RETENTION_DAYS=7 export REDISCLI_AUTH="$(cat /root/.redis-backup-pass)" cli() { redis-cli --user backup "$@"; } mkdir -p "$DEST" before="$(cli LASTSAVE)" cli BGSAVE SCHEDULE > /dev/null now="$before" for _ in $(seq 1 1800); do sleep 1 now="$(cli LASTSAVE)" [ "$now" -gt "$before" ] && break done if [ "$now" -le "$before" ]; then echo "BGSAVE did not finish in time" >&2 exit 1 fi cp /var/lib/redis/dump.rdb "$DEST/dump-$(date +%F_%H%M%S).rdb" find "$DEST" -name 'dump-*.rdb' -mtime +"$RETENTION_DAYS" -delete -
创建服务:
终端sudo chmod 700 /usr/local/sbin/redis-backup.sh sudo nano /etc/systemd/system/redis-backup.service配置[Unit] Description=Redis backup After=redis-server.service [Service] Type=oneshot ExecStart=/usr/local/sbin/redis-backup.sh -
创建定时器:
终端sudo nano /etc/systemd/system/redis-backup.timer配置[Unit] Description=Daily Redis backup [Timer] OnCalendar=*-*-* 02:45:00 RandomizedDelaySec=10min Persistent=true [Install] WantedBy=timers.target -
启用定时器并运行第一次备份:
终端sudo systemctl daemon-reload sudo systemctl enable --now redis-backup.timer sudo systemctl start redis-backup.service sudo ls -lh /var/backups/redis
测试恢复
此测试会将最新的备份加载到一个临时实例中,该实例只能通过本地套接字访问。您的生产实例不会被修改。
LATEST="$(sudo sh -c 'ls -1t /var/backups/redis/dump-*.rdb | head -n 1')"
sudo install -d -o redis -g redis -m 750 /var/lib/redis-restore-test
sudo install -o redis -g redis -m 640 "$LATEST" /var/lib/redis-restore-test/dump.rdb
sudo -u redis redis-server --port 0 --unixsocket /var/lib/redis-restore-test/redis.sock --unixsocketperm 700 --dir /var/lib/redis-restore-test --dbfilename dump.rdb --appendonly no --save "" --daemonize yes --logfile /var/lib/redis-restore-test/redis.log
sleep 2
sudo -u redis redis-cli -s /var/lib/redis-restore-test/redis.sock DBSIZE请将这个数字与生产实例的数字进行比较,并使用 GET 读取几个重要的键。然后停止测试实例并删除其文件:
sudo -u redis redis-cli -s /var/lib/redis-restore-test/redis.sock SHUTDOWN NOSAVE
sudo rm -rf /var/lib/redis-restore-test如果您的数据使用了 JSON、Search、TimeSeries 或 Bloom 模块,请在启动命令中加入相应的 --loadmodule 选项,路径以 /etc/redis/redis.conf 中指明的为准。
故障后的恢复
启用 AOF 后,Redis 会从 AOF 加载数据并忽略 dump.rdb。因此,该流程会在恢复期间暂时停用 AOF。
-
停止应用程序和 Redis,然后将当前文件移到一旁:
终端sudo systemctl stop redis-server sudo mkdir -p /var/backups/redis/before-restore sudo sh -c 'mv /var/lib/redis/dump.rdb /var/lib/redis/appendonlydir /var/backups/redis/before-restore/ 2>/dev/null || true' -
复制选定的备份,并相应调整其名称:
终端sudo install -o redis -g redis -m 660 /var/backups/redis/dump-2026-11-18_024500.rdb /var/lib/redis/dump.rdb -
如果您使用 AOF,请在
/etc/redis/local.conf中将appendonly yes改为appendonly no,然后启动 Redis:终端sudo systemctl start redis-server -
在
admin会话中使用DBSIZE检查您的数据。如果您使用 AOF,请通过CONFIG SET appendonly yes在运行中重新启用它,按照持久化一节的说明等待其创建完成,然后在local.conf中重新写入appendonly yes。
更新 Redis
请先备份您的数据,然后更新软件包:
sudo systemctl start redis-backup.service
sudo apt update
sudo apt install --only-upgrade redis redis-server redis-tools
redis-server --version
sudo systemctl status redis-server --no-pager如果 apt 提示 /etc/redis/redis.conf 已更改,请在决定之前先比较两个版本。如果您采用新版本,请在文件末尾重新添加 include /etc/redis/local.conf 这一行。在升级主版本之前,也请阅读发行说明。
故障排除
NOAUTH Authentication required.
客户端没有进行身份验证,由于 default 已被停用,这是预期的行为。请使用 --user 和 --askpass 指定用户,或在您的应用程序中配置这些值。
WRONGPASS invalid username-password pair or user is disabled.
用户名或密码有误。如果您丢失了某个密码,请重新生成一个,替换 /etc/redis/users.acl 中对应的哈希值,然后重启 Redis 或执行 ACL LOAD。
NOPERM
该用户无权使用此命令或此键。在 admin 会话中,ACL LOG 会显示被拒绝的内容。请只放宽必要的权限。
OOM command not allowed when used memory > 'maxmemory'
已达到内存上限,而当前策略不会释放键。如果服务器允许,请提高 maxmemory,删除无用的数据,或者在 Redis 用作缓存时选择 allkeys-lru。
MISCONF Redis is configured to save RDB snapshots
最近一次快照失败了,Redis 因此拒绝写入以提醒您。请检查磁盘空间、权限和日志:
df -h /var/lib/redis
sudo ls -ld /var/lib/redis
sudo tail -n 50 /var/log/redis/redis-server.log我们的指南检查磁盘空间可以帮助您释放空间。
WARNING Memory overcommit must be enabled!
请应用内存一节中介绍的 vm.overcommit_memory = 1 设置。
Redis 无法再启动
users.acl 或 local.conf 中的错误会导致无法启动。请查看日志:
sudo journalctl -u redis-server -n 50 --no-pager
sudo tail -n 50 /var/log/redis/redis-server.log还请检查 users.acl 是否存在,以及 redis 用户是否可以读取它。使用 aclfile 时,请不要在 redis.conf 中定义用户:Redis 拒绝混用这两种方式。
Could not connect to Redis at 127.0.0.1:6379: Connection refused
Redis 已停止,或在其他地址上监听。请检查 sudo systemctl status redis-server 和 sudo ss -tlnp | grep redis。