redis-cli Commands
8 methodsRedis 命令行客户端,用于连接 Redis 服务器并执行命令。
redis-cli -h <host> -p <port>连接到指定主机和端口的 Redis 服务器。
Parameters
| Name | Type | Description |
|---|---|---|
| host | string | Redis 服务器主机名或 IP,默认 127.0.0.1。 |
| port | number | Redis 服务器端口,默认 6379。 |
Returns
进入交互式命令行,或执行单次命令后退出。
Example
redis-cli
redis-cli
redis-cli -h redis.example.com -p 6380
redis-cli -h redis.example.com -p 6380 -a mypassword
redis-cli --cluster create 127.0.0.1:7000 127.0.0.1:7001PING测试服务器连接是否正常,可携带消息回显。
Returns
正常返回 PONG;携带参数时返回该参数字符串。
Example
redis-cli
redis-cli PING
# PONG
redis-cli
127.0.0.1:6379> PING
# PONG
127.0.0.1:6379> PING "hello"
# "hello"SET <key> <value>设置键值对,支持 EX/NX/XX 等选项控制过期与条件写入。
Parameters
| Name | Type | Description |
|---|---|---|
| key | string | 键名。 |
| value | string | 键值。 |
Returns
成功返回 OK;NX/XX 条件不满足时返回 nil。
Example
redis-cli
redis-cli SET user:1 "Tom"
# OK
redis-cli SET session:abc "data" EX 3600
# OK
127.0.0.1:6379> SET counter 100 NX
# OKGET <key>读取指定键对应的字符串值。
Parameters
| Name | Type | Description |
|---|---|---|
| key | string | 键名。 |
Returns
返回键对应的字符串值;键不存在返回 nil。
Example
redis-cli
redis-cli GET user:1
# "Tom"
redis-cli GET missing
# (nil)
127.0.0.1:6379> GET session:abc
# "data"DEL <key>删除一个或多个键,忽略不存在的键。
Parameters
| Name | Type | Description |
|---|---|---|
| key | string | 一个或多个键名,空格分隔。 |
Returns
返回被成功删除的键的数量(整数)。
Example
redis-cli
redis-cli DEL user:1
# (integer) 1
redis-cli DEL key1 key2 key3
# (integer) 2
127.0.0.1:6379> DEL nonexistent
# (integer) 0KEYS <pattern>匹配所有符合模式的键,生产环境慎用(阻塞),推荐 SCAN。
Parameters
| Name | Type | Description |
|---|---|---|
| pattern | string | glob 模式,如 user:*、*。 |
Returns
返回匹配键的列表;无匹配时返回空列表。
Example
redis-cli
redis-cli KEYS "user:*"
# 1) "user:1"
# 2) "user:2"
redis-cli KEYS "*"
redis-cli KEYS "session:???"
# 生产环境慎用,推荐使用 SCAN
redis-cli --scan --pattern "user:*"EXPIRE <key> <seconds>为键设置过期时间(秒),到期后自动删除。
Parameters
| Name | Type | Description |
|---|---|---|
| key | string | 键名。 |
| seconds | number | 过期秒数。 |
Returns
设置成功返回 1;键不存在返回 0。
Example
redis-cli
redis-cli SET token "abc123"
# OK
redis-cli EXPIRE token 3600
# (integer) 1
redis-cli TTL token
# (integer) 3600
redis-cli PERSIST token
# (integer) 1INFO [section]获取服务器运行信息,可按分类过滤,如 server、memory、stats。
Parameters
| Name | Type | Description |
|---|---|---|
| section | string | 信息分类,如 server、clients、memory、stats;省略返回全部。 |
Returns
返回多行 key:value 文本,以 # Server 等分类标题分组。
Example
redis-cli
redis-cli INFO
redis-cli INFO server
redis-cli INFO memory
redis-cli INFO stats
# 过滤输出
redis-cli INFO | grep used_memory: