前言

Redis(Remote Dictionary Server)是一个开源、基于内存、可选持久化的键值对存储数据库。它以其极高的性能、丰富的数据结构和广泛的应用场景(如缓存、消息队列、会话存储等)而闻名。本文将详细介绍在 Windows 和 Linux 两大主流操作系统上安装 Redis 的完整步骤。

一、Windows 系统安装 Redis

Redis 官方并未提供原生的 Windows 版本,但微软维护了一个兼容版本,适用于开发和测试环境。

1.1 通过 Microsoft Archive 安装

这是最推荐的 Windows 安装方式。

  1. 下载 Redis:访问 Microsoft Archive Redis Releases,下载最新的 .msi 安装包(例如 Redis-x64-3.2.100.msi)。
  2. 运行安装程序:双击下载的 .msi 文件,按照向导进行安装。建议勾选“将 Redis 安装目录添加到系统 PATH 环境变量”。
  3. 验证安装:打开命令提示符(CMD)或 PowerShell,输入以下命令:
redis-server --version
redis-cli --version

如果显示版本号,则安装成功。

  1. 启动 Redis 服务:安装程序通常会自动将 Redis 注册为 Windows 服务并启动。你可以在“服务”管理器中找到名为“Redis”的服务进行启动/停止操作。

1.2 使用 WSL2 (Windows Subsystem for Linux 2)

对于希望获得原生 Redis 体验的 Windows 用户,强烈推荐使用 WSL2。

  1. 启用 WSL2:以管理员身份打开 PowerShell 并运行:
wsl --install

此命令会启用所需的 Windows 功能并安装默认的 Linux 发行版(如 Ubuntu)。

  1. 在 WSL2 中安装 Redis:打开 WSL2 终端,然后按照下文“Linux 系统安装 Redis”的步骤进行操作。

二、Linux 系统安装 Redis

Linux 是运行 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-server
CentOS/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 redis

2.2 从源码编译安装

此方法可以安装最新版本或特定版本的 Redis。

  1. 安装编译依赖
# Ubuntu/Debian
sudo apt install build-essential tcl -y
# CentOS/RHEL/Fedora
sudo yum groupinstall "Development Tools" -y
sudo yum install tcl -y
  1. 下载并解压源码
wget https://download.redis.io/redis-stable.tar.gz
tar -xzvf redis-stable.tar.gz
cd redis-stable
  1. 编译与安装
make
# 运行测试(可选但推荐)
make test
# 安装到系统目录
sudo make install
  1. 启动 Redis
# 前台启动
redis-server
# 或使用配置文件后台启动
redis-server /path/to/redis.conf &

三、安装后基本配置与验证

3.1 基本配置

Redis 的主要配置文件通常位于:

  • Linux (包管理安装): /etc/redis/redis.conf
  • Linux (源码安装): redis-stable/redis.conf
  • Windows: 安装目录下的 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下通过【win+x】选择以管理员身份运行Powershell输入如下命令:
Restart-Service redis

3.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 配置文件中的 bindprotected-mode 设置。
  • 服务启动失败:查看日志文件(Linux: /var/log/redis/redis-server.log, Windows: 事件查看器)获取详细错误信息。
  • 性能问题:对于生产环境,请根据官方文档调整内存策略、持久化配置和内核参数。

总结

本文提供了在 Windows(通过 MSI 安装包或 WSL2)和 Linux(通过包管理器或源码编译)系统上安装 Redis 的详细步骤。对于生产环境,强烈建议使用 Linux 系统,并仔细规划持久化、安全和高可用方案。安装完成后,务必进行连接测试和基本配置,以确保 Redis 服务正常运行。

Logo

openEuler 是由开放原子开源基金会孵化的全场景开源操作系统项目,面向数字基础设施四大核心场景(服务器、云计算、边缘计算、嵌入式),全面支持 ARM、x86、RISC-V、loongArch、PowerPC、SW-64 等多样性计算架构

更多推荐