valkey

Valkey 内存数据库

补充说明

Valkey 是 Redis 的开源分支，协议和命令高度兼容，由 Linux 基金会托管。多数 Redis 客户端可以直连 Valkey，适合希望保持 Redis 生态但使用更宽松许可证的场景。

常用示例

启动服务：

valkey-server /etc/valkey/valkey.conf
valkey-cli ping

常用数据操作：

valkey-cli SET user:1 '{"name":"alice"}' EX 3600
valkey-cli GET user:1
valkey-cli HSET session:1 uid 1001 ttl 3600
valkey-cli EXPIRE session:1 3600

查看状态：

valkey-cli INFO server
valkey-cli INFO memory
valkey-cli INFO replication
valkey-cli --bigkeys

配置复制：

valkey-cli REPLICAOF primary 6379
valkey-cli INFO replication

创建 ACL 用户：

valkey-cli ACL SETUSER app on '>***' '~app:*' +@read +@write

持久化：

valkey-cli CONFIG SET appendonly yes
valkey-cli BGREWRITEAOF

易错点与排错

• 直接复用 Redis 的模块，Valkey 没有对应模块。
• 主从复制未追平就切换，丢失最后一批写入。
• maxmemory 未设置，内存耗尽被 OOM Killer 终止。
• 淘汰策略与业务不符，热点 key 被频繁淘汰。
• ACL 规则过宽或过窄，客户端报 NOPERM。
• AOF 和 RDB 同时开启但磁盘不足，持久化失败。
• 集群模式下多 key 操作跨 slot，报 CROSSSLOT。
• 大 key 删除阻塞主线程，使用 UNLINK 异步删除。