Windows 系统上安装 Redis

📅 2026/7/8 5:29:44 👁️ 阅读次数 📝 编程学习
Windows 系统上安装 Redis

在 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 适合快速安装。遇到问题时,优先检查端口占用、配置文件路径和密码设置。