💡 前言
本文专为零基础新手打造，不讲解复杂原理，只做实操落地，覆盖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%的日常开发、测试、小型项目需求。
本文持续更新，适合零基础收藏，全程实操可落地！
