在 Windows 系统上安装 Redis 主要有两种方式:手动解压安装包(推荐开发者)和通过 Chocolatey 包管理器(适合快速安装)。以下是详细步骤(以 Redis 7.0+ 版本为例,兼容 Windows 10/11):
一、准备工作
系统要求:Windows 10 1903+ 或 Windows 11(64 位)。
下载地址:
Microsoft 维护的 Redis Windows 分支(官方推荐):GitHub - MicrosoftArchive/redis(选择最新稳定版,如 redis-7.2.4-win64.zip)。
https://github.com/microsoftarchive/redis/releases
二、手动解压安装(推荐)
步骤 1:下载并解压 Redis
访问 GitHub 发布页,找到最新版本(如 redis-7.2.4-win64.zip),点击下载。
解压到任意目录(建议路径无中文,例如 D:\Redis)。
步骤 2:配置 Redis(关键)
解压后的目录包含以下核心文件:
redis-server.exe:Redis 服务端程序。
redis-cli.exe:Redis 命令行客户端。
redis.windows.conf:Windows 专用配置文件(需重点修改)。
修改配置文件redis.windows.conf(用记事本或 VS Code 打开):
# 绑定监听 IP(默认 127.0.0.1,仅本地访问;若需远程访问改为 0.0.0.0,但不安全!) bind 127.0.0.1 # 监听端口(默认 6379,若被占用可修改为其他端口如 6380) port 6379 # 启用密码认证(生产环境必改,本地开发可选) requirepass your_redis_password # 替换为你的密码(如 "123456") # 持久化配置(根据需求选择 RDB 或 AOF) # RDB 快照(默认开启) save 900 1 # 900秒内至少1次写操作,生成快照 save 300 10 # 300秒内至少10次写操作,生成快照 save 60 10000 # 60秒内至少10000次写操作,生成快照 dir D:\Redis\data # 快照存储路径(需提前创建 data 目录) dbfilename dump.rdb # 快照文件名 # AOF 日志(可选,比 RDB 更安全) appendonly yes # 开启 AOF appendfsync everysec # 每秒同步一次(平衡性能与安全) # 其他优化(可选) maxmemory 2gb # 最大内存限制(根据机器内存调整) maxmemory-policy allkeys-lru # 内存不足时淘汰策略(LRU 算法)步骤 3:创建数据存储目录
在 Redis 安装目录下创建 data文件夹(与配置文件中的 dir路径一致),用于存储持久化文件(如 dump.rdb)。
步骤 4:启动 Redis 服务端
打开命令提示符(CMD)或 PowerShell,进入 Redis 安装目录:
cd D:\Redis
运行项目并下载源码
启动 Redis 服务端(临时启动,关闭窗口即停止):
redis-server.exe redis.windows.conf
运行项目并下载源码
成功启动后,控制台会输出:
[info] Server started, Redis version 7.2.4 [info] Listening on port 6379
步骤 5:安装为 Windows 服务(推荐)
临时启动的 Redis 会在关闭 CMD 窗口后停止,建议安装为系统服务,实现开机自启:
以管理员身份打开 CMD(右键「以管理员身份运行」)。
执行以下命令安装服务(替换 D:\Redis为你的安装路径):
D:\Redis\redis-server.exe --service-install D:\Redis\redis.windows.conf --loglevel verbose
输出 The service 'Redis' has been installed.表示安装成功。
启动服务:
net start Redis # 或通过「服务管理器」(services.msc)找到 Redis 服务并启动
步骤 6:验证 Redis 是否正常工作
打开另一个 CMD 窗口,使用 redis-cli连接 Redis:
D:\Redis\redis-cli.exe -h 127.0.0.1 -p 6379 -a your_redis_password
若提示 OK,表示连接成功。
执行简单命令测试:
127.0.0.1:6379> ping # 应返回 PONG 127.0.0.1:6379> set name "张三" # 存储键值对 OK 127.0.0.1:6379> get name # 获取值 "张三"
三、通过 Chocolatey 安装(快速方式)
若已安装 Chocolatey(Windows 包管理器),可通过以下命令快速安装:
步骤 1:安装 Chocolatey
以管理员身份打开 CMD,执行:
@"%SystemRoot%\System32\WindowsPowerShell\v1.0\powershell.exe" -NoProfile -InputFormat None -ExecutionPolicy Bypass -Command "iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))" && SET "PATH=%PATH%;%ALLUSERSPROFILE%\chocolatey\bin"
步骤 2:安装 Redis
choco install redis-64 # 安装最新稳定版(可能版本略旧)
步骤 3:配置与服务管理
配置文件路径:C:\ProgramData\chocolatey\lib\redis-64\tools\redis.windows.conf(需管理员权限修改)。
启动服务:
net start Redis # 或通过 services.msc 管理
四、常见问题与解决
问题 1:启动失败,提示「端口被占用」
原因:6379 端口被其他程序(如其他 Redis 实例、数据库工具)占用。
解决:
查看端口占用进程:
netstat -ano | findstr :6379
终止占用进程(替换 1234为实际 PID):
taskkill /F /PID 1234
修改 Redis 配置文件中的 port为其他端口(如 6380)。
问题 2:连接失败,提示「NOAUTH Authentication required」
原因:配置了密码但未在连接时指定。
解决:使用 -a参数传入密码:
redis-cli.exe -h 127.0.0.1 -p 6379 -a your_redis_password
问题 3:服务安装失败
原因:路径包含空格或特殊字符,或权限不足。
解决:
将 Redis 安装到无空格的路径(如 D:\Redis)。
以管理员身份执行安装命令。
问题 4:持久化文件未生成
原因:配置文件中的 dir路径不存在,或权限不足。
解决:
手动创建 data目录(如 D:\Redis\data)。
确保 Redis 服务有写入该目录的权限(右键目录 → 属性 → 安全 → 添加 Everyone并赋予写入权限)。
总结
Windows 安装 Redis 的核心步骤是:下载解压 → 配置 redis.windows.conf→ 启动服务(或安装为系统服务)→ 验证连接。通过手动配置可灵活调整参数,而 Chocolatey 适合快速安装。遇到问题时,优先检查端口占用、配置文件路径和密码设置。