第 2 章:十分钟跑起来
Redis 的门槛低到有点反常:一个容器、一条
PING,就开始了。
学习目标
- 用 Docker 起一个带持久化的 Redis,端口和数据卷都配好
- 用
redis-cli和 Python 客户端各连通一次 - 看懂一次
SET在网络上传输的原始字节 - 连不上时,知道按哪四个方向排查
2.1 起一个容器
Docker 那门课第 8 章已经讲过 Compose 的基本结构,这里直接给配置:
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 | 宿主机能访问 | 只能容器内访问,本地客户端连不上 |
启动并验证:
docker compose up -d
docker compose exec redis redis-cli ping
# PONGPONG 是 Redis 最短的健康检查。生产环境别只看这个,第 8 章会给更完整的检查方法。
2.2 第一条命令
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 | 当前库有多少 key | O(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 包:
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")) # 60decode_responses=True 是个实用开关:关着的时候拿到的都是 b"hello" 这种字节串,比较和打印都别扭。
连接池不是优化项,是必需项。每次请求新建 TCP 连接,在高频场景下握手开销比命令本身还大。
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?下一章把五种结构各配一个真实场景,并且给一张选型决策图。