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



