前言本文专为零基础新手打造不讲解复杂原理只做实操落地覆盖Windows、macOS、CentOS、Ubuntu四大主流操作系统手把手教你完成Redis单服务完整安装、启动、开机自启、服务验证及基础配置。全程复制命令即可执行解决新手安装报错、服务启动失败、无法开机自启等常见问题。本次安装为单节点服务日常开发、本地测试、小型项目通用非集群模式满足90%以上个人开发和小型部署场景。 核心参数全系统统一默认端口6379默认状态无密码、仅本地回环访问一、Windows系统安装RedisWin10/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:\Redis2将压缩包完整解压至该目录核心文件说明redis-server.exeRedis服务端程序redis-cli.exeRedis客户端连接工具3、临时启动服务仅测试用直接双击redis-server.exe启动服务窗口输出6379端口即启动成功。⚠️弊端关闭CMD窗口服务即终止仅适合临时测试。4、安装系统服务后台运行开机自启1以管理员身份打开CMD命令行2切换至Redis解压目录# 切换D盘D:# 进入Redis安装目录cd D:\Redis3执行服务安装命令redis-server --service-install redis.windows.conf --loglevel verbose看到Service successfully installed即为安装成功。5、服务启停命令# 启动服务redis-server --service-start# 停止服务redis-server --service-stop# 重启服务redis-server --service-restart6、验证安装成功# 进入Redis客户端redis-cli# 测试连通性ping返回PONG说明服务正常运行。方式二WSL子系统安装官方标准版推荐开发使用如需和Linux官方版本完全一致可使用Windows WSL子系统安装原生Redis1管理员CMD安装WSL子系统wsl --install安装完成重启电脑打开Ubuntu终端执行安装命令sudo apt updatesudo 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、一键安装Redisbrew install redis3、服务管理启动/停止/自启# 启动Redis服务brew services start redis# 停止Redis服务brew services stop redis# 重启Redis服务brew services restart redis4、验证服务可用性# 连接客户端redis-cli# 连通性测试ping返回PONG即安装成功。三、Linux系统安装RedisUbuntu/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-server2、CentOS / RHEL / Fedora 系列# CentOS7 及以下版本sudo yum install epel-release -ysudo 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 # Ubuntusudo 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、编译安装makemake install# 6、守护进程后台启动redis-server --daemonize yesLinux通用验证命令redis-cliping返回PONG代表服务正常运行。四、全系统通用基础配置新手必调Redis默认无密码、仅本地访问开发环境建议简单配置提升安全性和实用性。1、设置访问密码进入Redis客户端后执行以下命令自定义密码# 设置密码为123456自行修改config set requirepass 123456# 密码登录验证auth 123456重启服务后密码永久生效。2、开启远程访问内网/跨机器访问必备打开redis.conf配置文件修改两处核心配置1注释本地回环限制# bind 127.0.0.1允许所有IP访问2关闭保护模式protected-mode no3重启Redis服务即可生效五、常见报错问题排查零基础专属1、6379端口占用启动失败Windows CMDnetstat -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%的日常开发、测试、小型项目需求。本文持续更新适合零基础收藏全程实操可落地
前言本文专为零基础新手打造不讲解复杂原理只做实操落地覆盖Windows、macOS、CentOS、Ubuntu四大主流操作系统手把手教你完成Redis单服务完整安装、启动、开机自启、服务验证及基础配置。全程复制命令即可执行解决新手安装报错、服务启动失败、无法开机自启等常见问题。本次安装为单节点服务日常开发、本地测试、小型项目通用非集群模式满足90%以上个人开发和小型部署场景。 核心参数全系统统一默认端口6379默认状态无密码、仅本地回环访问一、Windows系统安装RedisWin10/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:\Redis2将压缩包完整解压至该目录核心文件说明redis-server.exeRedis服务端程序redis-cli.exeRedis客户端连接工具3、临时启动服务仅测试用直接双击redis-server.exe启动服务窗口输出6379端口即启动成功。⚠️弊端关闭CMD窗口服务即终止仅适合临时测试。4、安装系统服务后台运行开机自启1以管理员身份打开CMD命令行2切换至Redis解压目录# 切换D盘D:# 进入Redis安装目录cd D:\Redis3执行服务安装命令redis-server --service-install redis.windows.conf --loglevel verbose看到Service successfully installed即为安装成功。5、服务启停命令# 启动服务redis-server --service-start# 停止服务redis-server --service-stop# 重启服务redis-server --service-restart6、验证安装成功# 进入Redis客户端redis-cli# 测试连通性ping返回PONG说明服务正常运行。方式二WSL子系统安装官方标准版推荐开发使用如需和Linux官方版本完全一致可使用Windows WSL子系统安装原生Redis1管理员CMD安装WSL子系统wsl --install安装完成重启电脑打开Ubuntu终端执行安装命令sudo apt updatesudo 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、一键安装Redisbrew install redis3、服务管理启动/停止/自启# 启动Redis服务brew services start redis# 停止Redis服务brew services stop redis# 重启Redis服务brew services restart redis4、验证服务可用性# 连接客户端redis-cli# 连通性测试ping返回PONG即安装成功。三、Linux系统安装RedisUbuntu/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-server2、CentOS / RHEL / Fedora 系列# CentOS7 及以下版本sudo yum install epel-release -ysudo 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 # Ubuntusudo 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、编译安装makemake install# 6、守护进程后台启动redis-server --daemonize yesLinux通用验证命令redis-cliping返回PONG代表服务正常运行。四、全系统通用基础配置新手必调Redis默认无密码、仅本地访问开发环境建议简单配置提升安全性和实用性。1、设置访问密码进入Redis客户端后执行以下命令自定义密码# 设置密码为123456自行修改config set requirepass 123456# 密码登录验证auth 123456重启服务后密码永久生效。2、开启远程访问内网/跨机器访问必备打开redis.conf配置文件修改两处核心配置1注释本地回环限制# bind 127.0.0.1允许所有IP访问2关闭保护模式protected-mode no3重启Redis服务即可生效五、常见报错问题排查零基础专属1、6379端口占用启动失败Windows CMDnetstat -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%的日常开发、测试、小型项目需求。本文持续更新适合零基础收藏全程实操可落地
