Redis 与缓存 / 系统课时

使用 redis-cli 连接实例

使用 redis-cli 连接实例

redis-cli 是最直接的 Redis 连接工具。本节用主机、端口、数据库编号和认证参数建立连接,并区分交互模式与单次命令模式,最终能够判断自己是否连接到了正确的 Redis 实例。

学习目标

  • 能使用主机、端口和数据库编号连接 Redis 实例
  • 能为启用认证的实例安全地提供密码
  • 能区分交互模式与单次命令模式,并完成基本连通性验证

认识连接参数

redis-cli 默认连接 127.0.0.1:6379,并使用编号为 0 的逻辑数据库。远程或非默认实例通常需要显式指定参数。

参数 含义 常见示例
-h Redis 主机名或 IP 127.0.0.1
-p Redis TCP 端口 6379
-n 连接后选择的逻辑数据库编号 0
-a 认证密码 不建议直接写入命令历史

数据库编号不是独立实例,而是同一 Redis 实例中的逻辑命名空间。默认数据库通常是 0;生产环境是否开放多个逻辑数据库取决于服务端配置和团队约定。

建立交互式连接

假设本机 Redis 未启用密码,可直接指定主机、端口和数据库编号:

bash
redis-cli -h 127.0.0.1 -p 6379 -n 0

预期输出

text
127.0.0.1:6379>

出现提示符表示 TCP 连接和数据库选择已经完成,此时可以连续输入 Redis 命令。提示符中的地址会随实际主机与端口变化。

如果实例启用了密码,推荐通过环境变量提供认证信息,例如 REDISCLI_AUTH='<PASSWORD>' redis-cli -h <HOST> -p <PORT> -n <DB>。实际执行时替换这些占位符。相比直接使用 -a,这种方式更不容易把密码留在 Shell 历史或进程参数中。

使用单次命令模式

把 Redis 命令直接放在连接参数之后,redis-cli 会连接、执行命令、打印结果,然后退出,适合健康检查和脚本调用。

bash
redis-cli -h 127.0.0.1 -p 6379 -n 0 PING

预期输出

text
PONG

交互模式适合连续探索数据;单次命令模式适合自动化。两种模式使用的是同一套连接参数,因此排查连接问题时可以先用 PING 验证实例是否可达。

处理常见连接失败

看到 Connection refused 时,优先确认 Redis 是否启动、监听地址是否正确,以及目标端口是否开放。出现 NOAUTH Authentication required,说明网络已经连通,但服务端要求认证。

出现 WRONGPASS invalid username-password pair 时,应核对密码或 ACL 用户,而不是继续排查端口。连接成功后若读不到预期数据,还要检查 -n 指定的数据库编号是否正确。

能稳定看到交互提示符或 PONG,就说明 redis-cli 已经完成最基本的实例连接验证;之后再执行读写命令,问题定位会更清晰。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

使用 redis-cli 连接实例

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

登录哪都通