redis-cli 实战指南：Redis 命令行高阶用法

当你需要 Redis 命令行界面（redis-cli）参考和使用指南时使用此技能。每当用户提及 redis-cli、Redis CLI 或任何涉及从命令行查询、检查、调试或管理 Redis 的任务时使用。触发条件包括键/值读写、SCAN 或键空间...

redis-cli 是与 Redis 交互的主要命令行工具。它支持两种模式：命令行执行（运行命令后退出）和交互模式（带有标签补全、历史和提示的 REPL）。它还提供用于监控、延迟分析、键空间扫描和数据导入/导出的特殊模式。

官方资源： Redis CLI 文档 命令参考 下载

# 检查 redis-cli 是否已安装
redis-cli --version

# 安装选项：

# macOS（Homebrew）
brew install redis

# Ubuntu / Debian
sudo apt install redis-tools

# CentOS / RHEL
sudo yum install redis

# Alpine
apk add redis

# 从源码构建（仅二进制文件）
make redis-cli
# 二进制文件位于：src/redis-cli

# Docker（无需安装）
docker run -it --rm redis redis-cli -h <host> -p <port> PING

# 基本连接（默认：127.0.0.1:6379）
redis-cli
redis-cli -h redis15.localnet.org -p 6390 PING

# 带密码（出于安全考虑，优先使用 REDISCLI_AUTH 环境变量）
redis-cli -a myUnguessablePazzzzzword123 PING

# URI 连接
redis-cli -u redis://user:password@host:port/dbnum PING

# TLS
redis-cli --tls --cacert /path/to/ca.crt -h redis.example.com PING

# 特定数据库
redis-cli -n 2 DBSIZE

# IPv4/IPv6 偏好
redis-cli -4 PING   # 优先 IPv4
redis-cli -6 PING   # 优先 IPv6

# 命令行模式：执行一个命令并退出
redis-cli INCR mycounter
redis-cli GET mykey

# 交互模式：在提示符下输入命令
redis-cli
127.0.0.1:6379> PING
PONG
127.0.0.1:6379> SELECT 2
OK
127.0.0.1:6379[2]> DBSIZE
(integer) 1

提示符显示 host:port[db]。使用 CONNECT 在交互模式下切换实例。

GET key                        # 获取值
SET key value [NX|XX] [EX sec|PX ms|KEEPTTL]  # 带条件/TTL 设置
SET key value GET              # 设置新值，返回旧值
GETSET key newvalue            # [改用 SET key value GET]
MGET key1 key2 ...             # 获取多个值
INCR key                       # 递增整数（+1）
INCRBY key 10                  # 按数量递增
STRLEN key                     # 字符串长度
GETRANGE key 0 50              # 子串

HGET key field                 # 获取字段值            O(1)
HMGET key f1 f2                # 获取多个字段        O(N)
HGETALL key                    # 获取所有字段/值      O(N)
HKEYS key                      # 获取所有字段名        O(N)
HLEN key                       # 字段数量           O(1)
HEXISTS key field              # 检查字段是否存在         O(1)
HSCAN key 0 [MATCH pat]        # 迭代哈希字段        O(1) per call

LRANGE key 0 -1                # 获取所有元素           O(N)
LLEN key                       # 列表长度                O(1)
LINDEX key 0                   # 按索引获取               O(N)
LPOS key value                 # 查找元素位置      O(N)

SMEMBERS key                   # 获取所有成员            O(N)
SCARD key                      # 集合基数            O(1)
SISMEMBER key member           # 检查成员资格           O(1)
SMISMEMBER key m1 m2           # 多成员资格检查     O(N)
SSCAN key 0 [MATCH pat]        # 迭代集合成员        O(1) per call

ZRANGE key 0 -1 [WITHSCORES]           # 按索引              O(log(N)+M)
ZRANGE key -inf +inf BYSCORE           # 按分数范围        O(log(N)+M)
ZRANGE key [a [z BYLEX                 # 按字典序      O(log(N)+M)
ZCARD key                               # 成员计数          O(1)
ZSCORE key member                       # 获取分数             O(1)
ZRANK key member                        # 获取排名              O(log(N))
ZSCAN key 0 [MATCH pat]                 # 迭代成员       O(1) per call

EXISTS key [key ...]           # 检查存在性（O(N) for multi）— 返回计数
TYPE key                       # 数据类型：string|list|set|zset|hash|stream  O(1)
TTL key                        # 过期秒数（-1=无，-2=不存在）  O(1)
PTTL key                       # 过期毫秒数                      O(1)
MEMORY USAGE key [SAMPLES n]   # 内存消耗（字节）                    O(N)
OBJECT ENCODING key            # 内部编码（ziplist、hashtable 等）   O(1)
OBJECT IDLETIME key            # 自上次访问以来的秒数                      O(1)
DBSIZE                         # 当前数据库总键数                 O(1)
RANDOMKEY                      # 返回随机键                            O(1)

基于 SCAN 的迭代从不阻塞服务器，而 KEYS * 应避免在生产中使用。

# redis-cli 内置扫描模式
redis-cli --scan                          # 列出所有键
redis-cli --scan --pattern 'user:*'       # 按模式过滤
redis-cli --scan --pattern '*:12345*'     # 通配符模式
redis-cli --scan --count 100              # 批量大小提示

# 交互模式下的程序化 SCAN
SCAN 0 MATCH user:* COUNT 100
# 返回：1) next_cursor  2) [keys...]
# 继续：SCAN <next_cursor> MATCH user:* COUNT 100
# 当游标返回 0 时迭代完成

# 计算匹配模式的键数量
redis-cli --scan --pattern 'session:*' | wc -l

SCAN 保证：完整的迭代（游标 0 → 游标 0）始终返回整个持续期间存在的所有元素。元素可能多次出现——在应用程序中处理重复。

# 实时统计（每秒更新，使用 -i 更改间隔）
redis-cli --stat

# 服务器信息
redis-cli INFO server             # 服务器详情
redis-cli INFO memory             # 内存使用
redis-cli INFO keyspace           # 数据库键计数
redis-cli INFO replication        # 复制状态
redis-cli INFO all                # 所有信息

# 键空间分析
redis-cli --bigkeys               # 按元素计数查找最大键
redis-cli --memkeys               # 按内存使用查找最大键
redis-cli --keystats              # 带分布的组合 bigkeys + memkeys

# 延迟分析
redis-cli --latency               # 连续延迟采样
redis-cli --latency-history       # 随时间延迟（15秒窗口）
redis-cli --latency-dist          # 延迟频谱可视化
redis-cli --intrinsic-latency 5   # 系统基准延迟（在 Redis 主机上运行）

# 原始输出（无类型前缀）— 管道时默认
redis-cli --raw GET mykey
redis-cli GET mykey > /tmp/output.txt    # 自动原始模式

# 人类可读（强制）当管道时
redis-cli --no-raw GET mykey | cat

# CSV 输出
redis-cli --csv LRANGE mylist 0 -1

# JSON 输出（RESP3，使用 -2 切换 RESP2）
redis-cli --json HGETALL user:1

# 从 stdin 读取最后一个参数
cat /etc/services | redis-cli -x SET net_services

# 从文件管道命令
cat /tmp/commands.txt | redis-cli

# 运行命令 N 次
redis-cli -r 5 INCR counter

# 带延迟运行（秒，支持小数）
redis-cli -r -1 -i 1 INFO | grep rss_human    # 无限，每 1 秒

# 交互模式：在命令前加次数
5 INCR mycounter    # 运行 5 次

# ACL 管理
redis-cli ACL LIST                                    # 列出所有用户
redis-cli ACL SETUSER admin on >pwd ~* +@all          # 创建管理员用户
redis-cli ACL SETUSER readonly on >pwd ~* +@read      # 创建只读用户
redis-cli ACL DELUSER username                        # 删除用户
redis-cli ACL DRYRUN username GET key                 # 测试用户权限
redis-cli ACL GENPASS                                 # 生成随机密码

# 客户端管理
redis-cli CLIENT LIST                                 # 列出所有连接
redis-cli CLIENT KILL ADDR ip:port                    # 断开客户端连接
redis-cli CLIENT PAUSE 5000 WRITE                     # 暂停写入 5 秒
redis-cli CLIENT SETNAME my-app                       # 命名当前连接

# 配置
redis-cli CONFIG GET maxmemory                        # 读取配置
redis-cli CONFIG SET maxmemory 100mb                  # 运行时设置配置
redis-cli CONFIG REWRITE                              # 持久化到 redis.conf
redis-cli CONFIG RESETSTAT                            # 重置 INFO 计数器

# 复制确认
redis-cli WAIT 2 5000                                 # 等待 2 个副本（5 秒超时）
redis-cli WAITAOF 1 1 5000                            # 等待 AOF fsync（Redis 7.2+）

# 持久化
redis-cli BGSAVE                                      # 后台 RDB 保存
redis-cli BGREWRITEAOF                                # 后台 AOF 重写
redis-cli LASTSAVE                                    # 上次保存时间戳

# 复制
redis-cli REPLICAOF host port                         # 成为副本
redis-cli REPLICAOF NO ONE                            # 提升为主节点

# 服务器生命周期
redis-cli SHUTDOWN SAVE                               # 保存并停止
redis-cli SHUTDOWN NOSAVE                             # 停止而不保存

# 慢日志
redis-cli SLOWLOG GET 10                              # 最近的慢命令
redis-cli SLOWLOG LEN                                 # 条目数量
redis-cli SLOWLOG RESET                               # 清除条目

# 集群管理
redis-cli --cluster check host:port                   # 检查集群健康
redis-cli --cluster reshard host:port                 # 在节点间移动槽位
redis-cli -c -h cluster-node PING                     # 集群感知连接

references/connection-and-options.md 完整连接选项、CLI 标志、SSL/TLS、环境变量、交互模式功能（补全、历史、偏好）、RESP 协议版本 配置连接、设置 TLS、自定义 CLI 行为

references/data-query-commands.md 核心数据类型命令：字符串、哈希、列表、集合、有序集合、流、位图、HyperLogLog、地理空间、以及键操作、数据库操作和事务 查找核心命令语法、理解命令选项和返回值

references/module-data-types.md 模块数据类型：JSON（RedisJSON）、向量集合（Redis 8.0+）、布隆过滤器、布谷鸟过滤器、Top-K、Count-Min Sketch、T-Digest、时间序列（TS.）、全文搜索/RediSearch（FT.）— 含完整命令语法和行为说明 使用 Redis 模块数据类型、相似性搜索、概率数据结构、时间序列数据、全文搜索

references/key-management.md SCAN 系列详情（SCAN/SSCAN/HSCAN/ZSCAN）、大键分析（--bigkeys、--memkeys、--keystats）、键过期（EXPIRE、TTL、PERSIST）、键空间模式、批量插入 扫描数据库、分析键分布、管理键生命周期

references/inspection-and-monitoring.md INFO 章节、MONITOR、--stat 模式、延迟工具（--latency、--latency-history、--latency-dist、--intrinsic-latency）、RDB 备份、副本模式、LRU 模拟 监控 Redis 实例、调试性能、创建备份

references/advanced-features.md Lua 脚本（--eval、--ldb）、发布/订阅模式、管道模式、CSV/JSON 输出、字符串引号与转义、从 stdin 获取输入、远程 RDB 传输、集群管理（--cluster 子命令、集群命令） 运行脚本、订阅频道、批量数据操作、管理 Redis 集群

references/server-administration.md ACL 管理（ACL SETUSER/DELUSER/LIST/CAT/GENPASS）、客户端管理（CLIENT LIST/KILL/PAUSE/TRACKING）、配置（CONFIG GET/SET/REWRITE）、复制确认（WAIT/WAITAOF）、持久化（SAVE/BGSAVE/BGREWRITEAOF）、复制设置（REPLICAOF）、服务器生命周期（SHUTDOWN/FAILOVER） 管理用户和权限、控制客户端连接、运行时配置、确保写入持久性、持久化管理、复制设置

# 步骤 1：基本统计
redis-cli INFO keyspace
redis-cli DBSIZE

# 步骤 2：查找大键和内存使用
redis-cli --bigkeys
redis-cli --memkeys

# 步骤 3：采样键并检查类型
redis-cli --scan | head -20
redis-cli TYPE <key>
redis-cli TTL <key>

# 步骤 4：根据类型读取数据
redis-cli HGETALL <hash_key>
redis-cli LRANGE <list_key> 0 -1
redis-cli ZRANGE <zset_key> 0 -1 WITHSCORES

# 实时服务器统计
redis-cli --stat -i 2

# 专门监控内存
redis-cli -r -1 -i 5 INFO memory | grep used_memory_human

# 监控所有命令（注意：高开销）
redis-cli MONITOR

# 连续延迟
redis-cli --latency-history -i 5

# 按模式统计键数量
redis-cli --scan --pattern 'session:*' | wc -l

# 查找并检查哈希键
redis-cli --scan --pattern 'user:*' | while read key; do
  echo "=== $key ==="
  redis-cli HGETALL "$key"
done

# 检查匹配键的 TTL
redis-cli --scan --pattern 'cache:*' | while read key; do
  redis-cli TTL "$key"
done

来源说明：本文内容整理自开源项目 agentic-awesome-skills（中文翻译版），遵循 CC BY 4.0（知识共享署名 4.0 国际）许可协议，此处作为中文资料整理分享，版权归原作者所有。

Redis 命令行工具的完整使用指南，涵盖常用命令、批量操作、集群管理与脚本化自动化。

数据库

开发工具

后端

掌握redis-cli命令行工具的高阶用法，涵盖连接配置、数据查询速查表、SCAN安全扫描、性能监控、集群管理与Lua脚本自动化。本文提供实用速查与生产环境安全注意事项，助开发者高效操作Redis。

命令行工具

敏感数据

数据结构

调试器

服务器

CentOS

Ubuntu

Debian

Docker

Redis

Agent

JSON

ES特惠专场，新客首购5.5折起！


文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

redis-cli 实战指南：Redis 命令行高阶用法

redis-cli 实战指南：Redis 命令行高阶用法

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐