两年多前记录了一篇博客《macOS 系统安装 Redis 并启用集群模式》，本机使用 bash 脚本启动多个 Redis 实例组成集群，操作较为繁琐

整理了基于 macOS OrbStack 的 Valkey 的本地集群部署方式，记录如下：

本文基于 OrbStack 软件部署，非 OrbStack 环境未经测试验证

获取配置

创建本地目录并获取配置

$ mkdir -p ~/Portable & cd ~/Portable
$ git clone https://github.com/sincerefly/conf-valkey-cluster.git

添加权限

$ cd conf-valkey-cluster
$ chmod +x ./init.sh

运行服务

初始化并运行，默认镜像 valkey/valkey:7.2-alpine

# valkey/valkey:7.2-alpine
$ ./init.sh

# valkey/valkey:9.0-alpine
$ VALKEY_IMAGE=8.0-alpine ./init.sh

稍等片刻可以看到

[2025-10-30 19:29:08] Cluster is healthy
[2025-10-30 19:29:08] Valkey cluster initialized successfully!
[2025-10-30 19:29:08] Cluster nodes:
940fbd29e31707348db33d030ec40ec927c13712 192.168.97.2:7001@17001 master - 0 1761823748351 2 connected 5461-10922
5a74931fdf31a55eebfea8f0fb04cde5c50bce0a 192.168.97.5:7002@17002 master - 0 1761823747118 3 connected 10923-16383
9c49963d7285875867c86e3f033c279bce6a951f 192.168.97.3:7004@17004 slave efe7608d5a60031d02f3d239d5cc06aa8bfa2708 0 1761823747941 1 connected
290e3d428b7df6511fabee0b1510d1ab4ebac8e9 192.168.97.6:7003@17003 slave 5a74931fdf31a55eebfea8f0fb04cde5c50bce0a 0 1761823747000 3 connected
3882a00169987d638b1a628f38e8d00c328873aa 192.168.97.7:7005@17005 slave 940fbd29e31707348db33d030ec40ec927c13712 0 1761823746906 2 connected
efe7608d5a60031d02f3d239d5cc06aa8bfa2708 192.168.97.4:7000@17000 myself,master - 0 1761823746000 1 connected 0-5460

连接测试

OrbStack 软件页面

$ redis-cli -c -h 127.0.0.1 -p 7000 ping
PONG

查询集群信息

> CLUSTER INFO

服务启停

# 停止
# VALKEY_IMAGE=valkey/valkey:7.2-alpine docker compose down
$ ./stop.sh

# 启动
# VALKEY_IMAGE=valkey/valkey:7.2-alpine docker compose up -d
$ ./start.sh

# 如果使用了 ENV 需要
VALKEY_IMAGE=9.0-alpine ./start.sh
VALKEY_IMAGE=9.0-alpine ./stop.sh

先这样，目前我用着还比较顺手，有时间可以再进行一些更通用化的完善