hezhijie0327/valkey Docker 镜像 - 轩辕镜像

Valkey Docker镜像

概述

Valkey是一个高性能的开源键值存储系统，兼容Redis协议。本Docker镜像提供了Valkey服务的便捷部署方式，包含预配置的核心参数，可快速启动Valkey实例，适用于开发、测试及轻量级生产环境。

核心功能与特性

• 主动碎片整理：通过--activedefrag yes启用主动内存碎片整理，优化内存使用效率
• 混合持久化：配置--aof-use-rdb-preamble yes实现AOF文件中包含RDB前缀，兼顾持久化性能与数据安全性
• AOF持久化：默认启用AOF（--appendonly yes），并设置每秒同步（--appendfsync everysec）
• 惰性内存释放：通过lazyfree系列参数（lazyfree-lazy-eviction、lazyfree-lazy-expire等）实现内存惰性释放，减少阻塞
• LFU缓存策略：配置--lfu-decay-time 1和--lfu-log-factor 10启用LFU（最近最少使用）淘汰策略
• 内存管理：支持设置最大内存（--maxmemory）及内存淘汰策略（--maxmemory-policy volatile-ttl）

使用场景

• 开发环境中快速搭建Valkey服务进行功能测试
• 轻量级生产环境的键值存储需求
• 需要兼容Redis协议的应用场景
• 对内存使用效率有要求的缓存服务部署

使用方法

1. 基本部署（桥接网络模式）

适用于需要网络隔离的场景，通过端口映射对外提供服务：

bash
docker run --name valkey --net bridge --restart=always \
    -v /path/to/data:/etc/valkey/data \  # 挂载数据目录，持久化存储
    -p 6379:6379/tcp \                  # 映射Valkey默认端口
    -d hezhijie0327/valkey:latest \     # 后台运行镜像
    --activedefrag yes \                # 启用主动碎片整理
    --aof-use-rdb-preamble yes \        # 启用AOF+RDB混合持久化
    --appendfsync everysec \            # AOF每秒同步
    --appendonly yes \                  # 启用AOF持久化
    --dir /etc/valkey/data \            # 数据存储目录
    --lazyfree-lazy-eviction yes \      # 惰性释放淘汰键内存
    --lazyfree-lazy-expire yes \        # 惰性释放过期键内存
    --lazyfree-lazy-server-del yes \    # 惰性释放服务器删除操作内存
    --lazyfree-lazy-user-del yes \      # 惰性释放用户删除操作内存
    --lazyfree-lazy-user-flush yes \    # 惰性释放用户FLUSH操作内存
    --lfu-decay-time 1 \                # LFU衰减时间（分钟）
    --lfu-log-factor 10 \               # LFU对数因子
    --maxmemory 4MB \                   # 最大内存限制（可根据需求调整）
    --maxmemory-policy volatile-ttl \   # 内存淘汰策略：优先淘汰带TTL的键
    --maxmemory-samples 10 \            # 内存淘汰采样数量
    --port 6379 \                       # 服务端口
    --replica-lazy-flush yes            # 从节点惰性刷新数据

2. 主机网络模式部署

适用于需要直接使用主机网络的场景，性能更优但网络隔离性较低：

bash
docker run --name valkey --net host --restart=always \
    -v /path/to/data:/etc/valkey/data \  # 挂载数据目录
    -d hezhijie0327/valkey:latest \     # 后台运行镜像
    # 其他Valkey配置参数与桥接模式相同
    --activedefrag yes \
    --aof-use-rdb-preamble yes \
    --appendfsync everysec \
    --appendonly yes \
    --dir /etc/valkey/data \
    --lazyfree-lazy-eviction yes \
    --lazyfree-lazy-expire yes \
    --lazyfree-lazy-server-del yes \
    --lazyfree-lazy-user-del yes \
    --lazyfree-lazy-user-flush yes \
    --lfu-decay-time 1 \
    --lfu-log-factor 10 \
    --maxmemory 4MB \
    --maxmemory-policy volatile-ttl \
    --maxmemory-samples 10 \
    --port 6379 \
    --replica-lazy-flush yes

3. 使用valkey-cli连接服务

通过容器内的valkey-cli工具连接Valkey服务：

bash
docker run -it --rm --entrypoint=/valkey-cli \  # 指定入口为valkey-cli
    hezhijie0327/valkey:latest \              # 使用Valkey镜像
    -p 6379 \                                 # 连接端口
    info                                      # 执行info命令查看服务信息

4. 使用valkey-benchmark进行性能测试

通过容器内的valkey-benchmark工具测试服务性能：

bash
docker run -it --rm --entrypoint=/valkey-benchmark --net host \  # 使用主机网络提升测试准确性
    hezhijie0327/valkey:latest \                               # 使用Valkey镜像
    -p 6379                                                    # 测试目标端口

配置参数说明

注：所有Valkey配置参数均可通过docker run命令追加，具体可参考Valkey官方文档调整。