2. 安装 Redis（多平台）

本节目标

用 Docker 一条命令跑起 Redis（最快上手方式）
在 Ubuntu/Debian、Rocky/AlmaLinux 上用官方包管理器安装
在 macOS 上用 Homebrew 安装
在 Windows 上通过 Docker（或 WSL）运行 Redis
了解从源码编译 Redis 8.x 的关键前置依赖

2-1 最快方式：Docker

如果你本机已装 Docker，这是最省事的办法——不需要关心操作系统差异：

docker run -d --name redis -p 6379:6379 redis

-d：后台运行（detached）。
--name redis：给容器起名，方便后续操作。
-p 6379:6379：把容器内的 6379 端口映射到宿主机，这样本机 redis-cli 就能连上。

想连进去看看？再开一个终端：

docker exec -it redis redis-cli

127.0.0.1:6379> PING
PONG

提示：Redis 8 的官方镜像已包含过去「Redis Stack」的全部内置模块（JSON、搜索、概率类型、向量集、时间序列等）。所以 redis:latest 这个镜像本身就是「全家桶」，不需要再单独装扩展。

2-2 Linux 安装

2-2.1 Ubuntu / Debian（APT）

Redis 官方为 Debian/Ubuntu 提供了 apt 源，版本比系统自带仓库更新、更全：

sudo apt-get install lsb-release curl gpg
curl -fsSL https://packages.redis.io/gpg | sudo gpg --dearmor -o /usr/share/keyrings/redis-archive-keyring.gpg
sudo chmod 644 /usr/share/keyrings/redis-archive-keyring.gpg
echo "deb [signed-by=/usr/share/keyrings/redis-archive-keyring.gpg] https://packages.redis.io/deb $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/redis.list
sudo apt-get update
sudo apt-get install redis

安装完成后，Redis 通常以系统服务形式存在：

# 启动
sudo systemctl start redis-server
# 开机自启
sudo systemctl enable redis-server
# 查看状态
sudo systemctl status redis-server

2-2.2 Rocky Linux / AlmaLinux（RPM）

创建仓库文件 /etc/yum.repos.d/redis.repo（按需选 rockylinux9 或 rockylinux8）：

[Redis]
name=Redis
baseurl=http://packages.redis.io/rpm/rockylinux9
enabled=1
gpgcheck=1

然后导入公钥并安装：

curl -fsSL https://packages.redis.io/gpg > /tmp/redis.key
sudo rpm --import /tmp/redis.key
sudo yum install redis

2-3 macOS 安装（Homebrew）

macOS 用户用 Homebrew 最方便：

brew tap redis/redis
brew install --cask redis

启动（使用默认配置）：

redis-server $(brew --prefix)/etc/redis.conf

如果只想「装好就行、前台跑着看日志」，也可以直接：

redis-server

提示：Homebrew 安装的 redis-cli 与服务器同版本，配合 Mac 上的 Redis Insight（官方 GUI）可以图形化浏览数据。

2-4 Windows 安装

Redis 官方不再提供原生 Windows 二进制（历史上的 redis-windows 项目已停止维护）。在 Windows 上推荐两种办法：

方式一：Docker（推荐）

与 2.1 相同，在 PowerShell 里执行（前提是 Docker Desktop 已安装并配置为运行 Linux 容器）：

docker run -d --name redis -p 6379:6379 redis

随后用 docker exec -it redis redis-cli 或本机任意 redis-cli 连接。

方式二：WSL2（Windows Subsystem for Linux）

在 Windows 商店装一个 Ubuntu 发行版，进入 WSL 终端后，按 2.2.1 的 APT 步骤安装即可，体验和原生 Linux 一致。

方式三：Memurai（预览）

Windows 官方兼容伙伴 Memurai 提供了 Redis Open Source 的 Windows 预览版（基于 8.2 RC1），可从 memurai.com 获取。它适合在 Windows 上做本地开发，但生产环境仍建议用 Linux/Docker。

2-5 从源码编译（进阶）

当需要特定版本、特定编译选项（TLS、systemd）或最新的 8.10.0 源码时，可以自行编译。Redis 8 因为内置了 JSON、查询引擎、概率结构等模块，编译依赖比早期版本重很多：需要 GCC/Clang、CMake（3.25 ≤ 版本 ≤ 3.31.6，CMake 4.x 不受支持）、Rust、LLVM、OpenSSL、Python 3 等。

最省心的做法是让仓库自带引导脚本装好依赖：

# 1) 取源码（发布包已包含模块源码）
wget -O redis-8.10.0.tar.gz https://github.com/redis/redis/releases/download/8.10.0/redis-full.tar.gz
tar xvf redis-8.10.0.tar.gz && cd redis-8.10.0

# 2) 用 bootstrap 自动装依赖（推荐在干净容器里执行，可能覆盖已有工具链版本）
make bootstrap

# 3) 编译（可选 BUILD_TLS=yes 开启 TLS）
make -j "$(nproc)"

# 4) 运行（发布包已将模块 loadmodule 写入 redis.conf）
./src/redis-server redis.conf

如果你是从 git checkout 而不是发布包编译，模块配置在自动生成的 redis-full.conf 里，应执行 ./src/redis-server redis-full.conf。

提示：make bootstrap 可能会覆盖系统里已有的编译器 / CMake / LLVM 版本，建议在一次性容器里跑；或先 make bootstrap list / make bootstrap dry-run 预览缺失的依赖再手动补齐。普通学习者用 Docker 或系统包管理器即可，无需编译。

2-6 验证安装

无论用哪种方式装好，最终都用 redis-cli 验证：

redis-cli PING

PONG

再查看版本，确认是 8.x：

redis-cli INFO server | grep redis_version

redis_version:8.10.0

除了 INFO server，也可以直接用 redis-cli --version 或 redis-server --version 分别查看客户端与服务端的版本号，二者通常一致。若你选择从源码编译，版本会精确反映所 checkout 的 tag（例如 8.10.0）。确认版本是排障的第一步——很多「命令不存在」「选项不认识」的困惑，根源其实是连到了一个过旧的 Redis 实例。另外提醒：Docker 方式启动后，数据默认存在容器内部的可写层，容器被删除数据就会消失；要做数据持久化，请记得把宿主机目录挂载到容器内的 /data（详见下方常见误区）。

2-7 常见误区

误区：Windows 直接下个 exe 就能用。 旧教程里的 redis-windows 已停止维护，且版本陈旧；Windows 上请用 Docker / WSL2 / Memurai。
误区：Docker 跑 Redis 数据不会丢吗？ 默认 Docker 容器的数据在容器删除后消失。要做数据持久化，需把宿主机目录挂载到容器内的 /data（Redis 默认把 RDB/AOF 写在那里），例如加 -v $PWD/redis-data:/data。
误区：源码编译只要 make 就行。 Redis 8 由于内置大量模块，依赖显著增加；直接 make 在缺依赖的机器上会失败，务必先准备工具链。

2-8 安装方式速查与选型建议

面对多种安装方式，新手常纠结「到底该用哪个」。一张对照表帮你快速决定：

场景	推荐方式	理由
本地最快体验 / 写 Demo	Docker	一条命令、自带全部内置模块、不污染宿主系统
生产 Linux 服务器	官方 APT / RPM 源	版本更新及时、可用 systemd 托管、便于统一运维
macOS 开发机	Homebrew	与系统包管理一致，升级回滚方便
Windows 开发	Docker / WSL2	官方已不再发布原生 Windows 二进制
需要特定编译选项 / 追最新源码	源码编译	完全可控，但依赖重，日常几乎用不到

一个高频疑问是：「我到底要不要额外装那些扩展（JSON、向量集、概率类型）？」答案是不需要单独装。从 Redis 8 起，这些能力已经作为内置模块随官方发行包与 redis:latest 镜像一同提供，下载即用，无需 MODULE LOAD。只有当你仍停留在 7.x 或更早版本时，才需要按旧方式加载模块。

最后提醒：无论用哪种方式装好，第一要务都是验证服务可达（redis-cli PING 返回 PONG）并确认版本为 8.x；随后再通过 redis.conf 收紧 bind、protected-mode、requirepass 等安全项，不要先放任裸奔。

2-9 小结

想最快体验：一条 docker run -d --name redis -p 6379:6379 redis。
Linux 服务器：用官方 APT / RPM 源，并配合 systemctl 管理服务。
macOS：Homebrew 一键装。
Windows：Docker 或 WSL2。
需要最新版 / 自定义编译：从源码 make bootstrap && make。

提示：版本基线说明。本教程正文统一以 Redis 8.x（最新稳定版） 表述。需要留意：官方 redis.io 下载页目前把 8.8 标注为 “Latest stable”，而 GitHub 上 redis/redis 的最新发布标签为 8.10.0；二者同属 8.x 大版本，命令与数据类型差异极小，本教程以 8.10.0 为准。

装好之后，下一章我们学习如何启动、停止 Redis，以及如何修改 redis.conf 里的关键配置项。