Skip to content

第二章 快速安装与启动


2.1 Linux / macOS 安装(源码编译与包管理器)

概念

在 Linux 和 macOS 上,Redis 是一等公民:官方长期维护,安装方式成熟。你可以用包管理器快速安装(适合学习与日常开发),也可以用源码编译获得指定版本或自定义编译选项。

┌─────────────────────────────────────────────┐
│           你的开发机(Linux / macOS)          │
│                                             │
│   方式 A:apt / yum / brew  →  系统服务      │
│   方式 B:源码 make install →  自定义路径    │
│                                             │
│              都指向同一个 redis-server       │
└─────────────────────────────────────────────┘

操作

Ubuntu / Debian(apt)

bash
sudo apt update
sudo apt install redis-server -y
sudo systemctl enable redis-server
sudo systemctl start redis-server
sudo systemctl status redis-server

CentOS / RHEL(yum / dnf)

CentOS 7 及类似发行版常用 yum,较新版本用 dnf

bash
# CentOS 7 示例(需 EPEL 源时先安装 epel-release)
sudo yum install epel-release -y
sudo yum install redis -y
sudo systemctl enable redis
sudo systemctl start redis
sudo systemctl status redis
bash
# Fedora / 新版 RHEL 等(dnf)
sudo dnf install redis -y
sudo systemctl enable redis
sudo systemctl start redis

macOS(Homebrew)

bash
brew install redis
brew services start redis   # 开机自启 + 后台运行
# 或仅当前会话前台运行:redis-server /opt/homebrew/etc/redis.conf

源码编译(通用思路)

适合需要固定主版本或学习编译流程时使用。

操作步骤概要

  1. 安装编译依赖(如 gccmake;Debian 系可装 build-essential)。
  2. 下载源码包、解压、进入目录。
  3. 执行 make,再 sudo make install(或指定 PREFIX)。

示例(版本号请到 https://redis.io/download 核对最新稳定版):

bash
cd /tmp
wget https://download.redis.io/redis-stable.tar.gz
tar xzf redis-stable.tar.gz
cd redis-stable
make
sudo make install    # 默认可把 redis-server、redis-cli 装到 /usr/local/bin

编译完成后,可用 redis-server 启动(可配合自定义 redis.conf)。

示例:确认服务已监听

bash
redis-cli PING
# 期望输出:PONG

若包管理器安装的 Redis 未自动监听本机,请检查配置文件中的 bindprotected-mode,并确认防火墙未阻断默认端口 6379


2.2 Windows 安装(WSL / Docker)

概念

Redis 官方不提供 Windows 原生服务端支持(不再有官方 Windows 版安装包)。在 Windows 上学习或开发,推荐两条路:

┌──────────────────────────────────────────────┐
│                  Windows 电脑                 │
│                                              │
│   路径 1:WSL2(Linux 子系统)→ 按 2.1 安装    │
│   路径 2:Docker Desktop → Linux 容器跑 Redis │
│                                              │
│   两者都是在「Linux 环境」里跑官方 Redis       │
└──────────────────────────────────────────────┘

操作:WSL2 安装 Redis

  1. 在微软文档中启用 WSL2,并安装一个 Linux 发行版(如 Ubuntu)。
  2. 打开 WSL 终端,按 2.1 节 Ubuntu 的方式安装 redis-server
  3. 在 Windows 上用 redis-cli 连接时,主机名填 WSL 的 IPlocalhost(视 WSL 网络版本与端口转发而定);若连不上,可在 WSL 内先用 redis-cli 验证服务正常。

示例(在 WSL 内):

bash
sudo apt update && sudo apt install redis-server -y
sudo service redis-server start
redis-cli PING

操作:Docker Desktop

  1. 安装 Docker Desktop for Windows 并确保已启动。
  2. 使用 2.3 节docker run 命令一键启动 Redis(推荐)。

这样无需在 WSL 里单独维护 redis-server 系统服务,版本切换也更方便。


2.3 Docker 一键启动(推荐)

概念

Docker 在本地起一个 Linux 容器,里面跑官方 redis 镜像。你只要映射端口、(可选)挂载数据卷,就能在几分钟内得到与生产环境接近的运行方式。

  你的电脑                    Docker 容器
┌─────────────┐            ┌─────────────────┐
│ redis-cli   │──6379──────│  redis-server   │
│ 或应用代码   │            │  (redis:7-alpine)│
└─────────────┘            │  + 数据卷(可选)   │
                             └─────────────────┘

操作

在已安装 Docker 的机器上执行(一行即可跑起来):

bash
docker run -d \
  --name my-redis \
  -p 6379:6379 \
  -v redis-data:/data \
  redis:7-alpine \
  redis-server --appendonly yes

参数说明

参数 / 片段含义
-d后台运行容器
--name my-redis容器名,方便 docker stop / docker start
-p 6379:6379把宿主机 6379 映射到容器内 6379
-v redis-data:/data命名卷持久化数据(镜像默认数据目录常为 /data
redis:7-alpine官方镜像,7.x + Alpine 体积小
redis-server --appendonly yes容器启动命令:开启 AOF,重启少丢数据

示例:进入 redis-cli

bash
docker exec -it my-redis redis-cli

在提示符下输入 PING,应得到 PONG。输入 exit 退出客户端(容器仍在运行)。

常用维护命令

bash
docker ps                    # 查看运行中的容器
docker stop my-redis         # 停止
docker start my-redis        # 再次启动
docker logs my-redis         # 查看日志

2.4 连接 Redis:redis-cli 基本操作

概念

redis-cli 是官方命令行客户端。连上服务器后,你发送的是 Redis 命令(文本协议),服务器返回结果。先掌握几条命令,就能验证安装并理解「键值存储」。

  redis-cli                Redis Server
     │                          │
     │  PING / SET / GET ...    │
     ├─────────────────────────→│
     │←─────────────────────────┤
     │  PONG / OK / value ...    │

操作

命令作用
PING健康检查,正常返回 PONG
SET key value设置字符串键值
GET key读取键对应的值
DEL key [key ...]删除一个或多个键
KEYS pattern按模式列出键名(生产慎用,见下)

连接方式:

  • 本机默认:redis-cli
  • 指定主机与端口:redis-cli -h 127.0.0.1 -p 6379
  • 有密码时:redis-cli -a yourpassword(注意脚本与历史记录泄露风险,生产建议用环境变量或配置文件)

示例:完整终端交互

text
$ redis-cli
127.0.0.1:6379> PING
PONG
127.0.0.1:6379> SET tutorial:chapter "2"
OK
127.0.0.1:6379> GET tutorial:chapter
"2"
127.0.0.1:6379> SET tutorial:author "beginner"
OK
127.0.0.1:6379> KEYS tutorial:*
1) "tutorial:chapter"
2) "tutorial:author"
127.0.0.1:6379> DEL tutorial:author
(integer) 1
127.0.0.1:6379> GET tutorial:author
(nil)
127.0.0.1:6379> exit

重要提醒:KEYSSCAN

  • KEYS *(或任意模式)会遍历整个键空间,键很多时会阻塞 Redis,影响所有客户端。
  • 学习、本地空库KEYS 没问题;生产环境应使用 SCAN 命令渐进式迭代键,避免长时间阻塞。

后续章节会单独演示 SCAN 的用法;现在你只要记住:不要在生产对大库执行 KEYS *


2.5 可视化工具推荐(RedisInsight / Another Redis Desktop Manager)

概念

图形化工具适合:浏览键、查看内存与统计、执行命令、分析慢查询。它们连的还是同一个 Redis 协议(默认 6379),只是多了一个「桌面或 Web 界面」。

┌──────────────┐     TCP/6379      ┌──────────────┐
│ RedisInsight │ ────────────────→ │ Redis Server │
│ 或 ARDM 等    │                   │              │
└──────────────┘                   └──────────────┘

操作与配置要点

RedisInsight(官方)

  • 定位:Redis 官方出品的可视化管理与监控工具(有桌面版与一定部署方式,以官网说明为准)。
  • 连接配置:Host 填 127.0.0.1(本机)或服务器 IP;Port 6379;若启用 ACL/密码,在连接表单中填写用户名、密码。
  • 适用:希望与官方生态一致、需要监控与多实例管理的场景。

官网:https://redis.io/insight/

Another Redis Desktop Manager(ARDM)

  • 定位:开源跨平台桌面客户端,轻量连接、浏览键、执行命令。
  • 连接配置:同样填写 主机 + 6379 + 密码(如有);Docker 或 WSL 时注意「能访问到 Redis 的那张网卡」的 IP。
  • 适用:快速看键值、本地开发调试。

小提示:无论用哪种 GUI,底层命令与权限与 redis-cli 一致;不要在生产环境把无密码的 Redis 暴露在公网。


本章小结

知识点要点
Linux / macOSapt / yum(dnf) / brew 快速安装;源码适合固定版本与定制
Windows无官方原生服务端;用 WSL2Docker 跑 Linux 版 Redis
Docker 推荐docker run -d --name -p -v redis:7-alpinedocker exec -it … redis-cli 进入命令行
redis-cli 入门PING / SET / GET / DELKEYS 仅适合本地学习,生产用 SCAN
可视化RedisInsight(官方)、Another Redis Desktop Manager 等;连接 主机:6379 + 认证信息

下一章预告:系统学习 Redis 的数据类型(字符串、列表、哈希、集合、有序集合)——用对的结构解决问题,而不仅是 SET / GET

坚持是一种品格