跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客GitHub 精选镜像AI 生图工具UI配色美学隐私政策关于联系
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
编程语言

Redis 安装与配置教程 (Windows, Linux, macOS)

在 Windows、Linux 和 macOS 系统上安装和配置 Redis 的详细步骤。涵盖官方安装包下载、包管理器安装及源码编译方法。包含服务启动验证、配置文件修改(如密码、端口)、防火墙设置及常见问题排查,帮助开发者快速搭建 Redis 环境。

t ag发布于 2026/3/24更新于 2026/7/2650 浏览

Redis (Remote Dictionary Server) 是一个高性能的开源键值对存储数据库。它支持多种数据结构,常用于缓存、消息队列和会话存储等场景。本教程将指导您在不同操作系统上安装和配置 Redis。

1. Windows 系统安装

Windows 系统安装 Redis 相对简单,官方推荐使用预编译的安装包。

  1. 下载安装包:
    • 访问 Redis 的 Windows 版本项目页面 (例如:https://github.com/microsoftarchive/redis)。请注意,官方 Redis 主要支持 Linux/BSD,Windows 版本由社区维护。
    • 在 Releases 页面找到最新的稳定版本 (如 Redis-x64-3.0.504.msi) 并下载。
  2. 运行安装程序:
    • 双击下载的 .msi 文件启动安装向导。
    • 接受许可协议,选择安装路径(默认通常是 C:\Program Files\Redis),并勾选将 Redis 安装目录添加到 PATH 环境变量(方便命令行使用)。
    • 点击 Install 开始安装。
  3. 验证安装:
    • 安装完成后,打开命令提示符 (cmd) 或 PowerShell。
    • 输入命令 redis-server --version 或 redis-cli --version。如果看到 Redis 的版本信息(如 Redis server v=3.0.504),则说明安装成功。
  4. 运行 Redis:
    • 默认情况下,安装程序会将 Redis 配置为 Windows 服务并自动启动。您可以在 Windows 服务管理器中查看 Redis 服务的状态(Win+R -> services.msc)。
    • 您也可以通过命令行启动 Redis 服务:redis-server。这会使用默认配置在前台运行。按 Ctrl+C 可停止。
  5. 使用 Redis 客户端:
    • 打开另一个命令提示符窗口。
    • 输入 redis-cli 启动 Redis 命令行客户端。

尝试基本命令:

127.0.0.1:6379> ping
PONG
127.0.0.1:6379> set mykey "Hello Redis"
OK
127.0.0.1:6379> get mykey
"Hello Redis"

2. Linux 系统安装 (以 Ubuntu/Debian 为例)

Linux 系统通常通过包管理器安装 Redis,也可以选择源码编译安装以获得最新版本。

方法一:使用包管理器安装 (推荐)
  1. 更新包索引:
sudo apt update
  1. 安装 Redis:
sudo apt install redis-server
  1. 启动与设置开机自启:
sudo systemctl start redis-server
sudo systemctl enable redis-server
  1. 检查状态:
sudo systemctl status redis-server
  1. 验证安装:
redis-cli --version
redis-server --version
  1. 使用 Redis 客户端:
redis-cli
127.0.0.1:6379> ping
PONG
方法二:源码编译安装 (获取最新版本)
  1. 安装编译依赖:
sudo apt update
sudo apt install build-essential tcl
  1. 下载并解压:
wget https://download.redis.io/releases/redis-7.2.4.tar.gz
tar xzf redis-7.2.4.tar.gz
cd redis-7.2.4
  1. 编译与安装:
make
make test
sudo make install
  1. 配置与运行:
    • Redis 默认安装在 /usr/local/bin。
    • 复制配置文件模板并编辑:
sudo mkdir /etc/redis
sudo cp redis.conf /etc/redis/redis.conf
sudo nano /etc/redis/redis.conf
# 根据需要修改配置,如 daemonize yes 以守护进程运行
  • 启动服务:
redis-server /etc/redis/redis.conf
其他 Linux 发行版

Arch Linux:

sudo pacman -S redis
sudo systemctl start redis.service
sudo systemctl enable redis.service

CentOS/RHEL/Fedora:

sudo yum install epel-release # 或 sudo dnf install epel-release
sudo yum install redis # 或 sudo dnf install redis
sudo systemctl start redis
sudo systemctl enable redis

3. macOS 系统安装 (使用 Homebrew)

macOS 上推荐使用 Homebrew 安装 Redis。

  1. 安装 Homebrew (如果尚未安装):
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
  1. 使用 Homebrew 安装 Redis:
brew update
brew install redis
  1. 启动与管理服务:
    • 安装完成后,可以使用以下命令启动 Redis,并设置为开机自启:
brew services start redis
  • 检查服务状态:
brew services list
  • 或者,手动启动(前台运行):
redis-server /usr/local/etc/redis.conf
  1. 验证安装:
redis-cli --version
redis-server --version
redis-cli 127.0.0.1:6379> ping
PONG

4. 基本配置 (所有系统)

无论哪种安装方式,通常都需要了解并可能修改配置文件以满足需求。配置文件通常名为 redis.conf。

  1. 找到配置文件:
    • Windows: 安装目录下 (如 C:\Program Files\Redis\redis.conf)。
    • Linux (包管理安装): /etc/redis/redis.conf。
    • Linux (源码安装): 编译目录下的 redis.conf,或复制到 /etc/redis/。
    • macOS (Homebrew): /usr/local/etc/redis.conf。
  2. 常用配置项:
    • daemonize yes/no: 是否以守护进程(后台)方式运行。
    • port 6379: Redis 监听的端口号。
    • bind 127.0.0.1: 绑定的主机地址。0.0.0.0 表示允许所有网络接口连接(注意安全风险)。
    • requirepass yourpassword: 设置连接密码(强烈建议在生产环境设置)。
    • databases 16: 默认数据库数量。
    • dir ./: RDB 持久化文件存储目录。建议设置为明确的路径(如 /var/lib/redis)。
    • dbfilename dump.rdb: RDB 持久化文件名。
    • appendonly yes/no: 是否启用 AOF (Append Only File) 持久化。
    • appendfilename "appendonly.aof": AOF 文件名。
  3. 修改配置后重启服务:
    • Windows: 在服务管理器中重启 Redis 服务。
    • macOS (Homebrew): brew services restart redis
    • Linux (systemd): sudo systemctl restart redis-server
  4. 设置密码连接:
    • 在 redis.conf 中设置 requirepass your_strong_password。
    • 重启 Redis。
    • 连接客户端时需要认证:
redis-cli 127.0.0.1:6379> auth your_strong_password
OK
  • 或者:
redis-cli -a your_strong_password # 注意:密码会出现在命令历史中,不安全

5. 基础操作与验证

  • 启动服务:根据上述系统说明启动 Redis 服务 (redis-server 或服务管理命令)。
  • 连接客户端:redis-cli。
  • 测试连接:在 redis-cli 中执行 ping,应返回 PONG。
  • 退出客户端:quit 或 exit。
  • 停止服务:
    • 在 redis-cli 中执行 shutdown (需要权限)。
    • 或者使用系统服务管理命令停止 (如 sudo systemctl stop redis-server)。
  • 设置/获取键值:
set mykey "Hello Redis"
get mykey

6. 防火墙配置 (如果需要远程访问)

如果需要在其他机器上访问 Redis 服务器,需要确保服务器的防火墙允许 Redis 端口 (默认 6379/tcp) 的入站连接。

  • Windows: 在 Windows Defender 防火墙中添加入站规则,允许 TCP 端口 6379。
  • macOS: 在 系统偏好设置 -> 安全性与隐私 -> 防火墙 -> 防火墙选项 中添加端口 6379。
  • Linux (firewalld):
sudo firewall-cmd --permanent --add-port=6379/tcp
sudo firewall-cmd --reload
  • Linux (ufw):
sudo ufw allow 6379/tcp
sudo ufw reload

注意:开放端口后,务必在 redis.conf 中设置强密码 (requirepass) 并考虑限制可访问的 IP (bind 或使用防火墙规则),以保障安全。

7. 常见问题

  • 端口 6379 被占用:检查是否有其他程序占用了该端口,或修改 redis.conf 中的 port 配置。
  • 权限问题:确保 Redis 进程有权限读写配置中指定的目录(如持久化目录 dir)。
  • 连接失败:检查 Redis 服务是否正在运行 (ps aux | grep redis-server),检查防火墙设置,检查 bind 配置是否正确。
  • 配置文件错误:修改配置文件后重启服务失败,可能是配置语法错误。仔细检查修改的部分。

目录

  1. 1. Windows 系统安装
  2. 2. Linux 系统安装 (以 Ubuntu/Debian 为例)
  3. 方法一:使用包管理器安装 (推荐)
  4. 方法二:源码编译安装 (获取最新版本)
  5. 根据需要修改配置,如 daemonize yes 以守护进程运行
  6. 其他 Linux 发行版
  7. 3. macOS 系统安装 (使用 Homebrew)
  8. 4. 基本配置 (所有系统)
  9. 5. 基础操作与验证
  10. 6. 防火墙配置 (如果需要远程访问)
  11. 7. 常见问题
  • 免费图片AI生成工具免费生成了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 免费图片视频在线生成30秒,将你的创意变成现实开始设计
  • X/Twitter免费视频下载器免登陆无限额度免费视频解析下载了解详情
  • 100+免费在线小游戏爽一把
极客日志微信公众号二维码

微信扫一扫,关注极客日志

微信公众号「极客日志V2」,在微信中扫描左侧二维码关注。展示文案:极客日志V2 zeeklog

更多推荐文章

查看全部
  • ArcFace 人脸识别源代码与模型深入剖析
  • WebLogic 中间件高危漏洞应急响应案例分析
  • 基于 OpenClaw 与 Claude 的自动化写作系统搭建实践
  • 基于 Spring Boot 的学生成绩综合统计分析系统设计
  • DeepSeek 使用完全指南:10 个高效对话与隐藏技巧
  • 2026 年 3 月大模型全景解析:国产登顶、百万上下文与 Agent 工业化
  • Ubuntu 22.04 下 libwebkit2gtk-4.1-0 安装与避坑指南
  • NLP 自然语言处理 TextRank 算法详解:文本摘要与关键词提取
  • 八大排序算法核心解析与实战实现
  • Cubism AI:免费无限制的 AI 图像生成工具
  • Python 自动备份脚本:智能增量、多线程加速与压缩优化
  • 降低 AIGC 总体疑似度的实用技巧与工具方案
  • Qwen3-VL-WEB 可视化工具使用指南与竞品分析实战
  • Chrome 插件开发指南:从 Web 到扩展及实战
  • Gradio用几行代码构建 AI Web 应用
  • 低代码 AI 平台:Coze 与 Dify 深度对比
  • MySQL 和 Navicat Windows 安装与连接教程
  • 大模型、AI 大模型与 GPT 模型解析:定义、优势及应用
  • Ubuntu 虚拟机部署 OpenClaw 个人 AI 助手指南
  • 从零开始微调Qwen3-VL视觉模型:LLaMA-Factory与WEBUI实战

相关免费在线工具

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online

  • Markdown转HTML

    将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online

  • HTML转Markdown

    将 HTML 片段转为 GitHub Flavored Markdown,支持标题、列表、链接、代码块与表格等;浏览器内处理,可链接预填。 在线工具,HTML转Markdown在线工具,online

  • JSON 压缩

    通过删除不必要的空白来缩小和压缩JSON。 在线工具,JSON 压缩在线工具,online

  • JSON美化和格式化

    将JSON字符串修饰为友好的可读格式。 在线工具,JSON美化和格式化在线工具,online