💡 前言

本文专为零基础新手打造，不讲解复杂原理，只做实操落地，覆盖Windows、macOS、CentOS、Ubuntu四大主流操作系统，手把手教你完成Redis单服务完整安装、启动、开机自启、服务验证及基础配置。全程复制命令即可执行，解决新手安装报错、服务启动失败、无法开机自启等常见问题。

本次安装为单节点服务（日常开发、本地测试、小型项目通用），非集群模式，满足90%以上个人开发和小型部署场景。

🔥 核心参数（全系统统一）

默认端口：6379

默认状态：无密码、仅本地回环访问

一、Windows系统安装Redis（Win10/Win11通用）

⚠️ 重要生产环境提醒

Redis官方无Windows原生版本，目前社区适配的Windows移植版最高稳定版本仅为Redis 5.0.14.1。该版本老旧、缺失大量新特性、IO性能差、无官方维护、存在安全漏洞。

✅ 可用场景：本地开发、学习测试、个人demo调试

❌ 禁止场景：所有生产环境、线上项目、正式服务器部署

生产环境请务必使用 Linux 系统部署官方原版Redis。

方式一：绿色免安装版（新手首选）

1、下载安装包

适配Windows的社区稳定版下载地址：

https://github.com/tporadowski/redis/releases

页面下拉，选择最新稳定版，下载 Redis-x64-xxx.zip 压缩包（64位系统通用）。

2、解压部署

1）本地新建纯英文无空格文件夹，推荐路径：D:\Redis

2）将压缩包完整解压至该目录，核心文件说明：

redis-server.exe：Redis服务端程序

redis-cli.exe：Redis客户端连接工具

3、临时启动服务（仅测试用）

直接双击 redis-server.exe 启动服务，窗口输出6379端口即启动成功。

⚠️ 弊端：关闭CMD窗口服务即终止，仅适合临时测试。

4、安装系统服务（后台运行+开机自启）

1）以管理员身份打开CMD命令行

2）切换至Redis解压目录

# 切换D盘

D:

# 进入Redis安装目录

cd D:\Redis

3）执行服务安装命令

redis-server --service-install redis.windows.conf --loglevel verbose

看到 Service successfully installed 即为安装成功。

5、服务启停命令

# 启动服务

redis-server --service-start

# 停止服务

redis-server --service-stop

# 重启服务

redis-server --service-restart

6、验证安装成功

# 进入Redis客户端

redis-cli

# 测试连通性

ping

返回 PONG 说明服务正常运行。

方式二：WSL子系统安装（官方标准版，推荐开发使用）

如需和Linux官方版本完全一致，可使用Windows WSL子系统安装原生Redis：

1）管理员CMD安装WSL子系统

wsl --install

安装完成重启电脑，打开Ubuntu终端执行安装命令：

sudo apt update

sudo apt install redis-server -y

启动、验证方式与Ubuntu系统完全一致。

二、macOS系统安装Redis（全版本通用）

Mac环境优先使用 Homebrew 包管理器安装，一键部署、自动配置环境变量、支持开机自启，零编译报错。

1、安装Homebrew（首次安装必备）

打开终端，执行官方安装脚本：

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

验证安装：

输入 brew -v 输出版本号即为成功。

2、一键安装Redis

brew install redis

3、服务管理（启动/停止/自启）

# 启动Redis服务

brew services start redis

# 停止Redis服务

brew services stop redis

# 重启Redis服务

brew services restart redis

4、验证服务可用性

# 连接客户端

redis-cli

# 连通性测试

ping

返回 PONG 即安装成功。

三、Linux系统安装Redis（Ubuntu/CentOS通用）

Linux为Redis官方原生支持平台，生产环境首选，提供两种安装方式：软件源快速安装（新手）、源码编译安装（最新版）。

方式一：软件源一键安装（稳定、简单、推荐新手）

1、Ubuntu / Debian 系列

# 更新软件源缓存

sudo apt update

# 安装Redis服务

sudo apt install redis-server -y

# 启动服务

sudo systemctl start redis-server

# 设置开机自启

sudo systemctl enable redis-server

# 查看服务运行状态

sudo systemctl status redis-server

2、CentOS / RHEL / Fedora 系列

# CentOS7 及以下版本

sudo yum install epel-release -y

sudo yum install redis -y

# CentOS8/9 / Fedora 版本

sudo dnf install redis -y

# 启动服务

sudo systemctl start redis

# 开机自启

sudo systemctl enable redis

# 查看服务状态

sudo systemctl status redis

方式二：源码编译安装（获取最新官方版本，生产推荐）

适合需要最新特性、自定义编译参数、高标准生产环境的场景，全Linux通用：

# 1、安装编译依赖

sudo apt install build-essential -y   # Ubuntu

sudo yum install gcc make -y   # CentOS

# 2、下载官方最新稳定源码包

wget https://download.redis.io/redis-stable.tar.gz

# 3、解压源码包

tar -xzvf redis-stable.tar.gz

# 4、进入编译目录

cd redis-stable

# 5、编译&安装

make

make install

# 6、守护进程后台启动

redis-server --daemonize yes

Linux通用验证命令

redis-cli

ping

返回 PONG 代表服务正常运行。

四、全系统通用基础配置（新手必调）

Redis默认无密码、仅本地访问，开发环境建议简单配置，提升安全性和实用性。

1、设置访问密码

进入Redis客户端后执行以下命令（自定义密码）：

# 设置密码为123456（自行修改）

config set requirepass 123456

# 密码登录验证

auth 123456

重启服务后密码永久生效。

2、开启远程访问（内网/跨机器访问必备）

打开 redis.conf 配置文件，修改两处核心配置：

1）注释本地回环限制：# bind 127.0.0.1，允许所有IP访问

2）关闭保护模式：protected-mode no

3）重启Redis服务即可生效

五、常见报错&问题排查（零基础专属）

1、6379端口占用，启动失败

Windows CMD：

netstat -ano|findstr 6379

根据PID结束对应进程即可。

Linux / macOS 终端：

kill -9 $(lsof -i:6379 -t)

2、客户端连接失败

排查顺序：服务是否启动 → 防火墙是否放行6379端口 → 是否开启远程访问 → 密码是否正确

3、开机自启不生效

Windows：必须以管理员身份执行服务安装命令

Linux/macOS：重新执行开机自启命令，重启设备测试

六、总结

1、✅ 本地开发测试：Windows绿色版、macOS Homebrew、Ubuntu apt安装，简单零报错；

2、✅ 生产环境部署：仅使用Linux系统源码/官方源安装原生Redis，严禁使用Windows移植版；

3、✅ 通用验证方式：所有系统均可通过 redis-cli + ping 快速校验服务状态；

4、✅ 新手建议：单节点默认配置可满足90%的日常开发、测试、小型项目需求。

本文持续更新，适合零基础收藏，全程实操可落地！