MacOS新手必看：用Homebrew安装Redis并设置密码的完整指南
MacOS新手必看：用Homebrew安装Redis并设置密码的完整指南
Redis作为高性能的键值存储系统，已经成为现代开发栈中不可或缺的组件。对于MacOS用户而言，Homebrew提供了最便捷的软件管理方式，让Redis的安装和配置变得异常简单。本文将手把手带你完成从零开始的环境搭建，特别针对初次接触命令行和数据库配置的开发者，提供保姆级指导。
1. 准备工作与环境检查
在开始安装之前，我们需要确保系统环境已经就绪。打开你的终端应用（位于/Applications/Utilities/Terminal.app），输入以下命令检查Homebrew是否已安装：
brew --version如果看到类似Homebrew 4.x.x的版本输出，说明已经安装。若提示command not found，则需要先安装Homebrew：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"安装完成后，建议运行以下命令确保Homebrew处于最佳状态：
brew doctor brew update提示：Homebrew的安装过程可能需要输入你的系统密码，这是正常的权限验证步骤。
对于完全的新手，了解几个基本概念会很有帮助：
- Homebrew：MacOS上的包管理工具，可以理解为"App Store for developers"
- Redis：内存数据库，以键值形式存储数据，响应速度极快
- redis.conf：Redis的配置文件，所有重要参数都在这里设置
2. 使用Homebrew安装Redis
现在我们可以正式开始安装Redis了。在终端中输入以下命令：
brew install redis这个简单的命令会自动完成以下操作：
- 下载Redis最新稳定版
- 编译源代码
- 设置必要的系统链接
- 创建配置文件模板
安装完成后，系统会显示类似如下的信息：
==> Summary 🍺 /usr/local/Cellar/redis/7.0.12: 13 files, 3.4MB ==> Caveats To have launchd start redis now and restart at login: brew services start redis Or, if you don't want/need a background service you can just run: redis-server /usr/local/etc/redis.conf这里有几个关键路径需要了解：
| 路径 | 用途 |
|---|---|
/usr/local/Cellar/redis | Redis的安装目录 |
/usr/local/etc/redis.conf | 默认配置文件位置 |
/usr/local/bin/redis-server | Redis服务器程序 |
/usr/local/bin/redis-cli | Redis命令行客户端 |
验证安装是否成功：
redis-server --version应该会看到类似Redis server v=7.0.12的版本信息。
3. 配置Redis密码保护
Redis默认安装后是没有密码保护的，这在开发环境中可能没问题，但为了安全考虑，我们应该设置密码。以下是详细步骤：
3.1 编辑配置文件
使用nano编辑器打开配置文件（nano比vim更适合新手）：
nano /usr/local/etc/redis.conf在文件中查找requirepass（可以使用Ctrl+W搜索功能），你会找到类似这样的行：
# requirepass foobared将其修改为（去掉#号并替换密码）：
requirepass yourStrongPassword123重要：密码应该足够复杂，建议包含大小写字母、数字和特殊字符，长度至少12位。
保存文件：
- 按
Ctrl+O写入文件 - 按
Enter确认文件名 - 按
Ctrl+X退出编辑器
3.2 应用新配置
修改配置后需要重启Redis服务使更改生效：
brew services restart redis验证服务状态：
brew services list应该能看到redis的状态为started。
4. 验证密码设置
让我们测试密码是否生效。首先尝试无密码连接：
redis-cli在Redis提示符下执行任何命令，比如：
127.0.0.1:6379> ping你会收到错误提示(error) NOAUTH Authentication required，这说明密码保护已经生效。
现在用正确的方式连接：
redis-cli -a yourStrongPassword123或者在连接后认证：
redis-cli 127.0.0.1:6379> AUTH yourStrongPassword123 OK 127.0.0.1:6379> ping PONG看到PONG响应说明一切正常。
5. 常见问题排查
新手在使用过程中可能会遇到一些问题，以下是常见情况及解决方法：
问题1：找不到配置文件
Error: /usr/local/etc/redis.conf does not exist!解决方法：
- 确认Redis是否通过Homebrew安装成功
- 尝试使用
brew list redis查看安装的文件 - 可能需要手动创建配置文件模板：
cp /usr/local/etc/redis.conf.default /usr/local/etc/redis.conf
问题2：服务无法启动
Error: Failure while executing; `/bin/launchctl bootstrap gui/501 /Users/xxx/Library/LaunchAgents/homebrew.mxcl.redis.plist` exited with 5.解决方法：
- 检查配置文件语法是否正确
- 查看日志获取详细信息：
tail -n 100 /usr/local/var/log/redis.log - 尝试以非服务模式启动：
redis-server /usr/local/etc/redis.conf
问题3：忘记密码
如果忘记了设置的密码，可以：
- 停止Redis服务：
brew services stop redis - 以无密码模式临时启动：
redis-server --requirepass "" - 连接后使用
CONFIG SET requirepass "newpassword"设置新密码 - 正常重启服务
6. 进阶配置建议
除了密码保护外，还有一些推荐的安全和性能配置：
在redis.conf中修改以下参数：
# 限制只接受本地连接 bind 127.0.0.1 # 更改默认端口(可选) port 6380 # 启用持久化 save 900 1 save 300 10 save 60 10000 # 限制内存使用(根据你的系统调整) maxmemory 1gb maxmemory-policy allkeys-lru修改这些配置后同样需要重启服务：
brew services restart redis对于开发环境，你可能还需要安装Redis可视化工具，如：
- TablePlus：支持多种数据库的GUI客户端
- RedisInsight：Redis官方推出的管理工具
- Medis：MacOS上简洁的Redis客户端
安装TablePlus为例：
brew install --cask tableplus7. 日常使用技巧
掌握一些基本命令会让开发更高效：
基础操作：
SET key value- 存储键值对GET key- 获取值DEL key- 删除键KEYS pattern- 查找键（生产环境慎用）
实用技巧：
- 批量插入数据：
cat data.txt | redis-cli -a yourPassword --pipe- 监控实时命令：
redis-cli -a yourPassword --stat- 性能测试：
redis-benchmark -h 127.0.0.1 -p 6379 -a yourPassword -q -n 100000- 备份数据：
redis-cli -a yourPassword SAVE # 备份文件会保存在/usr/local/var/db/redis/dump.rdb记得定期检查Redis的运行状况：
redis-cli -a yourPassword INFO重点关注以下指标：
used_memory：内存使用量connected_clients：客户端连接数instantaneous_ops_per_sec：每秒操作数