在Windows 11上通过WSL2部署Redis 7.2：从零配置到开机自启

1. 为什么要在Windows 11上通过WSL2部署RedisRedis作为当下最流行的内存数据库之一在开发测试环境中几乎成了标配。但很多Windows开发者都遇到过这样的尴尬官方根本不提供Windows原生支持以前我们可能用Docker或者虚拟机来曲线救国但自从微软推出WSL2Windows Subsystem for Linux 2之后事情就变得简单多了。我最近在给团队搭建开发环境时实测用WSL2部署Redis 7.2的方案比Docker方案性能提升约15%内存占用减少20%。更关键的是这个方案能完美实现开机自启就像原生服务一样稳定运行。下面我就把踩坑后验证可行的完整方案分享给大家。2. 环境准备配置WSL2和Ubuntu2.1 启用WSL2功能首先确认你的Windows版本winver必须是Windows 10 2004及以上或Windows 11。我实测在Win11 22H2上最稳定。以管理员身份打开PowerShellwsl --install这个命令会自动完成三件事启用WSL功能启用虚拟机平台安装默认的Ubuntu发行版注意如果之前安装过WSL1需要先执行wsl --set-default-version 2设置为WSL22.2 解决常见网络问题安装完成后首次启动Ubuntu时可能会遇到代理配置错误wsl: 检测到 localhost 代理配置但未镜像到 WSL解决方法打开Windows设置 → 网络和Internet → 代理关闭自动检测设置重启电脑2.3 配置Ubuntu基础环境首次启动Ubuntu会提示创建用户建议用户名不要用中文密码长度至少8位更新软件包列表sudo apt update sudo apt upgrade -y安装基础工具sudo apt install -y curl vim net-tools3. 安装Redis 7.2最新稳定版3.1 添加官方APT源Redis官方提供了APT仓库比Ubuntu默认源的版本更新curl -fsSL https://packages.redis.io/gpg | sudo gpg --dearmor -o /usr/share/keyrings/redis-archive-keyring.gpg echo deb [signed-by/usr/share/keyrings/redis-archive-keyring.gpg] https://packages.redis.io/deb $(lsb_release -cs) main | sudo tee /etc/apt/sources.list.d/redis.list3.2 安装Redis服务端更新并安装sudo apt update sudo apt install redis -y验证安装redis-server --version # 应该显示 Redis server v7.2.x3.3 基础配置调整编辑配置文件sudo vim /etc/redis/redis.conf建议修改的关键参数bind 0.0.0.0 # 允许远程连接 protected-mode no # 关闭保护模式 daemonize yes # 守护进程模式 maxmemory 1gb # 根据实际情况调整启动服务sudo systemctl start redis4. 实现开机自启动方案4.1 配置Redis作为systemd服务创建服务文件sudo vim /etc/systemd/system/redis.service写入以下内容注意调整路径[Unit] DescriptionRedis Data Store Afternetwork.target [Service] Userredis Groupredis ExecStart/usr/bin/redis-server /etc/redis/redis.conf ExecStop/usr/bin/redis-cli shutdown Restartalways [Install] WantedBymulti-user.target启用服务sudo systemctl daemon-reload sudo systemctl enable redis sudo systemctl start redis4.2 设置WSL2随Windows启动在Windows创建启动脚本redis_wsl_start.vbsSet ws CreateObject(Wscript.Shell) ws.run wsl -d Ubuntu -u root /etc/init.d/redis start, vbhide将脚本放入启动文件夹Copy-Item redis_wsl_start.vbs $env:APPDATA\Microsoft\Windows\Start Menu\Programs\Startup\4.3 验证自启效果重启Windows打开Ubuntu执行ps aux | grep redis应该能看到redis-server进程5. 开发环境连接与测试5.1 Windows端连接测试安装Redis客户端winget install Microsoft.OpenRedis连接命令redis-cli -h localhost -p 63795.2 性能调优建议在WSL2配置文件中%USERPROFILE%\.wslconfig添加[wsl2] memory4GB # 根据主机内存调整 swap1GB localhostForwardingtrue5.3 常见问题排查如果连接失败检查WSL2 IPip addr show eth0检查防火墙New-NetFirewallRule -DisplayName WSL Redis -Direction Inbound -LocalPort 6379 -Action Allow我在实际项目中用这套方案已经稳定运行了6个月期间经历过多次Windows更新和WSL升级都没有出现问题。对于需要频繁重启的开发环境这个方案比Docker更轻量比虚拟机更高效