03-Redis 安装指南:从版本选择到多系统部署(Windows+macOS+Linux)

发布于:2025-09-08 ⋅ 阅读:(34) ⋅ 点赞:(0)

引言

对于刚接触 Redis 的新手来说,“安装” 往往是第一个拦路虎 —— 选不对版本导致服务频繁崩溃、找错系统适配包导致安装失败、不清楚配置细节导致后续无法启动,这些问题都可能让学习热情大打折扣。其实,只要掌握 “版本选择逻辑 + 系统适配步骤”,Redis 安装就能轻松搞定。本文将从版本挑选讲起,手把手带你完成 Windows、macOS、Linux 三大系统的 Redis 安装,同时避开新手常踩的坑。

一、安装 Redis 前必须明确的核心问题

在动手安装前,先思考两个关键问题:选哪个版本?适配哪个系统?(不仅是安装 Redis 前需要简单思考,其他软件安装前也通用)

很多新手跳过这两步直接下载安装,结果出现 “Windows 版本长期不更新”“Linux 编译报错” 等问题。实际上,Redis 的版本选择直接影响稳定性,系统适配则决定安装能否顺利完成。比如生产环境用了开发版,可能因未修复的 BUG 导致数据丢失;Windows 用了官方未支持的包,会出现服务启动闪退的情况。因此,先理清版本和系统的适配逻辑,是安装成功的第一步。

二、Redis 版本选择:稳定版 vs 开发版,该怎么选?

Redis 的版本命名有明确规则,掌握这个规则,就能快速选出适合自己的版本。

2.1 版本规则:看 “次版本号” 辨稳定性

Redis 版本格式为 “主版本号.次版本号.修订号”(如 6.2.6、7.0.12),其中次版本号是判断稳定性的关键

  • 次版本号为偶数:稳定版(Stable Version),如 5.0、6.2、7.0,经过充分测试,BUG 少、运行稳定,官方推荐用于生产环境和日常学习。

  • 次版本号为奇数:开发版(Development Version),如 5.3、6.1、7.1,主要用于测试新功能(如多线程 IO、新数据结构),未经过全面验证,稳定性差,不适合正式场景。

2.2 稳定版与开发版核心差异

为了更直观区分,我们通过表格对比两类版本的关键维度:

对比维度 开发版(非稳定版) 稳定版(Stable Version)
BUG 数量 较多,存在未修复的潜在问题 极少,经过社区长期验证和迭代
稳定性 差,可能出现服务崩溃、数据异常 强,可长期稳定运行,支持高并发
功能完整性 含最新功能,但部分功能可能未完善 功能成熟,仅包含经过验证的特性
适用场景 新功能测试、技术验证、个人研究 生产环境、日常学习、开发测试项目

2.3 版本选择建议

  • 优先选稳定版:无论你是学习 Redis 基础,还是搭建开发测试环境,甚至部署生产服务,稳定版都是首选。推荐选择 6.2 或 7.0 版本,这两个版本支持主流核心功能(如 Redis Cluster、Stream 数据结构),且社区文档丰富,遇到问题容易找到解决方案。

  • 谨慎选开发版:仅当你需要测试 Redis 最新特性(如 Redis 7.1 的新命令优化),且能接受服务不稳定的风险时,才考虑开发版,且禁止在生产环境使用。

三、多系统安装教程:step-by-step 实操

Redis 对不同操作系统的支持程度不同:Linux 是官方推荐的生产环境系统,macOS 适合开发者本地学习,而 Windows 因官方不直接支持,需特殊处理。下面分系统详细讲解安装步骤。但是会重点介绍 Windows 系统下 Redis 的安装,对于初学者而言普遍使用 Windows 系统,可以先用该版本进行初步学习,之后转战其他平台。

3.1 Windows 系统安装(含官方限制说明)

(1)先明确:Windows 没有官方版本

Redis 官方仅提供 Linux/macOS 版本,不支持 Windows 系统。目前 Windows 上能运行的 Redis,是微软在 2016 年前后基于 Redis 3.2 版本编译的修改版,后续未再更新(最新版本为 3.2.100),功能相对老旧(不支持 Redis 5.0+ 的部分新特性)。
如果你的电脑是 Windows,且仅用于学习 Redis 基础(如命令操作、数据结构),可以使用该版本;若需学习集群、Stream 等新特性,建议通过 Docker 安装或改用 Linux 虚拟机。

(2)下载路径

微软编译的 Redis 版本归档在 GitHub 仓库,下载地址:https://github.com/microsoftarchive/redis/releases
进入页面后,拉到 “Assets” 部分,有两种安装包可选:

  • .msi 安装版:带图形化安装向导,适合新手,会自动配置部分环境变量。

  • .zip 解压版:无需安装,解压后即可使用,但需手动配置环境变量。

在这里插入图片描述

这里以新手友好的 .msi 安装版(Redis-x64-3.2.100.msi) 为例,讲解安装步骤。
在这里插入图片描述

(3)详细安装步骤

  1. 启动安装向导:双击下载的 Redis-x64-3.2.100.msi 文件,弹出 “Redis on Windows Setup” 欢迎界面,点击 “Next”。
    在这里插入图片描述

  2. 同意许可协议:勾选 “I accept the terms in the License Agreement”,点击 “Next”。
    在这里插入图片描述

  3. 选择安装路径与环境变量

    • 建议修改安装路径:默认安装在 C 盘,为避免后续权限问题,可将路径改为 D 盘(如 D:\Program Files\Redis)。

    • 必须勾选 “Add the Redis installation folder to the PATH environment variable”(将 Redis 路径添加到系统环境变量),这样后续在任意命令行窗口都能调用 Redis 命令,无需切换到安装目录。

    • 点击 “Next”。
      在这里插入图片描述

  4. 端口与防火墙设置

    • 端口默认 6379(Redis 官方约定端口,无需修改,避免与其他服务冲突)。

    • 勾选 “Add an exception to the Windows Firewall”(为 Redis 添加防火墙例外,允许外部连接),点击 “Next”。
      在这里插入图片描述

  5. 内存限制设置:默认限制 100MB 内存,学习阶段无需修改,点击 “Next”。

在这里插入图片描述

  1. 开始安装:点击 “Install”,等待 1-2 秒,安装完成后点击 “Finish”。
    在这里插入图片描述

在这里插入图片描述
在这里插入图片描述

注意: 安装完成后,在桌面不会产生图标,这是因为当前安装的是 Redis 服务

(4)安装后目录文件解读

安装完成后,进入 D:\Program Files\Redis 目录:
在这里插入图片描述

核心文件功能如下(新手需重点关注前 3 个):

文件名 功能说明
redis-server.exe Redis 服务器端主程序,启动 Redis 服务必须运行该文件
redis-cli.exe Redis 命令行客户端,用于连接 Redis 服务并执行命令(如 SET、GET)
redis.windows-service.conf 服务启动模式的配置文件(作为 Windows 服务运行时加载)
redis.windows.conf 普通启动模式的配置文件(双击 redis-server.exe 时默认加载)
redis-benchmark.exe Redis 性能测试工具,可模拟多客户端并发请求
redis-check-aof.exe AOF(Append Only File)持久化文件检查修复工具。
redis-check-rdb.exe RDB 持久化文件检查修复工具(在部分版本中可能名为 redis-check-dump.exe)。
redis-sentinel.exe Redis 哨兵(Sentinel)进程,用于管理多个 Redis 服务器,实现高可用性。

3.2 macOS 系统安装(官方推荐,适合开发者)

macOS 是 Redis 官方支持的系统,安装方式简单,推荐用 Homebrew(macOS 包管理工具)安装,步骤如下:

(1)先检查 Homebrew 是否安装

打开 “终端”,执行 brew -v 命令:

  • 若显示 Homebrew 4.x.x,说明已安装,直接进入下一步。

  • 若提示 “command not found”,需先安装 Homebrew,执行以下命令(需等待几分钟):

    /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
    

(2)安装 Redis

在终端执行以下命令,Homebrew 会自动下载并安装最新稳定版 Redis(如 7.0.12):

brew install redis

(3)验证安装

安装完成后,执行 redis-server --version 命令,若显示类似 Redis server v=7.0.12 sha=00000000:0 malloc=libc bits=64 build=xxxxxxx 的信息,说明安装成功。

(4)环境配置(可选,提升便捷性)

Homebrew 会自动将 Redis 命令路径(如 /usr/local/bin)添加到系统环境变量,一般无需额外配置。若执行 redis-cli 提示 “命令不存在”,可手动添加环境变量:

  1. 终端执行 open ~/.bash_profile(或 ~/.zshrc,取决于你用的 Shell)。

  2. 在文件末尾添加:export PATH="/usr/local/bin:$PATH"

  3. 保存文件后,执行 source ~/.bash_profile(或 source ~/.zshrc)使配置生效。

3.3 Linux 系统安装(生产环境首选,以 CentOS 为例)

Linux 是 Redis 官方推荐的生产环境系统,性能最优,支持所有特性。这里以 CentOS 7 为例,讲解两种安装方式:源码安装(适合需要最新版本)和 yum 安装(适合快速部署)。

(1)方式一:yum 安装(快速,适合新手)

yum 是 CentOS 自带的包管理工具,安装步骤简单,但版本可能略旧(一般是 5.0 或 6.2 稳定版):

  1. 终端执行以下命令,安装 Redis:

    sudo yum install redis -y
    
  2. 安装完成后,执行 redis --version 验证,显示版本信息即成功。

(2)方式二:源码安装(获取最新稳定版)

若需安装最新稳定版(如 7.2.4),需通过源码编译安装:

  1. 安装依赖工具:Redis 用 C 语言开发,需先安装编译工具 gcc:

    sudo yum install gcc -y
    
  2. 下载源码包:进入 Redis 官网下载页,复制最新稳定版的源码包链接(如 https://download.redis.io/releases/redis-7.2.4.tar.gz),在终端执行:

    wget https://download.redis.io/releases/redis-7.2.4.tar.gz
    
  3. 解压源码包

    tar -zxvf redis-7.2.4.tar.gz
    
  4. 编译与安装

    cd redis-7.2.4  # 进入解压目录
    make  # 编译(需等待 1-2 分钟,确保 gcc 已安装)
    sudo make install  # 安装到系统目录(默认路径 /usr/local/bin)
    
  5. 验证安装:执行 redis-server --version,显示版本信息即成功。

(3)启动 Redis 服务(Linux 通用)

无论哪种安装方式,都可通过以下命令启动 Redis 服务:

# 前台启动(终端关闭则服务停止,适合测试)
redis-server
# 后台启动(生产推荐,需先修改配置文件)
# 1. 找到 redis.conf 配置文件(yum 安装默认在 /etc/redis.conf,源码安装在解压目录)
# 2. 将 daemonize no 改为 daemonize yes(允许后台运行)
# 3. 执行后台启动命令:
redis-server /etc/redis.conf

四、安装避坑指南:新手常踩的 5 个坑及解决方案

安装过程中,新手容易遇到各种问题,这里整理了 5 个高频坑点及解决方法,帮你快速排障。

4.1 坑 1:Windows 安装后双击 redis-server.exe 闪退

原因:Redis 服务已通过 Windows 服务启动(安装时默认自动启动),再次双击启动会因端口冲突闪退。
解决方案

  1. 右键点击 “此电脑”→“管理”→“服务和应用程序”→“服务”。

  2. 在服务列表中找到 “Redis”,查看 “状态”:若显示 “正在运行”,右键选择 “停止”。

  3. 再次双击 redis-server.exe,即可正常启动(终端窗口显示 Redis 启动信息,不闪退)。

4.2 坑 2:macOS/Linux 执行 redis-cli 提示 “command not found”

原因:Redis 命令路径未添加到系统环境变量,终端无法找到命令。
解决方案

  • macOS:执行 echo 'export PATH="/usr/local/bin:$PATH"' >> ~/.zshrc(或 .bash_profile),再执行 source ~/.zshrc

  • Linux:执行 echo 'export PATH="/usr/local/bin:$PATH"' >> ~/.bashrc,再执行 source ~/.bashrc

  • 验证:执行 redis-cli -v,显示版本信息即修复成功。

4.3 坑 3:Linux 源码安装执行 make 报错 “gcc: command not found”

原因:系统未安装 C 语言编译工具 gcc,导致无法编译 Redis 源码。
解决方案:安装 gcc 工具:

  • CentOS/RHEL:sudo yum install gcc -y

  • Ubuntu/Debian:sudo apt-get install gcc -y
    安装完成后,重新执行 make 即可。

4.4 坑 4:安装路径含中文 / 空格,导致服务启动失败

原因:Redis 对路径中的特殊字符敏感,中文或空格会导致配置文件加载失败。
解决方案

  • 安装时选择纯英文、无空格的路径,如 Windows 选 D:\Program Files\Redis(而非 D:\Redis 安装),Linux/macOS 选 /usr/local/redis

  • 若已安装到错误路径,需卸载后重新安装(Windows 可通过 “控制面板→卸载程序” 卸载,Linux 源码安装需删除 /usr/local/bin 下的 Redis 命令文件)。

4.5 坑 5:未勾选 PATH 环境变量,每次需切换到安装目录执行命令

原因:Windows 安装时未勾选 “Add to PATH”,或 macOS/Linux 未配置环境变量,导致终端无法全局调用 Redis 命令。
解决方案

  • Windows:手动添加环境变量:

    1. 右键 “此电脑”→“属性”→“高级系统设置”→“环境变量”。

    2. 在 “系统变量” 中找到 “Path”,点击 “编辑”→“新建”,添加 Redis 安装路径(如 D:\Program Files\Redis)。

    3. 点击 “确定”,关闭所有终端后重新打开,即可全局执行 redis-cli 命令。

  • macOS/Linux:参考 “坑 2” 的解决方案,配置环境变量。

五、总结:安装完成后的下一步

当你能成功执行 redis-cli ping 并收到 PONG 回复时,说明 Redis 已安装并启动成功。接下来,你可以:

  1. 学习 Redis 命令行客户端(redis-cli)的使用,比如执行 SET name "redis"GET name 等基础命令。

  2. 了解 Redis 服务的启停方式(如 Windows 服务管理、Linux 后台启动),为后续学习奠定基础。

  3. 若需学习新特性(如 Redis Cluster),Windows 用户建议改用 Docker 或 Linux 虚拟机,避免因旧版本受限。

安装是 Redis 学习的第一步,选对版本、避开坑点,才能让后续的学习更顺畅。


网站公告

今日签到

点亮在社区的每一天
去签到