中文

Linux 与网络

安装并加固 Redis

在 Debian 或 Ubuntu 上从官方软件源安装 Redis:ACL 用户、仅本地监听、RDB 与 AOF 持久化、内存限制、备份与恢复。

阅读约 9 分钟, 更新于 2026年11月18日

本页内容

您的参数

只需填写一次,指南中的命令会自动更新。

本指南将说明如何从官方软件源在您的 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 6379

redis-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 仅能触发备份,无权访问键
  1. 生成密码和用户文件。其中仅记录密码的 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
  2. 保留备份密码供脚本使用,然后显示另外两个密码,以便将它们存入您的密码管理器:

    终端
    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
  3. 创建您的设置文件。它与 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,具体说明见内存一节。

  4. 在配置末尾加载该文件,然后重启:

    终端
    echo 'include /etc/redis/local.conf' | sudo tee -a /etc/redis/redis.conf
    sudo systemctl restart redis-server
  5. 检查结果:

    终端
    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

  1. 打开一个 admin 会话:

    终端
    redis-cli --user admin --askpass
  2. 启用 AOF 并跟踪其创建过程:

    文本
    CONFIG SET appendonly yes
    INFO persistence

    请重复执行 INFO persistence,直到得到 aof_rewrite_in_progress:0、aof_rewrite_scheduled:0 和 aof_last_bgrewrite_status:ok。

  3. 将下面这一行添加到 /etc/redis/local.conf,以保留该设置:

    配置
    appendonly yes
  4. 重启 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 运行时复制:只有在新快照完整生成后,它才会被替换。该脚本会请求一个最新的快照,等待其完成,然后复制它。

  1. 创建脚本:

    终端
    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
  2. 创建服务:

    终端
    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
  3. 创建定时器:

    终端
    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
  4. 启用定时器并运行第一次备份:

    终端
    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。

  1. 停止应用程序和 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'
  2. 复制选定的备份,并相应调整其名称:

    终端
    sudo install -o redis -g redis -m 660 /var/backups/redis/dump-2026-11-18_024500.rdb /var/lib/redis/dump.rdb
  3. 如果您使用 AOF,请在 /etc/redis/local.conf 中将 appendonly yes 改为 appendonly no,然后启动 Redis:

    终端
    sudo systemctl start redis-server
  4. 在 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。

参考资料