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 未启用密码,可直接指定主机、端口和数据库编号:
redis-cli -h 127.0.0.1 -p 6379 -n 0预期输出
127.0.0.1:6379>出现提示符表示 TCP 连接和数据库选择已经完成,此时可以连续输入 Redis 命令。提示符中的地址会随实际主机与端口变化。
如果实例启用了密码,推荐通过环境变量提供认证信息,例如 REDISCLI_AUTH='<PASSWORD>' redis-cli -h <HOST> -p <PORT> -n <DB>。实际执行时替换这些占位符。相比直接使用 -a,这种方式更不容易把密码留在 Shell 历史或进程参数中。
使用单次命令模式
把 Redis 命令直接放在连接参数之后,redis-cli 会连接、执行命令、打印结果,然后退出,适合健康检查和脚本调用。
redis-cli -h 127.0.0.1 -p 6379 -n 0 PING预期输出
PONG交互模式适合连续探索数据;单次命令模式适合自动化。两种模式使用的是同一套连接参数,因此排查连接问题时可以先用 PING 验证实例是否可达。
处理常见连接失败
看到 Connection refused 时,优先确认 Redis 是否启动、监听地址是否正确,以及目标端口是否开放。出现 NOAUTH Authentication required,说明网络已经连通,但服务端要求认证。
出现 WRONGPASS invalid username-password pair 时,应核对密码或 ACL 用户,而不是继续排查端口。连接成功后若读不到预期数据,还要检查 -n 指定的数据库编号是否正确。
能稳定看到交互提示符或 PONG,就说明 redis-cli 已经完成最基本的实例连接验证;之后再执行读写命令,问题定位会更清晰。