说真的，面对海量数据的冲击，单机版的 Redis 已经开始显得力不从心。于是我们把目光投向了Redis 集群——它像一支精锐的特种部队， 能够把读写压力均匀分配到多个节点上，让系统的吞吐量和容错能力瞬间升级。下面 我将用最接地气的语言，把在 Ubuntu 系统上搭建 Redis 集群的全过程搬到你面前，让你不再纠结于“怎么配”，只管大胆去实现，开搞。。

一、动手之前，你需要做好哪些准备？

• 系统版本：Ubuntu 20.04 LTS 或更高。
• 硬件要求：至少 2 GB 内存，建议 4 GB 以上；CPU 核心数 ≥ 2。
• 网络环境：如果是云服务器，请确保防火墙已开放 7000‑7005 端口。
• 心态：保持好奇和耐心——调试过程中难免会遇到小坑，但每一次解决都能让你对分布式系统有更深的体会。

二、 在 Ubuntu 上安装 Redis

打开终端，先更新一下本地软件源，然后直接装上 redis‑server。 准确地说... 整个过程大约只需要几秒钟。

# 更新软件包索引
sudo apt update
# 安装 Redis
sudo apt install -y redis-server

说到底。 装好以后 你可以通过redis-cli ping来确认服务是否已经启动：

$ redis-cli ping
PONG

如果出现 PONG，恭喜，你已经拥有了一台“跑得快”的键值数据库小伙伴！不过它现在还是单点模式，需要进一步拆分成多个实例才能组成集群。

三、 为集群准备多实例配置文件

核心思路：每个实例拥有独立的端口号和数据目录，一边在配置里打开cluster-enabled yes。

下面给出一个常用的目录结构示例：

# 实例编号	端口号	配置文件路径	数据目录
1	7000	/etc/redis/redis-cluster-7000.conf	/var/lib/redis/7000
2	7001	/etc/redis/redis-cluster-7001.conf	/var/lib/redis/7001
3	7002	/etc/redis/redis-cluster-7002.conf	/var/lib/redis/7002
…… 同理创建 7003~7005

*温馨提示：复制原始配置文件时一定要保留原始权限，否 踩个点。 则后面启动会报 Permission denied。

# 为每个实例创建独立目录
for p in {7000..7005}; do
    sudo mkdir -p /var/lib/redis/$p
    sudo cp /etc/redis/redis.conf /etc/redis/redis-cluster-$p.conf
done

编辑每个配置`文件,设置不同的端口号和`集群`模式:，啊这...

# 示例：/etc/redis/redis-cluster-7000.conf
port 7000
cluster-enabled yes
cluster-config-file nodes-7000.conf
cluster-node-timeout 5000
appendonly yes          # 开启 AOF 持久化，平安感倍增！
protected-mode no       # 集群内部通信需要关闭保护模式
dir /var/lib/redis/7000 # 数据目录指向对应路径
# 对其余实例，只需把 port 与 dir 改成对应数字即可。

四、 启动所有 Redis 实例

AFAIK，有两种方式可以把六个实例一次性拉起来：手动逐个施行或写一个 systemd 服务模板。这里我们采用最直观的循环方式，只需一行命令就能让全部节点“活”起来，出岔子。。

# 批量启动六个实例
for p in {7000..7005}; do
    sudo redis-server /etc/redis/redis-cluster-$p.conf &
done
# 检查进程是否跑起来了
ps -ef | grep redis-server | grep -v grep

好吧... ⚠️ 如果你看到 “Address already in use”， 说明该端口被占用了请先检查是否已有旧实例残留。

五、使用 redis-cli 创建真正的集群！ 🎉

Eureka！所有节点已经就位，现在轮到把它们串联成一个整体了。 太刺激了。 这里我们用官方推荐的命令行工具完成创建：

深得我心。 # 创建包含 3 主 + 3 从 的完整集群 sudo redis-cli --cluster create \ 127.0.0.1:7000 127.0.0.1:7001 127.0.0.1:7002 \ 127.0.0.1:7003 127.0.0.1:7004 127.0.0.1:7005 \ --cluster-replicas 1

如果想让节点之间相互发现，还可以加上 `-- 干就完了！ cluster-yes` 参数直接跳过交互。

六、验证集群状态——我已经迫不及待想看看后来啊啦！

Aha， 一切搞定后用以下命令检查一下集群健康度：

# 查看整体信息 redis-cli -c -p 7000 cluster info，呵...

redis-cli -c -p 7000 cluster nodes，走捷径。

If everything is OK you’ll see something like:

# 节点示例输出 07c37df5a7e9a45e81d8c7f58d31a6bc8c9a6e71 :40000@40000 master - 1623949234009 ... ... fd8c23e9f85cfbbf6acde7ffcd19af09d7fe73fa :40003@40003 slave fd8c23e9f85cfbbf6acde7ffcd19af09d7fe73fa ... ... clusterstate:ok clusterslots_assigned:16384 ...，戳到痛处了。

七、监控 & 日常维护——别让“小毛病”暗中破坏你的高可用！

监控项 推荐工具或命令 备注 节点在线状态 redis-cli -c -p $PORT ping 返回 PONG 即表示健康 槽位分配均衡 redis-cli -c -p $PORT cluster info 若出现 cluster_slots_ok:16384 则说明全部槽位已覆盖 内存使用峰值 INFO memory 或者使用 Promeus+G 有啥用呢？ rafana 插件 注意 maxmemory-policy 配置防止 OOM 持久化延迟 观察 AOF rewrite in progress 与磁盘 I/O 指标 必要时调大 appendfsync 间隔或开启 RDB 快照 故障转移日志 查看 /var/log/redis/*.log 中 与 条目 及时处理网络抖动导致的节点失联 \end{table}

*温情提醒*：即使是自动故障转移， 也建议定期施行一次手工检查，比方说在业务低谷期运行 `sudo redis-cli --cluster check 127.0.0.1:7000`", 确认没有孤立节点。

八、 常见坑 & 调优技巧 🚀​​​​​​​​​​​​​‍‍‍‍‍‍‍‍‍‍🌀️️️️️️️️️⏰⏰⏰⏰⏰⏰⏰⏰⏰⏰🕒🕒🕒🕒🕒🕒🕒🕒🕒🕒📈📈📈📈📈📈📈📈📈📈🌟🌟🌟🌟🌟🌟🌟🌟🌟🌟👀👀👀👀👀👀👀👀👀👀💡💡💡💡💡💡💡💡💡💡🙌🙌🙌🙌🙌🙌🙌🙌🙌🙌🔧🔧🔧🔧🔧🔧🔧🔧🔧🔧✂️✂️✂️✂️✂️✂️✂️✂️✂️✂️)

COPY 命令导致卡顿：aof 重写期间最好暂时关闭 COPY，否则大量复制操作会阻塞主线程。 让我们一起... 可以通过修改 client-output-buffer-limit normal … 来缓冲。

NAT 环境下 IP 地址不一致：a) 确保所有节点在同一子网；b) 在 nodes-${port}.conf 中加入 bind {{本机IP}}; c) 若跨机房部署，需要开启 protected-mode no. 那么外部连接才不会被拒绝，被割韭菜了。。

格局小了。 SLOWLOG 超阈值频繁触发：SLOWLOG 默认记录施行时间超过10 ms 的命令，可适当调大阈值或排查热点 key。   🤔  😅  😂    😁     😎        🔥     🙄        😱       😜 🥳 🙊 🎉 📚 ⚙︎ 🐢 🐇 🚦 🍃 🌱 🌿 🍁 🍂 🌾 💦 ☔ ⛈

Cassandra‐like “key space explosion”：** 当业务层面不断生成新前缀而忘记清理，会导致 slot 分配失衡。解决办法是定期做 key‐scan+del 或者使用 TTL 自动过期。

maxmemory-policy volatile-lru: ** 有些业务只想淘汰带过期时间的数据，可改为 allkeys-lfu 提升缓存利用率。”，别犹豫...

ufw 防火墙误拦截: ** 别忘了放通内部通信端口，不然即使 node 启 恕我直言... 动成功也会一直报 “Cluster bus error”。如下操作必不可少：

客观地说... # 放通全部 cluster 所需端口 for p in {7000..7015}; do sudo ufw allow $p; done sudo ufw reload

九、 收尾感言——从零到上线，你做到了！

---

©2026 技术分享社区 · 保留所有权利 | 如有转载请注明来源 | 联系我们：   

---