Windows 系统上安装 Redis

在 Windows 系统上安装 Redis 主要有两种方式​​手动解压安装包​​推荐开发者和​​通过 Chocolatey 包管理器​​适合快速安装。以下是详细步骤以 Redis 7.0 版本为例兼容 Windows 10/11​​一、准备工作​​​​系统要求​​Windows 10 1903 或 Windows 1164 位。​​下载地址​​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.exeRedis 服务端程序。redis-cli.exeRedis 命令行客户端。redis.windows.confWindows 专用配置文件需重点修改。​​修改配置文件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连接 RedisD:\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 安装快速方式​​若已安装 ChocolateyWindows 包管理器可通过以下命令快速安装​​步骤 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为实际 PIDtaskkill /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 适合快速安装。遇到问题时优先检查端口占用、配置文件路径和密码设置。