Redis 详细安装教程（Windows/Linux）

前言RedisRemote Dictionary Server是一个开源、基于内存、可选持久化的键值对存储数据库。它以其极高的性能、丰富的数据结构和广泛的应用场景如缓存、消息队列、会话存储等而闻名。本文将详细介绍在 Windows 和 Linux 两大主流操作系统上安装 Redis 的完整步骤。一、Windows 系统安装 RedisRedis 官方并未提供原生的 Windows 版本但微软维护了一个兼容版本适用于开发和测试环境。1.1 通过 Microsoft Archive 安装这是最推荐的 Windows 安装方式。下载 Redis访问 Microsoft Archive Redis Releases下载最新的.msi安装包例如Redis-x64-3.2.100.msi。运行安装程序双击下载的.msi文件按照向导进行安装。建议勾选“将 Redis 安装目录添加到系统 PATH 环境变量”。验证安装打开命令提示符CMD或 PowerShell输入以下命令redis-server --version redis-cli --version如果显示版本号则安装成功。启动 Redis 服务安装程序通常会自动将 Redis 注册为 Windows 服务并启动。你可以在“服务”管理器中找到名为“Redis”的服务进行启动/停止操作。1.2 使用 WSL2 (Windows Subsystem for Linux 2)对于希望获得原生 Redis 体验的 Windows 用户强烈推荐使用 WSL2。启用 WSL2以管理员身份打开 PowerShell 并运行wsl --install此命令会启用所需的 Windows 功能并安装默认的 Linux 发行版如 Ubuntu。在 WSL2 中安装 Redis打开 WSL2 终端然后按照下文“Linux 系统安装 Redis”的步骤进行操作。二、Linux 系统安装 RedisLinux 是运行 Redis 的首选环境安装方式多样。2.1 使用包管理器安装推荐这是最简单快捷的方式适用于大多数主流发行版。Ubuntu/Debian# 更新软件包列表 sudo apt update # 安装 Redis 服务器和客户端 sudo apt install redis-server redis-tools -y # 启动 Redis 服务 sudo systemctl start redis-server # 设置开机自启 sudo systemctl enable redis-server # 检查服务状态 sudo systemctl status redis-serverCentOS/RHEL/Fedora# 添加 EPEL 仓库CentOS/RHEL 需要 sudo yum install epel-release -y # 安装 Redis sudo yum install redis -y # 或使用 dnf (Fedora/RHEL 8) sudo dnf install redis -y # 启动并设置自启 sudo systemctl start redis sudo systemctl enable redis sudo systemctl status redis2.2 从源码编译安装此方法可以安装最新版本或特定版本的 Redis。安装编译依赖# Ubuntu/Debian sudo apt install build-essential tcl -y # CentOS/RHEL/Fedora sudo yum groupinstall Development Tools -y sudo yum install tcl -y下载并解压源码wget https://download.redis.io/redis-stable.tar.gz tar -xzvf redis-stable.tar.gz cd redis-stable编译与安装make # 运行测试可选但推荐 make test # 安装到系统目录 sudo make install启动 Redis# 前台启动 redis-server # 或使用配置文件后台启动 redis-server /path/to/redis.conf 三、安装后基本配置与验证3.1 基本配置Redis 的主要配置文件通常位于Linux (包管理安装):/etc/redis/redis.confLinux (源码安装):redis-stable/redis.confWindows: 安装目录下的redis.windows.conf、redis.windows-service.conf#先用以下命令确认 Redis 使用的是哪个配置文件powershell下执行如下命令 # 查看 Redis 服务信息 Get-WmiObject Win32_Service | Where-Object {$_.Name -like *redis*} | Select-Object Name, PathName # 如果 PathName 中包含 redis.windows-service.conf就修改 redis.windows-service.conf。常用配置项# 允许远程连接生产环境需结合密码和防火墙 bind 0.0.0.0 # 设置访问密码 requirepass your_strong_password # 启用持久化可选 save 900 1 save 300 10 save 60 10000修改配置后需要重启 Redis 服务生效。# 重启redis服务window下通过【winx】选择以管理员身份运行Powershell输入如下命令 Restart-Service redis3.2 连接测试使用 Redis 客户端redis-cli进行连接测试# 连接本地 Redis redis-cli # 如果设置了密码使用以下方式连接 redis-cli -a your_strong_password # 或先连接再认证 redis-cli 127.0.0.1:6379 AUTH your_strong_password # 示例 # 重启后测试密码是否生效 # 无密码连接应该失败 redis-cli ping # 预期返回: (error) NOAUTH Authentication required. # 带密码连接应该成功 redis-cli -a redis_secret_2026 ping # 预期返回: PONG在客户端内执行基本命令127.0.0.1:6379 PING # 应返回 PONG 127.0.0.1:6379 SET test_key Hello Redis OK 127.0.0.1:6379 GET test_key Hello Redis四、常见问题与解决方案Windows 下端口被占用修改redis.windows.conf中的port配置或停止占用 6379 端口的程序。Linux 下无法远程连接检查防火墙设置sudo ufw allow 6379和 Redis 配置文件中的bind与protected-mode设置。服务启动失败查看日志文件Linux:/var/log/redis/redis-server.log, Windows: 事件查看器获取详细错误信息。性能问题对于生产环境请根据官方文档调整内存策略、持久化配置和内核参数。总结本文提供了在 Windows通过 MSI 安装包或 WSL2和 Linux通过包管理器或源码编译系统上安装 Redis 的详细步骤。对于生产环境强烈建议使用 Linux 系统并仔细规划持久化、安全和高可用方案。安装完成后务必进行连接测试和基本配置以确保 Redis 服务正常运行。