尧图网站建设 
一、背景最近在 Spring Boot 项目中配置了 Redisspring.data.redis.hostlocalhost spring.data.redis.port6379 spring.data.redis.timeout2s想通过Redis Insight可视化工具查看数据发现连不上。又试着用redis-cli ping验证结果 PowerShell 直接报错无法将“redis-cli”项识别为 cmdlet、函数、脚本文件或可运行程序的名称...由此开启了一系列踩坑和填坑过程记录如下。二、问题根本原因redis-cli命令找不到是因为Windows 本机根本没有安装 Redis 服务。Spring Boot 中的配置只是客户端声明它和 Redis Insight 一样都必须连接到一个已经运行的 Redis 服务器。三、安装 Redis 的三种方案方案一Windows 原生便携版最简单零网络依赖下载微软存档版 Redishttps://github.com/microsoftarchive/redis/releases选择Redis-x64-3.0.504.zip解压到C:\Redis双击redis-server.exe出现Ready to accept connections即启动成功打开新终端进入该目录执行cd C:\Redis .\redis-cli.exe ping返回PONG即一切正常优点无需联网解压即用缺点版本较老3.0需手动保持窗口开启或注册为服务。方案二Memurai长期开发推荐使用 Windows 包管理器安装 Redis 兼容服务winget install Memurai.Memurai安装后自动作为 Windows 服务运行redis-cli也会加入 PATH任意位置可直接执行redis-cli ping。方案三Docker 部署隔离干净、版本最新一条命令即可启动最新版 Redispowershell: docker run -d -p 6379:6379 --name redis redis但第一次使用时国内网络环境极容易遇到镜像拉取失败问题见下文。四、Docker 拉取 Redis 镜像失败解决重点执行docker run时报错Unable to find image redis:latest locally ... dialing registry-1.docker.io:443 ... connectex: A connection attempt failed ...原因默认 Docker Hub 仓库访问受阻尤其是 IPv6 连接被干扰。✅ 解决方法配置国内镜像加速器打开Docker Desktop点击右上角设置齿轮→ 左侧选择Docker Engine编辑 JSON 配置在registry-mirrors中添加加速地址{ registry-mirrors: [ https://docker.m.daocloud.io, https://dockerhub.timeweb.cloud, https://noohub.ru, https://huecker.io ] }注意多个镜像可提高可用性但保证 JSON 格式正确逗号不要遗漏。点击Apply restart等待 Docker 重启完成重新执行运行命令docker run -d -p 6379:6379 --name redis redis此时会正常显示下载进度直至容器启动成功。备选方案离线镜像包在能访问外网的机器上docker save导出redis.tar再到本机docker load -i redis.tar导入。回退到 Windows 原生 Redis方案一完全绕过网络问题。五、Docker Desktop 的作用是什么简单说Docker Desktop 是一个轻量级应用容器引擎让你在 Windows 上以极低的资源消耗运行各种 Linux 环境下的软件如 Redis、MySQL。核心优势一条命令自动下载、安装、运行卸载也干净无残留各容器互相隔离不污染宿主机可同时运行多个不同版本的同一软件开发环境可通过docker-compose.yml一键复制对比 Windows 原生 Redis 更推荐用于学习或生产环境模拟。六、连接 Redis Insight无论选择哪种安装方式只要 Redis 服务在localhost:6379跑起来后打开Redis Insight点击“ Add Redis Database”填写Host:localhostPort:6379Name: 任意名称Username/Password未设置密码则留空点击“Test Connection”成功提示后保存即可可视化操作所有 Key与 Spring Boot 应用共享同一 Redis 实例。七、Docker 常用管理命令操作命令查看运行中的容器docker ps停止 Redisdocker stop redis再次启动docker start redis进入容器内部 CLIdocker exec -it redis redis-cli删除容器docker rm -f redis端口冲突解决若 6379 被占用可改用-p 6380:6379客户端连接时使用localhost:6380。八、总结整个链条就是Spring Boot 配置客户端 → 需要 Redis 服务 → Windows 本机安装 Redis推荐 Docker → 解决网络拉取问题配置镜像加速→ 最后 Redis Insight 连接同一服务进行可视化。希望这篇记录能帮你少走弯路如果对你有帮助欢迎点赞收藏 ~ Spring Boot + Redis 连接与 Redis Insight 使用全攻略（Windows 踩坑记录）
一、背景最近在 Spring Boot 项目中配置了 Redisspring.data.redis.hostlocalhost spring.data.redis.port6379 spring.data.redis.timeout2s想通过Redis Insight可视化工具查看数据发现连不上。又试着用redis-cli ping验证结果 PowerShell 直接报错无法将“redis-cli”项识别为 cmdlet、函数、脚本文件或可运行程序的名称...由此开启了一系列踩坑和填坑过程记录如下。二、问题根本原因redis-cli命令找不到是因为Windows 本机根本没有安装 Redis 服务。Spring Boot 中的配置只是客户端声明它和 Redis Insight 一样都必须连接到一个已经运行的 Redis 服务器。三、安装 Redis 的三种方案方案一Windows 原生便携版最简单零网络依赖下载微软存档版 Redishttps://github.com/microsoftarchive/redis/releases选择Redis-x64-3.0.504.zip解压到C:\Redis双击redis-server.exe出现Ready to accept connections即启动成功打开新终端进入该目录执行cd C:\Redis .\redis-cli.exe ping返回PONG即一切正常优点无需联网解压即用缺点版本较老3.0需手动保持窗口开启或注册为服务。方案二Memurai长期开发推荐使用 Windows 包管理器安装 Redis 兼容服务winget install Memurai.Memurai安装后自动作为 Windows 服务运行redis-cli也会加入 PATH任意位置可直接执行redis-cli ping。方案三Docker 部署隔离干净、版本最新一条命令即可启动最新版 Redispowershell: docker run -d -p 6379:6379 --name redis redis但第一次使用时国内网络环境极容易遇到镜像拉取失败问题见下文。四、Docker 拉取 Redis 镜像失败解决重点执行docker run时报错Unable to find image redis:latest locally ... dialing registry-1.docker.io:443 ... connectex: A connection attempt failed ...原因默认 Docker Hub 仓库访问受阻尤其是 IPv6 连接被干扰。✅ 解决方法配置国内镜像加速器打开Docker Desktop点击右上角设置齿轮→ 左侧选择Docker Engine编辑 JSON 配置在registry-mirrors中添加加速地址{ registry-mirrors: [ https://docker.m.daocloud.io, https://dockerhub.timeweb.cloud, https://noohub.ru, https://huecker.io ] }注意多个镜像可提高可用性但保证 JSON 格式正确逗号不要遗漏。点击Apply restart等待 Docker 重启完成重新执行运行命令docker run -d -p 6379:6379 --name redis redis此时会正常显示下载进度直至容器启动成功。备选方案离线镜像包在能访问外网的机器上docker save导出redis.tar再到本机docker load -i redis.tar导入。回退到 Windows 原生 Redis方案一完全绕过网络问题。五、Docker Desktop 的作用是什么简单说Docker Desktop 是一个轻量级应用容器引擎让你在 Windows 上以极低的资源消耗运行各种 Linux 环境下的软件如 Redis、MySQL。核心优势一条命令自动下载、安装、运行卸载也干净无残留各容器互相隔离不污染宿主机可同时运行多个不同版本的同一软件开发环境可通过docker-compose.yml一键复制对比 Windows 原生 Redis 更推荐用于学习或生产环境模拟。六、连接 Redis Insight无论选择哪种安装方式只要 Redis 服务在localhost:6379跑起来后打开Redis Insight点击“ Add Redis Database”填写Host:localhostPort:6379Name: 任意名称Username/Password未设置密码则留空点击“Test Connection”成功提示后保存即可可视化操作所有 Key与 Spring Boot 应用共享同一 Redis 实例。七、Docker 常用管理命令操作命令查看运行中的容器docker ps停止 Redisdocker stop redis再次启动docker start redis进入容器内部 CLIdocker exec -it redis redis-cli删除容器docker rm -f redis端口冲突解决若 6379 被占用可改用-p 6380:6379客户端连接时使用localhost:6380。八、总结整个链条就是Spring Boot 配置客户端 → 需要 Redis 服务 → Windows 本机安装 Redis推荐 Docker → 解决网络拉取问题配置镜像加速→ 最后 Redis Insight 连接同一服务进行可视化。希望这篇记录能帮你少走弯路如果对你有帮助欢迎点赞收藏 ~