windows下Redis安装的教程

windows下Redis安装的教程

Windows 下我建议两种方式:

第一种是WSL / Docker,比较正规,适合长期开发;第二种是Windows 原生 zip 版,最简单,适合课程项目、毕设、测试环境。Redis 官方 Windows 文档主要推荐通过 WSL 或 Docker 来运行 Redis,Windows 原生 Redis 版本属于旧版/非官方维护方案。(Redis)


方案一:最简单的 Windows 原生安装方式

适合做项目、课程作业、本地测试。

1. 下载 Redis Windows 版

可以使用微软早期维护的 Windows 版本,常见版本是Redis-x64-3.2.100。这是比较老的 Windows 版本,但本地开发够用。Redis 官方旧文章也提到过这个 Windows 版本下载方式。(Redis)

下载后一般有两种包:

Redis-x64-3.2.100.msi 安装版 Redis-x64-3.2.100.zip 解压版

推荐用zip 解压版,简单、不容易出问题。


2. 解压 Redis

比如解压到:

D:\redis

解压后目录里应该能看到这些文件:

redis-server.exe redis-cli.exe redis.windows.conf redis.windows-service.conf

3. 启动 Redis 服务

打开 CMD,进入 Redis 目录:

cd /d D:\redis

启动 Redis:

redis-server.exe redis.windows.conf

如果窗口里出现类似内容,说明启动成功:

Ready to accept connections

这个 CMD 窗口不要关,关了 Redis 就停了。


4. 测试 Redis 是否成功

重新打开一个 CMD 窗口:

cd /d D:\redis redis-cli.exe

输入:

ping

如果返回:

PONG

说明 Redis 安装成功。

再测试一下存取数据:

set name xiadongxu get name

返回:

"xiadongxu"

就说明 Redis 正常可用。


设置 Redis 密码

打开:

D:\redis\redis.windows.conf

搜索:

# requirepass foobared

改成:

requirepass 123456

然后重启 Redis。

之后连接 Redis 要这样:

redis-cli.exe auth 123456

或者:

redis-cli.exe -a 123456

测试:

ping

返回:

PONG

把 Redis 安装成 Windows 服务

这样开机可以自动运行,不用每次手动打开 CMD。

进入 Redis 目录:

cd /d D:\redis

安装服务:

redis-server.exe --service-install redis.windows-service.conf --loglevel verbose

启动服务:

redis-server.exe --service-start

停止服务:

redis-server.exe --service-stop

卸载服务:

redis-server.exe --service-uninstall

也可以打开 Windows 服务管理器:

services.msc

找到:

Redis

然后设置为自动启动。


项目里怎么连接 Redis

如果你的 Redis 没设置密码:

host: 127.0.0.1 port: 6379 password: 空

如果设置了密码:

host: 127.0.0.1 port: 6379 password: 123456

Spring Boot 配置示例:

spring:redis:host:127.0.0.1port:6379password:123456database:0

如果没密码,就删掉password

spring:redis:host:127.0.0.1port:6379database:0

常见问题

1. 启动时报 6379 端口被占用

说明 Redis 已经启动过了,或者有其他程序占用了端口。

查看端口:

netstat -ano | findstr 6379

根据 PID 杀进程:

taskkill /PID 进程号 /F

2. redis-cli 连接不上

先确认 Redis 服务是否启动:

redis-cli.exe ping

如果不行,重新启动:

redis-server.exe redis.windows.conf

3. 项目连接 Redis 报密码错误

如果你设置了:

requirepass 123456

那项目配置里也必须加:

password:123456

如果没有设置密码,项目里不要写 password。


方案二:官方更推荐的 WSL 安装方式

这种方式更接近 Linux 服务器环境,适合长期开发。Redis 官方 Windows 安装文档推荐通过 WSL2 运行 Redis,要求 Windows 10 2004 及以上或 Windows 11。(Redis)

管理员 PowerShell 执行:

wsl--install

安装完成后重启电脑,打开 Ubuntu,执行:

sudoaptupdatesudoaptinstallredis-server-y

启动 Redis:

sudoserviceredis-server start

测试:

redis-cliping

返回:

PONG

Windows 本机项目一般仍然可以用:

127.0.0.1:6379

连接。


最推荐用哪个?

如果你只是做课程项目、Java/Spring Boot/Vue 项目、本地演示,直接用:

Redis-x64-3.2.100.zip

解压启动就够了。

如果你以后要做真实开发环境,建议用:

WSL + Ubuntu + Redis

因为这个更接近服务器环境,也更稳定。