Redis 6.0.6中Sentinel执行auth-pass命令报错问题咨询

报错原因 #

你遇到的ERR Unknown sentinel subcommand 'auth-user'错误，核心原因是当前使用的Redis Sentinel版本不支持通过运行时命令sentinel auth-pass动态设置主节点密码，具体分为两种情况：

• 若使用的是Redis 5.x及更早版本：这些版本中，sentinel auth-pass仅能通过配置文件（sentinel.conf）设置，不支持在运行时通过命令行动态配置。官网文档展示的是新版本特性，旧版本并无此运行时命令，执行时会被错误解析为类似auth-user的未知子命令。
• 若使用的是Redis 6.x早期版本：6.0引入了ACL用户认证功能，sentinel auth-pass需要配合sentinel auth-user一起使用（当主节点启用ACL时），单独执行auth-pass会触发解析错误，提示未知的auth-user子命令。

关于升级到6.2.0的建议 #

升级至Redis 6.2.0及以上版本可以彻底解决这个问题：

• 6.2.0及后续版本完善了Sentinel的运行时命令支持，允许单独使用sentinel auth-pass <master-group-name> <password>动态设置主节点密码，无需修改配置文件或重启Sentinel。
• 同时支持配合sentinel auth-user设置ACL用户名，适配启用ACL的主节点场景。

临时替代方案（不升级版本） #

如果暂时无法升级，可通过修改Sentinel配置文件实现：

1. 编辑sentinel.conf，添加配置项：sentinel auth-pass myMaster 123456
2. 重启Sentinel服务，配置即可生效

内容的提问来源于stack exchange，提问作者dexter