如何设置Redis集群maxmemory参数

在 Redis 集群中配置内存限制，并非全局统一设置即可完成，而是需要为每个节点单独配置 maxmemory 参数。以下详细介绍操作流程及背后的设计思路。

设置步骤

1. 连接到每个集群节点

首先获取所有节点的信息，这是操作的基础：

# 获取所有集群节点信息
redis-cli -c CLUSTER NODES
# 示例输出：
d1861060fe6a534d42d8a19aeb36600e18785e04 127.0.0.1:7001@17001 master - 0 1620000000000 1 connected 0-5460
2809279eb7dbfa1b2d5e7e9c3e8d4f5a6b7c8d9e0 127.0.0.1:7002@17002 master - 0 1620000000000 2 connected 5461-10922

2. 为每个节点设置 maxmemory

连接到第一个节点，设置内存上限和淘汰策略：

# 连接到第一个节点
redis-cli -h 127.0.0.1 -p 7001
# 设置 2GB 内存限制
127.0.0.1:7001> CONFIG SET maxmemory 2gb
OK
# 设置淘汰策略（推荐 allkeys-lru）
127.0.0.1:7001> CONFIG SET maxmemory-policy allkeys-lru
OK
# 验证设置
127.0.0.1:7001> CONFIG GET maxmemory
1) "maxmemory"
2) "2147483648"
# 对其他节点重复相同操作

3. 修改配置文件（永久生效）

动态设置仅对当前会话有效，要使重启后依然生效，需写入每个节点的 redis.conf：

# 设置最大内存为 2GB
maxmemory 2gb
# 设置内存淘汰策略
maxmemory-policy allkeys-lru
# 集群模式特定配置
cluster-enabled yes
cluster-node-timeout 15000
cluster-config-file nodes.conf

4. 批量设置脚本

节点较多时，手动操作效率低下。编写脚本批量处理：

#!/bin/bash
# 节点列表
NODES=(
    "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"
    "127.0.0.1:7006"
)

MEMORY_LIMIT="2gb"  # 内存限制
POLICY="allkeys-lru" # 淘汰策略

for node in "${NODES[@]}"; do
    ip=${node%:*}
    port=${node#*:}
    
    echo "Configuring $ip:$port"
    
    redis-cli -h $ip -p $port CONFIG SET maxmemory $MEMORY_LIMIT
    redis-cli -h $ip -p $port CONFIG SET maxmemory-policy $POLICY
    redis-cli -h $ip -p $port CONFIG REWRITE
    
    # 验证配置
    redis-cli -h $ip -p $port CONFIG GET maxmemory
    redis-cli -h $ip -p $port CONFIG GET maxmemory-policy
done

集群内存管理最佳实践

1. 内存分配策略

内存分配方案可通过下表清晰了解：

节点类型	推荐内存比例	说明
主节点	70-80% 系统内存	存储实际数据
从节点	等同主节点	保证故障转移能力
集群管理节点	1-2GB	运行集群管理进程

2. 监控关键指标

# 查看集群内存使用概览
redis-cli -c --cluster check 127.0.0.1:7001
# 检查单个节点内存
redis-cli -h 127.0.0.1 -p 7001 INFO memory

需重点关注以下指标：

• used_memory_human：当前使用内存
• maxmemory_human：配置的最大内存
• mem_fragmentation_ratio：内存碎片率
• evicted_keys：因内存不足被淘汰的键数量

3. 内存优化技巧

1. 使用 Hash 分片：将大键拆分为小份，减少内存开销。

   HSET user:1000 profile:basic "name,age"
   HSET user:1000 profile:contact "email,phone"

2. 启用内存压缩：

   # redis.conf
   hash-max-ziplist-entries 512
   hash-max-ziplist-value 64
   list-max-ziplist-size -2

3. 定期执行内存整理：

   # Redis 4.0+ 内存碎片整理
   redis-cli -h 127.0.0.1 -p 7001 MEMORY PURGE

4. 集群扩容策略

当内存使用超过 80% 时，应考虑扩容：

# 添加新节点
redis-cli --cluster add-node 127.0.0.1:7007 127.0.0.1:7001
# 迁移槽位
redis-cli --cluster reshard 127.0.0.1:7001

高级配置

1. 不同节点设置不同内存限制

硬件配置不同时，内存上限可差异化设置：

# 高负载节点设置更大内存
redis-cli -h 127.0.0.1 -p 7001 CONFIG SET maxmemory 4gb
# 低负载节点设置较小内存
redis-cli -h 127.0.0.1 -p 7002 CONFIG SET maxmemory 1gb

2. 动态调整策略

更自动化的方式是根据内存使用率动态调整：

#!/bin/bash
# 自动调整内存脚本
THRESHOLD=90 # 内存使用阈值%

for node in "${NODES[@]}"; do
    ip=${node%:*}
    port=${node#*:}
    
    # 获取内存使用率
    usage=$(redis-cli -h $ip -p $port INFO memory | grep -oP 'mem_allocated_percent:\d+')
    
    if [ $usage -gt $THRESHOLD ]; then
        # 增加 10% 内存
        current_mem=$(redis-cli -h $ip -p $port CONFIG GET maxmemory | tail -1)
        new_mem=$((current_mem * 11 / 10))
        redis-cli -h $ip -p $port CONFIG SET maxmemory $new_mem
        echo "Increased memory on $ip:$port to $new_mem"
    fi
done

3. 使用 Redis 模块优化内存

针对特定场景（如去重或搜索），Redis 模块能显著节省内存：

# 加载内存优化模块
loadmodule /path/to/redisbloom.so
loadmodule /path/to/redisearch.so
# 使用 Bloom 过滤器
BF.RESERVE users 0.01 1000000

故障排除

常见问题及解决方案

问题	症状	解决方案
内存不足	OOM command not allowed 错误	增加 maxmemory 或优化数据结构
高内存碎片	mem_fragmentation_ratio > 1.5	执行 MEMORY PURGE 或重启节点
淘汰率过高	evicted_keys 快速增加	调整淘汰策略或增加内存
槽位不均衡	部分节点内存使用率高	重新分配槽位 redis-cli --cluster rebalance

诊断命令

# 查找内存消耗大的键
redis-cli -h 127.0.0.1 -p 7001 --bigkeys
# 内存分析
redis-cli -h 127.0.0.1 -p 7001 MEMORY STATS
# 监控淘汰事件
redis-cli -h 127.0.0.1 -p 7001 MONITOR | grep evicted

生产环境建议

正式上线前，需提前规划以下事项：

1. 监控系统：使用 Prometheus + Grafana 监控集群内存，设置阈值告警（如超过 85% 触发报警）。
2. 备份策略：定期备份集群配置。

redis-cli CLUSTER NODES > cluster-backup-$(date +%F).txt

3. 安全配置：防止 CONFIG 命令被未经授权使用。

# redis.conf
rename-command CONFIG "REDISCONFIG"
requirepass "strongpassword"
masterauth "replicationpassword"

4. 滚动重启：需要重启节点时，逐个进行，避免同时操作。

for port in {7001..7006}; do
  redis-cli -h 127.0.0.1 -p $port CLUSTER FAILOVER TAKEOVER
  redis-cli -h 127.0.0.1 -p $port shutdown
  sleep 5
  redis-server /path/to/redis-$port.conf
  sleep 10
done

配置示例文件

以下为完整的 redis-cluster-node.conf 示例，可直接参考修改：

# 基本配置
port 7001
cluster-enabled yes
cluster-config-file nodes.conf
cluster-node-timeout 15000

# 内存管理
maxmemory 4gb
maxmemory-policy allkeys-lru

# 持久化
appendonly yes
appendfilename "appendonly.aof"
aof-rewrite-incremental-fsync yes

# 安全
requirepass "your_strong_password"
masterauth "replication_password"

# 优化
hash-max-ziplist-entries 512
hash-max-ziplist-value 64
activerehashing yes

总结

Redis 集群的 maxmemory 配置，核心要点如下：

• 单独配置：每个节点独立设置，不可统一处理。
• 统一策略：全集群采用相同的淘汰策略，避免不同节点策略不一致导致的隐患。
• 动态调整：负载变化时，内存限制也需相应调整。
• 监控预警：80% 内存使用率为警戒线，超过后需及时处理。
• 定期优化：进行碎片整理和数据结构优化，防止问题发生。
• 容量规划：预留冗余空间，确保故障转移时有足够资源。

合理配置 maxmemory 和淘汰策略，结合监控与自动化工具，能够使 Redis 集群在高负载下稳定运行。否则，一次内存溢出便可能导致线上事故。