Redis ACL如何为数据库服务器上的应用配置最小权限?怎样验证用户可执行的命令

发布人:A5数据发布时间:2026-10-27 14:52阅读量:123

Redis ACL 的最小权限不能只依赖一个登录密码,而应同时限制应用身份、可执行命令、可访问的键名范围,以及需要使用时的发布订阅频道。这样即使应用凭据泄露,攻击者也不能直接执行配置修改、数据清空、脚本或运维类命令。

验证权限时,至少要分别测试“允许的命令”“禁止的命令”和“允许命令访问不允许的键”。Redis 7 及以上可以使用 ACL DRYRUN 在不真正执行命令的情况下验证权限;Redis 6 则需要使用带命名空间的测试键进行实际验证。

实施目标与适用环境

以下步骤以 Ubuntu 或 Debian 服务器上的 Redis 6.0 及以上版本为例,服务名使用发行版常见的 redis-server。示例场景如下:

  • Redis 与应用部署在同一台服务器,或通过内网地址访问。
  • 应用只使用逻辑数据库 0。
  • 应用键统一使用 app: 前缀,例如 app:session:1001。
  • 应用需要执行 PING、GET、SET、DEL、EXISTS、EXPIRE 和 TTL。
  • 不允许应用执行 CONFIG、FLUSHDB、FLUSHALL、ACL、EVAL 等管理或高风险命令。
  • 运维人员使用独立的 opsadmin 账号,不与应用共用凭据。

如果应用实际使用哈希、列表、事务、Lua 脚本或发布订阅,应在完成命令盘点后按需增加权限,不应直接授予 +@all、+@read 或 +@write。

Redis ACL 本身不能替代网络访问控制。远程应用访问 Redis 时,还应通过 bind、服务器防火墙和内网路由限制来源;ACL 也不会自动加密传输内容,跨主机传输凭据时应结合 TLS 或受保护的内网链路。

Redis ACL负责命令与键空间授权,而数据库服务的运行基础还包括适配业务负载的硬件与网络资源。A5idc数据提供香港、美国、日本等地区的物理服务器,配置涵盖不同档位的CPU、内存和SSD或NVMe存储,并有多种线路方案,可承载数据库及应用后台等业务部署。结合Redis所在地区与业务规模,这些资源为数据库服务和应用接入提供相应的服务器基础。

准备条件与风险边界

确认 Redis 版本和服务状态

先确认 Redis 是否已安装,以及版本是否支持 ACL:

redis-server --version
redis-cli --version
systemctl is-active redis-server

预期结果类似:

Redis server v=7.0.x sha=...
active

Redis 5 及更早版本不支持本文使用的 ACL 用户模型。如果服务器尚未安装 Redis,可以使用系统软件包安装:

sudo apt update
sudo apt install -y redis-server
sudo systemctl enable --now redis-server

安装后再次检查版本。如果系统软件仓库提供的版本低于 6.0,应先规划 Redis 升级,不要直接套用 ACL 命令。

确认当前服务可以正常响应:

redis-cli -h 127.0.0.1 -p 6379 PING

在尚未关闭默认用户时,预期结果通常为:

PONG

如果当前 Redis 已有业务数据,不要执行 FLUSHDB、FLUSHALL 或随意修改数据键。ACL 配置主要影响认证和命令授权,但重启 Redis 会断开现有客户端连接,应安排在维护窗口内执行。

检查监听地址和 ACL 文件位置

查看当前关键配置:

sudo grep -E '^(bind|protected-mode|port|tls-port|aclfile)' /etc/redis/redis.conf

同时检查服务实际使用的用户和配置文件:

systemctl cat redis-server
systemctl show -p User,Group redis-server

如果应用与 Redis 在同一台服务器,优先使用:

bind 127.0.0.1
protected-mode yes
port 6379

如果应用位于另一台服务器,bind 可以包含 Redis 的内网地址,例如:

bind 127.0.0.1 10.20.1.15
protected-mode yes
port 6379

此时还必须将防火墙来源限制为应用服务器或应用网段,不能因为配置了 ACL 就把 Redis 暴露到公网。不要在没有明确访问控制的情况下使用 bind 0.0.0.0。

备份配置文件和现有 ACL 文件。以下命令只备份配置,不会修改 Redis 数据:

TS=$(date +%Y%m%d-%H%M%S)

sudo cp -a /etc/redis/redis.conf \
  "/etc/redis/redis.conf.${TS}.bak"

if [ -e /etc/redis/users.acl ]; then
  sudo cp -a /etc/redis/users.acl \
    "/etc/redis/users.acl.${TS}.bak"
fi

如果 /etc/redis/users.acl 已经存在且非空,不要使用下面的首次部署模板直接覆盖。应改用后文的 ACL SETUSER 方式逐项调整,并在变更前保存现有 ACL。

配置 ACL 持久化文件

Redis 运行时执行的 ACL SETUSER 会立即生效,但如果没有配置 ACL 文件,重启后可能丢失。首次部署可以将 ACL 规则写入独立文件,并通过 aclfile 让 Redis 在启动时加载。

编辑 Redis 配置:

sudoedit /etc/redis/redis.conf

确认配置中存在以下内容。如果已有同名配置项,应修改现有项,不要重复添加:

aclfile /etc/redis/users.acl

创建 ACL 文件时,需要让 Redis 服务账号可以读取。Ubuntu 和 Debian 软件包通常使用 redis 用户,但应以 systemctl show -p User,Group redis-server 的结果为准:

if [ ! -e /etc/redis/users.acl ]; then
  sudo install -o redis -g redis -m 640 /dev/null /etc/redis/users.acl
fi

如果服务账号不是 redis,将命令中的属主和属组替换为实际值。若文件已经存在,先执行:

sudo test ! -s /etc/redis/users.acl && echo "ACL file is empty"

只有确认是首次创建或空文件时,才继续写入首次部署规则。

创建运维用户和应用用户

准备凭据

不要把真实密码直接写入 Shell 命令历史、应用配置仓库或文章脚本。下面使用交互式输入,实际环境也可以从密码管理系统临时注入。

建议运维密码和应用密码分别生成,长度不少于 24 个字符,并且不要复用系统登录密码:

read -rsp "Redis opsadmin password: " OPS_PASSWORD
printf '\n'

read -rsp "Redis app password: " APP_PASSWORD
printf '\n'

Redis ACL 支持保存密码的 SHA-256 哈希。生成哈希时,密码不会出现在命令参数中:

OPS_HASH=$(printf '%s' "$OPS_PASSWORD" | sha256sum | awk '{print $1}')
APP_HASH=$(printf '%s' "$APP_PASSWORD" | sha256sum | awk '{print $1}')

写入最小权限规则

下面的规则包含三个用户配置:

  • default off:关闭默认用户,阻止未认证连接。
  • opsadmin:仅供运维使用,拥有完整管理权限,凭据不能交给应用。
  • app:只允许访问 app:* 键,并只允许指定命令。
{
  printf '%s\n' 'user default off'
  printf 'user opsadmin on #%s resetkeys ~* resetchannels &* +@all\n' "$OPS_HASH"
  printf 'user app on #%s resetkeys ~app:* resetchannels -@all +ping +get +set +del +exists +expire +ttl\n' "$APP_HASH"
} | sudo tee /etc/redis/users.acl >/dev/null

sudo chown redis:redis /etc/redis/users.acl
sudo chmod 640 /etc/redis/users.acl

其中:

创建运维用户和应用用户/写入最小权限规则配图

  • ~app:* 是键名匹配规则,应用可以访问 app: 开头的键。
  • -@all 先清除全部命令权限,再通过 +ping、+get 等逐个加入所需命令。
  • resetchannels 表示默认不允许访问发布订阅频道。
  • opsadmin 的 ~<em> 和 &</em> 分别表示允许访问所有键和频道,但该账号只应由受控运维操作使用。
  • SET 的命令级权限不会限制其选项参数,例如过期时间选项仍由客户端自行控制;ACL 主要限制命令名称和键名范围。

如果应用使用哈希结构,还需要根据实际代码增加权限,例如:

+hget +hset +hdel +hexists

如果应用使用计数器,可以增加:

+incr +decr +incrby +decrby

如果应用使用发布订阅,除了命令权限,还要限定频道:

+publish +subscribe &app-events:*

不要因为客户端可能使用某个命令,就直接开放整个命令类别。应优先根据连接日志、应用代码或测试环境中的命令清单逐个增加。

重启并验证配置加载

ACL 文件写入后,重启会断开现有连接,应用需要重新建立连接:

sudo systemctl restart redis-server

立即检查服务状态:

systemctl is-active redis-server
sudo systemctl status redis-server --no-pager

预期结果为:

active

如果服务没有启动,不要连续重复重启,先查看日志:

sudo journalctl -u redis-server -n 80 --no-pager

常见原因包括 ACL 文件格式错误、文件属主不正确、aclfile 路径错误或配置文件存在重复冲突项。

每步验证用户和命令权限

验证运维用户

在当前 Shell 中使用环境变量传递密码,避免将密码放进 redis-cli 参数:

REDISCLI_AUTH="$OPS_PASSWORD" \
redis-cli --user opsadmin -h 127.0.0.1 -p 6379 PING

预期结果:

PONG

确认 Redis 已加载 ACL 文件:

REDISCLI_AUTH="$OPS_PASSWORD" \
redis-cli --user opsadmin -h 127.0.0.1 -p 6379 CONFIG GET aclfile

预期结果应包含:

1) "aclfile"
2) "/etc/redis/users.acl"

查看应用用户规则:

REDISCLI_AUTH="$OPS_PASSWORD" \
redis-cli --user opsadmin -h 127.0.0.1 -p 6379 ACL GETUSER app

输出中的密码哈希属于敏感信息,不应直接复制到公开日志。重点检查以下项目:

  • 用户状态为 on。
  • 命令列表只包含计划中的命令。
  • 键模式包含 ~app:*。
  • 频道权限为空,除非应用确实使用发布订阅。
  • 没有意外出现 +@all、+@write 或其他宽泛类别。

验证应用身份和允许的命令

使用专门的测试键,不要使用生产中的会话、订单或缓存键:

CHECK_KEY="app:acl-check:$(date +%s)"

REDISCLI_AUTH="$APP_PASSWORD" \
redis-cli --user app -h 127.0.0.1 -p 6379 \
SET "$CHECK_KEY" "ok" EX 60

预期结果:

OK

继续验证读取、存在性、过期时间和删除权限:

REDISCLI_AUTH="$APP_PASSWORD" \
redis-cli --user app -h 127.0.0.1 -p 6379 GET "$CHECK_KEY"

REDISCLI_AUTH="$APP_PASSWORD" \
redis-cli --user app -h 127.0.0.1 -p 6379 EXISTS "$CHECK_KEY"

REDISCLI_AUTH="$APP_PASSWORD" \
redis-cli --user app -h 127.0.0.1 -p 6379 TTL "$CHECK_KEY"

预期结果分别类似:

ok
1
59

TTL 的具体数值会随执行时间变化,只要返回非负秒数即可。

测试完成后只删除本次创建的测试键:

REDISCLI_AUTH="$APP_PASSWORD" \
redis-cli --user app -h 127.0.0.1 -p 6379 DEL "$CHECK_KEY"

预期结果为:

1

验证禁止访问的键

应用用户即使拥有 GET 命令,也不应读取其他命名空间:

REDISCLI_AUTH="$APP_PASSWORD" \
redis-cli --user app -h 127.0.0.1 -p 6379 GET "other:acl-check"

预期结果应为类似错误:

(error) NOPERM this user has no permissions to access one of the keys used as arguments

这一步用于证明 ACL 同时检查命令权限和键名权限。仅测试 GET app:test 只能证明命令被允许,不能证明键空间已经隔离。

验证禁止执行的命令

使用应用用户执行管理命令:

REDISCLI_AUTH="$APP_PASSWORD" \
redis-cli --user app -h 127.0.0.1 -p 6379 CONFIG GET dir

预期结果:

(error) NOPERM this user has no permissions to run the 'config' command

不要为了测试而真正执行 FLUSHDB 或 FLUSHALL。Redis 7 及以上可以由运维用户使用 ACL DRYRUN 检查,而不执行目标命令:

REDISCLI_AUTH="$OPS_PASSWORD" \
redis-cli --user opsadmin -h 127.0.0.1 -p 6379 \
ACL DRYRUN app SET app:acl-check:test ok

REDISCLI_AUTH="$OPS_PASSWORD" \
redis-cli --user opsadmin -h 127.0.0.1 -p 6379 \
ACL DRYRUN app GET other:acl-check:test

REDISCLI_AUTH="$OPS_PASSWORD" \
redis-cli --user opsadmin -h 127.0.0.1 -p 6379 \
ACL DRYRUN app FLUSHDB

预期结果:

  • 对 app:acl-check:test 执行 SET:返回 OK。
  • 对 other:acl-check:test 执行 GET:返回键权限不足。
  • 对 FLUSHDB:返回命令权限不足。

Redis 6 没有 ACL DRYRUN 时,可以使用 CONFIG GET dir、INFO 等不会修改数据的未授权命令进行拒绝测试;破坏性命令不应直接执行。

查看被拒绝的访问记录

由运维账号查看 ACL 拒绝日志:

REDISCLI_AUTH="$OPS_PASSWORD" \
redis-cli --user opsadmin -h 127.0.0.1 -p 6379 ACL LOG 20

该日志可能包含命令名、键名或客户端地址,不要直接上传到公开工单或聊天群。首次接入时,重点观察是否出现应用正常流程所需但尚未授权的命令。

应用接入时的权限边界

应用连接配置应明确填写 ACL 用户名 app,不能继续使用默认用户。以配置字段表示时应类似:

host=127.0.0.1
port=6379
username=app
password=<从密码管理系统读取>
database=0

应用默认连接数据库 0,不要为了兼容客户端而盲目授予 +select。Redis ACL 的命令权限通常不能进一步限制 SELECT 的数据库参数;一旦允许 SELECT,用户可能切换到其他逻辑数据库。若客户端强制发送 SELECT 0,优先修改客户端配置,或者评估使用独立 Redis 实例,而不是直接开放所有数据库切换权限。

应用接入时的权限边界配图

部分客户端建立连接时可能发送 PING、HELLO 或 CLIENT SETINFO。如果应用首次连接出现:

NOPERM this user has no permissions to run the 'hello' command

应先确认客户端版本和实际握手流程,再仅增加所需命令,例如:

REDISCLI_AUTH="$OPS_PASSWORD" \
redis-cli --user opsadmin -h 127.0.0.1 -p 6379 \
ACL SETUSER app +hello

运行时修改后要保存 ACL:

REDISCLI_AUTH="$OPS_PASSWORD" \
redis-cli --user opsadmin -h 127.0.0.1 -p 6379 ACL SAVE

执行 ACL SAVE 前应确认 CONFIG GET aclfile 指向预期文件,并检查文件权限。不要在未知 ACL 文件路径的情况下保存,以免将规则写入错误位置。

异常处理

未认证连接仍然可以访问

执行:

redis-cli -h 127.0.0.1 -p 6379 PING

如果仍返回 PONG,检查:

REDISCLI_AUTH="$OPS_PASSWORD" \
redis-cli --user opsadmin -h 127.0.0.1 -p 6379 ACL GETUSER default

默认用户必须处于 off 状态。还要确认连接确实访问了目标 Redis,而不是另一台实例或其他端口:

sudo ss -lntp | grep 6379

如果存在多个 Redis 实例,应核对服务文件、配置文件和监听端口。

应用收到 NOAUTH

NOAUTH 通常表示应用没有提供用户名和密码、仍使用旧的单密码连接方式,或连接到了关闭默认用户后的 Redis。检查应用连接配置是否包含:

  • 用户名 app。
  • 与 ACL 文件匹配的应用密码。
  • 正确的 Redis 地址和端口。
  • 客户端没有把 ACL 用户名误填为数据库名。

应用收到 NOPERM

先区分是命令权限不足还是键名权限不足:

REDISCLI_AUTH="$OPS_PASSWORD" \
redis-cli --user opsadmin -h 127.0.0.1 -p 6379 \
ACL DRYRUN app <command> <arguments>

如果是命令未授权,应根据应用实际功能添加单个命令;如果是键名未授权,应检查应用是否使用了未规划的键前缀。不要直接改成:

+@all
~*

这会使最小权限失去意义。

Redis 重启失败

检查服务日志和 ACL 文件权限:

sudo journalctl -u redis-server -n 100 --no-pager
sudo ls -l /etc/redis/redis.conf /etc/redis/users.acl

重点确认:

  • aclfile 路径真实存在。
  • Redis 服务账号可以读取 ACL 文件。
  • ACL 文件中的每一行格式完整。
  • 哈希值没有被截断。
  • 配置文件没有重复或拼写错误的指令。

在确认问题前,不要删除 ACL 文件,也不要将 default 用户临时改成 on nopass。后者会在排障期间重新暴露未认证访问面。

验收与回滚检查项

验收清单

  • [ ] redis-server --version 确认版本为 Redis 6.0 或以上。
  • [ ] systemctl is-active redis-server 返回 active。
  • [ ] Redis 仅监听回环地址或规划中的内网地址,没有意外监听公网。
  • [ ] /etc/redis/redis.conf 已配置正确的 aclfile。
  • [ ] ACL 文件属主、属组和权限符合服务账号读取要求。
  • [ ] default 用户已关闭。
  • [ ] opsadmin 与 app 使用不同密码。
  • [ ] 应用用户只能访问 app:* 键。
  • [ ] 应用所需命令可以正常执行。
  • [ ] CONFIG、ACL、FLUSHDB、FLUSHALL 等高风险命令被拒绝或通过 ACL DRYRUN 验证为拒绝。
  • [ ] other:* 等非应用键无法被读取或修改。
  • [ ] 应用连接配置不再使用默认用户。
  • [ ] 应用密码未写入公开代码仓库、命令历史或普通日志。
  • [ ] ACL 拒绝日志中没有未处理的正常业务命令。

回滚清单

ACL 配置变更的主要影响是认证失败、命令被拒绝和重启造成的连接中断,通常不会直接修改 Redis 数据。回滚前应先通知应用负责人,并确认已有配置和 ACL 备份。

如果本次变更前存在有效备份,可以在维护窗口内执行:

sudo cp -a "/etc/redis/redis.conf.${TS}.bak" /etc/redis/redis.conf
sudo cp -a "/etc/redis/users.acl.${TS}.bak" /etc/redis/users.acl

sudo systemctl restart redis-server

重启后使用原有的已知有效账号验证:

redis-cli -h 127.0.0.1 -p 6379 PING

如果回滚目标是本次新建且此前不存在的 ACL 文件,不要凭记忆删除文件。应先停止服务、确认配置已经移除 aclfile 引用,并确保有可恢复的原配置,再处理新文件。删除文件属于不可逆操作,只有在确认文件是本次创建、且不包含其他环境的 ACL 规则时才可以执行。

回滚完成后重新检查监听地址、默认用户状态、应用连接方式和数据服务状态,确认没有因为临时恢复访问而留下未认证访问或共享管理员凭据。

本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/6088.html

相关推荐