macOS 安装 Redis 超详细教程(Homebrew方式,适用于 M1/M2/M3/M4 和 Intel)
一、前言
Redis 是一个开源的高性能 Key-Value 内存数据库,具有以下特点:
- 速度极快(基于内存)
- 支持多种数据结构
- 支持持久化
- 支持发布订阅
- 支持分布式
在实际开发中 Redis 常用于:
- 缓存数据库查询结果
- 分布式锁
- Session 存储
- 消息队列
- 提升系统性能
本文将详细介绍如何在 macOS 上安装 Redis,并完成启动和测试。
二、安装环境说明
本文适用于:
- macOS Intel
- macOS Apple Silicon(M1 / M2 / M3 / M4)
查看系统架构:
uname -m
输出:
arm64
说明是 Apple Silicon。
或:
x86_64
说明是 Intel Mac。
三、安装 Homebrew(如果未安装)
Homebrew 是 macOS 最常用的软件包管理工具。
检查是否已安装:
brew -v
如果未安装,执行:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
安装完成后执行:
brew update
四、安装 Redis
执行命令:
brew install redis
安装成功示例:
==> Installing redis
🍺 /opt/homebrew/Cellar/redis/7.2.5: 14 files, 2.3MB
验证安装:
redis-server --version
输出:
Redis server v=7.2.5
说明安装成功。
五、启动 Redis
方式一(推荐):后台启动
brew services start redis
输出:
Successfully started `redis`
Redis 将后台运行。
方式二:前台启动(调试用)
redis-server
看到:
Ready to accept connections
说明启动成功。
六、测试 Redis
执行:
redis-cli
进入 Redis:
127.0.0.1:6379>
测试连接:
ping
输出:
PONG
说明 Redis 正常运行。
测试写入数据:
set name redis
读取数据:
get name
输出:
"redis"
退出:
exit
七、Redis 常用管理命令
查看 Redis 状态
brew services list
输出:
Name Status
redis started
停止 Redis
brew services stop redis
重启 Redis
brew services restart redis
八、Redis 默认安装路径
Apple Silicon:
| 类型 | 路径 |
|---|---|
| redis-server | /opt/homebrew/bin/redis-server |
| redis-cli | /opt/homebrew/bin/redis-cli |
| 配置文件 | /opt/homebrew/etc/redis.conf |
| 数据目录 | /opt/homebrew/var/db/redis |
| 日志文件 | /opt/homebrew/var/log/redis.log |
Intel Mac:
/usr/local/bin/redis-server
九、修改 Redis 配置
编辑配置文件:
nano /opt/homebrew/etc/redis.conf
设置密码
找到:
# requirepass foobared
修改为:
requirepass 123456
保存退出。
重启 Redis:
brew services restart redis
连接 Redis(带密码)
redis-cli
输入:
auth 123456
十、设置开机自启
执行:
brew services start redis
验证:
brew services list
Redis 将自动随系统启动。
十一、卸载 Redis
brew uninstall redis
删除数据:
rm -rf /opt/homebrew/var/db/redis
十二、常见问题
问题1:redis-cli 无法连接
检查 Redis 状态:
brew services list
启动:
brew services start redis
问题2:端口占用
查看端口:
lsof -i :6379
杀掉进程:
kill -9 PID
问题3:查看 Redis 日志
cat /opt/homebrew/var/log/redis.log
十三、Redis 工作流程图
应用程序
↓
redis-cli / Java / Node
↓
Redis Server
↓
内存存储
↓
持久化(磁盘)
十四、总结
Redis 安装步骤总结
brew install redis
brew services start redis
redis-cli ping
返回:
PONG
说明安装成功。
Redis 是现代开发必备组件,适用于:
- Java
- Spring Boot
- Node.js
- 微服务
- 缓存优化
十五、作者推荐
推荐进一步学习:
- Redis 持久化机制
- Redis 分布式锁
- Redis 集群
- Redis + Spring Boot