Skip to content

第 2 章:十分钟跑起来 ​

Redis 的门槛低到有点反常:一个容器、一条 PING,就开始了。


学习目标 ​

  • 用 Docker 起一个带持久化的 Redis,端口和数据卷都配好
  • 用 redis-cli 和 Python 客户端各连通一次
  • 看懂一次 SET 在网络上传输的原始字节
  • 连不上时,知道按哪四个方向排查

2.1 起一个容器 ​

Docker 那门课第 8 章已经讲过 Compose 的基本结构,这里直接给配置:

yaml
services:
  redis:
    image: redis:7-alpine
    ports:
      - "6379:6379"
    command: ["redis-server", "--appendonly", "yes"]
    volumes:
      - redis-data:/data
    restart: unless-stopped

volumes:
  redis-data:

三个参数值得解释:

配置作用不加会怎样
--appendonly yes开启 AOF 持久化重启后数据全丢(RDB 有快照间隔)
volumes数据落在宿主机卷容器删除,数据一起消失
ports宿主机能访问只能容器内访问,本地客户端连不上

启动并验证:

bash
docker compose up -d
docker compose exec redis redis-cli ping
# PONG

PONG 是 Redis 最短的健康检查。生产环境别只看这个,第 8 章会给更完整的检查方法。


2.2 第一条命令 ​

bash
docker compose exec redis redis-cli

127.0.0.1:6379> SET greeting "hello"
OK
127.0.0.1:6379> GET greeting
"hello"
127.0.0.1:6379> DEL greeting
(integer) 1

注意 DEL 返回的是 (integer) 1——删除成功返回 1,key 不存在返回 0。这个返回值在写代码时很重要:它告诉你"这次操作到底有没有生效"。

几个立刻用得上的命令:

命令作用备注
DBSIZE当前库有多少 keyO(1),随便用
TYPE key这个 key 是什么类型排查类型错误
TTL key还剩多少秒过期-1 表示没设过期,-2 表示不存在
SCAN 0 MATCH user:* COUNT 100渐进式遍历别用 KEYS *,会卡住服务
INFO memory内存占用情况第 4 章细讲

KEYS * 在数据量上万时会阻塞整个实例——Redis 命令执行是单线程的,这条命令跑多久,别的请求就等多久。用 SCAN 分页扫。


2.3 客户端怎么连 ​

Python 用官方的 redis 包:

python
import redis

# 连接池:不要每次请求新建连接
pool = redis.ConnectionPool(
    host="127.0.0.1", port=6379, db=0,
    decode_responses=True,     # 返回 str 而不是 bytes
    max_connections=20,
)
r = redis.Redis(connection_pool=pool)

r.set("greeting", "hello", ex=60)   # ex=60:60 秒后自动过期
print(r.get("greeting"))            # hello
print(r.ttl("greeting"))            # 60

decode_responses=True 是个实用开关:关着的时候拿到的都是 b"hello" 这种字节串,比较和打印都别扭。

连接池不是优化项,是必需项。每次请求新建 TCP 连接,在高频场景下握手开销比命令本身还大。

一条 SET foo bar 在网线上的真实样子*3数组,3 个元素$3\r\nSET批量字符串,3 字节:SET$3\r\nfoo3 字节:key 名$3\r\nbar3 字节:value+OK服务端响应:简单字符串* 开头是数组,$ 开头是批量字符串,后面跟字节数,+ 是简单字符串。你平时看不到这些,但排错时会看到——比如客户端报 "Protocol error" 就是这里对不上。

2.4 请求和响应是怎么对上号的 ​

Redis 协议(RESP)是纯文本、一问一答。客户端发一条命令,服务端处理完回一条。

这解释了一个常见现象:一个慢命令会拖慢所有人。KEYS *、HGETALL 一个几万字段的大 Hash、DEL 一个大 key,都会让后面的请求一起等。Redis 6 之后网络 IO 可以多线程,但命令执行仍然是单线程——所以慢命令的锅还在。


2.5 连不上,按这四条查 ​

现象原因验证
Connection refused容器没起,或端口没映射docker compose ps
宿主机连不上,容器内能连只映射了内网,或 bind 配置检查 ports 与 bind 设置
NOAUTH Authentication required设了密码但没传客户端加 password
能连上但一直超时网络策略/防火墙,或连到了错的实例redis-cli -h <ip> ping

容器场景还有一个专属坑:从宿主机用 localhost 连容器里的服务,如果端口没映射,一定失败。要么映射端口,要么从容器内部访问(docker compose exec)。


本章小结 ​

要点说明
起服务容器 + --appendonly yes + 数据卷 + 端口映射
健康检查PING 返回 PONG;生产要看 INFO
基础命令SET/GET/DEL/TYPE/TTL/DBSIZE
遍历用 SCAN,别用 KEYS *
客户端连接池 + decode_responses=True
协议RESP 纯文本,一问一答,单线程执行
连不上端口、bind、密码、防火墙四向排查

下一章 ​

能连上了,接下来是选择:同一个需求,用 String、Hash、List、Set 还是 ZSet?下一章把五种结构各配一个真实场景,并且给一张选型决策图。

本文阅读--次|全站访问--次|访客--人