Redis · 内存数据结构存储与缓存/向量引擎｜部署、构建与使用全指南

项目仓库： https://github.com/redis/redis

开源协议：RSAL/SSPL（见仓库 LICENSE） · 默认端口：6379 · 快速开始：docker run -d -p 6379:6379 redis:latest · 从源码构建：make bootstrap && make · 官方文档：redis.io/docs

本指南适用于 Redis 8.10+；旧版本构建方式见对应分支 README。

1 项目简介

Redis 是面向实时数据驱动应用的首选内存数据存储，同时承担缓存、数据结构服务器、文档与向量查询引擎角色。数据主要驻留内存，采用高效数据结构，读写延迟常达亚毫秒级。它内置丰富数据类型与模块 API，可扩展出新命令。

1.1 核心信息一览

项目项	内容
项目名称	Redis
仓库地址	github.com/redis/redis
项目定位	内存数据结构存储 / 缓存 / 向量引擎
默认端口	6379
Docker 快速开始	`docker run -d -p 6379:6379 redis:latest`
从源码构建	`make bootstrap` 后 `make`
官方文档	redis.io/docs

1.2 适用场景

缓存、会话存储、排行榜、限流。
实时消息（Pub/Sub、Stream）。
向量检索、RAG、全文与地理空间查询（Redis Search）。

1.3 能力边界（官方口径）

构建完整数据结构（JSON、时序、Bloom、Cuckoo、t-digest、Query Engine）需 LLVM 21、CMake 3.25–3.31.6、Rust 1.94。
CMake 4.x 不支持，需 pin 到 3.25–3.31.6。

2 功能特性

性能：内存存储 + 高效数据结构，亚毫秒延迟。
丰富数据类型：String/Hash/List/Set/Sorted Set/JSON/Vector Set/Geospatial/Bitmap/Stream/Pub-Sub。
可扩展：模块 API 扩展新命令。
Redis Insight：可视化管理工具，内置 Copilot。

3 官方跳转链接汇总

类别	链接	说明
仓库主页	https://github.com/redis/redis	源码
Docker 镜像	hub.docker.com/_/redis	官方镜像
快速开始	redis.io/docs/get-started	入门
客户端库	clients	各语言客户端
Redis Cloud	cloud.redis.io	托管服务

4 方式一：Docker 快速启动

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

5 方式二：二进制发行版

6 方式三：从源码构建（Redis 8.10+）

# A) 发布 tarball（推荐）
wget https://github.com/redis/redis/releases/download/<version>/redis-full-<version>.tar.gz
tar xvf redis-full-<version>.tar.gz && cd redis-<version>

# B) git checkout
git clone https://github.com/redis/redis.git && cd redis
make modules-update

# 安装依赖并构建（自动检测 OS 安装 LLVM/CMake/Rust 等）
make bootstrap
make

运行：

# 发布 tarball：
./src/redis-server redis.conf

# git checkout：模块配置在 auto-generated redis-full.conf
./src/redis-server redis-full.conf

7 连接与验证

# 启动 redis-server 后，另一终端：
cd src
./redis-cli

redis> ping
PONG
redis> set foo bar
OK
redis> get foo
"bar"

8 构建依赖（完整模块）

依赖	版本要求
GCC/Clang	构建工具链
LLVM	21
CMake	3.25–3.31.6（4.x 不支持）
Rust	1.94
OpenSSL / Python 3	必需

9 常见问题

CMake 4.x 构建失败：pin 到 cmake==3.31.6（如 pip3 install 'cmake==3.31.6'）。
git checkout 找不到模块配置：运行 make modules-update，用 redis-full.conf 启动。
想可视化：用 Redis Insight。

10 风险与说明

许可证：以仓库 LICENSE 为准（RSAL/SSPL）。
内存管理：生产注意 maxmemory 策略与持久化。
非官方声明：本文基于官方仓库 README 整理，命令以最新 release 为准。

Redis：内存数据结构存储与缓存/向量引擎｜部署、构建与使用全指南