Redis 与缓存 / 知识点

Redis 开发常用命令速查

连接与键定位

CODE
redis-cli [OPTIONS] [cmd [arg [arg ...]]]

通过 redis-cli 连接指定实例或执行单条命令,适合本地联调与远程排查;生产环境应启用加密连接,并避免在命令行参数中明文传递密码。

命令行连接实例

需要确认 Redis 实例是否可连接、认证是否成功,或临时执行一条 Redis 命令时,使用 redis-cli。它支持本地与远程连接、交互模式、单命令执行、ACL 认证及 TLS 加密连接。最常用的检查方式是发送 PING,正常响应为 PONG。

基本语法

bash
redis-cli [OPTIONS] [cmd [arg [arg ...]]]

其中 OPTIONS 指定连接方式,cmd 是要执行的 Redis 命令,后续 arg 是命令参数。省略 cmd 会进入交互模式;提供 cmd 则执行该命令并输出结果。

默认情况下,redis-cli 使用普通 TCP 连接 127.0.0.1:6379,不主动启用 TLS。实际端口及认证要求由 Redis 实例配置决定。

常用连接选项

选项 作用 使用要点
-h <HOST> 指定主机名或 IP 默认 127.0.0.1
-p <PORT> 指定连接端口 默认 6379
--user <USER> 指定 ACL 用户名 与密码认证配合使用
--askpass 交互式输入密码 输入时隐藏密码,不适合无人值守脚本
-a <PASSWORD> 通过参数传递密码 可能暴露在进程参数或命令历史中
--tls 启用 TLS 加密连接 服务端必须提供 TLS 端口
--cacert <PATH> 指定受信任的 CA 证书文件 用于验证服务端证书
-n <DB> 选择逻辑数据库 默认数据库 0;Redis Cluster 仅支持数据库 0
-c 启用集群重定向处理 跟随 MOVED、ASK 重定向

--askpass 会优先使用交互输入的密码,忽略 -a 和 REDISCLI_AUTH。如果实例未启用密码认证,不需要提供认证选项。

本地连接与验证

前置条件:本机已安装 redis-cli,且目标 Redis 实例正在监听 127.0.0.1:6379,允许当前客户端执行 PING。

bash
# 只检查连接响应,不读取或修改业务键
redis-cli -h 127.0.0.1 -p 6379 PING

预期输出:

text
PONG

收到 PONG 表示客户端能够连接实例,并且当前连接可以执行 PING。它不能证明业务读写权限正常,也不能说明所有集群节点均可访问。

如果需要连续执行多条命令,可以不指定 PING,直接运行 redis-cli -h 127.0.0.1 -p 6379 进入交互模式。在提示符下输入 PING 检查响应,输入 QUIT 退出。

远程认证与 TLS

连接生产环境时,先向实例管理员确认主机、TLS 端口、CA 证书及 ACL 用户。不要默认远程实例也使用端口 6379,更不要为了排查连接问题直接关闭证书验证。

以下为片段示例,必须先把 <HOST>、<PORT>、<PATH> 和 <USER> 分别替换为真实主机、端口、CA 文件路径及 ACL 用户名。要求目标实例已启用 TLS,且该用户允许执行 PING。

bash
# 使用 TLS 验证服务器证书,并交互式输入 ACL 密码
redis-cli -h <HOST> -p <PORT> --tls --cacert <PATH> --user <USER> --askpass PING

预期结果:终端先要求输入密码;证书验证和认证均成功后输出:

text
PONG

若服务器要求双向 TLS,还需要通过 --cert 和 --key 提供客户端证书及对应私钥。不要将 --insecure 作为生产环境的连接解决方案,它会跳过证书验证。

无人值守脚本可以通过受控的环境变量 REDISCLI_AUTH 提供密码,但仍应限制变量的读取范围,避免在日志、构建输出或调试信息中泄露凭据。环境变量并不等于专用密钥管理系统。

常见失败与恢复

现象 可能原因 排查与恢复
Connection refused 端口未监听、地址错误或连接被拒绝 核对 -h、-p 和实例监听配置
连接超时 路由、防火墙、安全组或网络策略阻断 检查网络可达性和连接超时设置
NOAUTH 实例要求认证,但当前连接尚未认证 使用正确的认证方式重新连接
WRONGPASS 用户名、密码错误或 ACL 用户被禁用 检查凭据及 ACL 用户状态
TLS 握手或证书验证失败 TLS 模式、CA、主机名或证书不匹配 确认 TLS 端口、证书信任链和主机名
MOVED 命令涉及的键属于其他集群节点 对 Redis Cluster 使用 -c 并确保目标节点可达

错误文本会随 Redis 版本、客户端版本、操作系统及代理实现而有所不同,应结合实际终端输出判断。

安全与使用边界

  • 优先使用 --askpass 交互认证,避免在共享终端直接传递 -a 密码,或在含密码的 redis:// URI 中暴露凭据。
  • 生产环境优先使用 TLS,并验证服务端证书;普通 TCP 连接不提供传输加密。
  • 连接成功不代表拥有所有命令或键的权限。ACL 可能分别限制命令、键模式与发布订阅频道。
  • 不要在尚未确认实例身份和数据库范围时执行 FLUSHDB、FLUSHALL 等破坏性命令;误删后的恢复依赖事先存在的备份或其他数据恢复机制。

速查:本地探活使用 redis-cli -h 127.0.0.1 -p 6379 PING;远程生产连接应根据实例配置补充 TLS、证书验证和认证参数。

字符串与缓存生命周期

目录与阅读设置

记录一个想法

Redis 开发常用命令速查

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通