Bitnami Valkey 镜像文档

⚠️ 重要通知：Bitnami 镜像目录即将变更

自2025年8月28日起，Bitnami将升级其公共镜像目录，通过新的Bitnami Secure Images计划提供精选的强化安全镜像。过渡期安排如下：

• 首次向社区用户开放热门容器镜像的安全优化版本。
• Bitnami将逐步弃用免费 tier 中非强化的 Debian 基础镜像，并从公共目录中移除非最新标签。社区用户将只能访问数量减少的强化镜像，这些镜像仅以“latest”标签发布，适用于开发场景。
• 8月28日起两周内，所有现有容器镜像（包括旧版本标签，如2.50.0、10.6）将从公共目录（docker.io/bitnami）迁移至“Bitnami Legacy”仓库（docker.io/bitnamilegacy），且不再接收更新。
• 对于生产工作负载和长期支持，建议采用Bitnami Secure Images，包含强化容器、更小攻击面、CVE透明度（通过VEX/KEV）、SBOM及企业支持。

更多详情见Bitnami Secure Images公告。

为什么使用Bitnami Secure Images？

• 安全强化：专为开源软件的安全性和企业就绪性设计，通过VEX、KEV和EPSS评分提供CVE风险透明度。
• 最小化攻击面：基于Photon Linux构建，采用行业标准包格式，兼顾精简性和可扩展性。
• 持续更新：上游补丁发布后数小时内完成镜像更新，确保安全性和合规性。
• 跨格式一致性：容器、虚拟机和云镜像使用相同组件和配置方式，便于根据需求切换。
• 完整供应链保障：提供签名验证（Notation）、SBOM、病毒扫描报告等元数据，符合SLSA-3标准。

镜像概述和主要用途

Valkey简介

Valkey是一款开源（BSD许可）的高性能键值数据库，支持缓存、消息队列、主数据库等多种工作负载，兼容Redis协议，提供亚毫秒级响应性能。

Bitnami Valkey镜像特点

Bitnami Valkey镜像是Valkey的容器化分发版本，提供以下优势：

• 非root用户运行，增强安全性
• 预配置的持久化策略（默认AOF）
• 支持主从复制、ACL访问控制等高级特性
• 丰富的环境变量配置，简化部署流程
• 与Kubernetes、Docker Compose等工具无缝集成

核心功能和特性

• 多模式支持：兼容缓存、消息队列（Pub/Sub）、主数据库等场景
• 持久化选项：默认启用AOF（Append Only File），支持RDB快照策略
• 安全加固：非root容器运行，可禁用危险命令（如FLUSHDB、CONFIG）
• 主从复制：通过环境变量快速配置主从架构，支持读写分离
• 访问控制：支持ACL（Access Control List），限制命令执行和键访问权限
• 灵活配置：通过环境变量或配置文件覆盖默认参数，支持自定义端口、数据目录等

使用场景和适用范围

• 开发环境：快速部署Valkey实例，用于应用调试和功能验证
• 缓存系统：作为应用缓存层，提升读操作性能（如会话存储、热点数据缓存）
• 消息队列：基于Pub/Sub实现简单的消息传递系统
• 主数据库：轻量级键值存储需求，如计数器、排行榜、实时分析
• 生产环境：采用Bitnami Secure Images，适用于对安全性和稳定性要求高的生产工作负载

详细使用方法和配置说明

获取镜像

拉取预构建镜像

推荐从Docker Hub拉取最新版：

docker pull bitnami/valkey:latest

指定版本（查看可用标签）：

docker pull bitnami/valkey:[TAG]  # 如bitnami/valkey:7.2.4

本地构建镜像

克隆仓库并构建（替换APP、VERSION、OPERATING-SYSTEM占位符）：

git clone [***]
cd bitnami/APP/VERSION/OPERATING-SYSTEM
docker build -t bitnami/APP:latest .

基本部署

快速启动（开发环境）

docker run --name valkey -e ALLOW_EMPTY_PASSWORD=yes bitnami/valkey:latest

警告：此配置仅适用于开发环境，生产环境需设置密码并调整安全参数。

Docker Compose部署

创建docker-compose.yml：

version: '2'
services:
  valkey:
    image: bitnami/valkey:latest
    environment:
      - ALLOW_EMPTY_PASSWORD=yes  # 开发环境允许空密码
      # - VALKEY_PASSWORD=your_secure_password  # 生产环境建议设置密码
    ports:
      - "6379:6379"
    volumes:
      - valkey-data:/bitnami/valkey/data  # 持久化数据卷

volumes:
  valkey-data:

启动服务：

docker-compose up -d

数据持久化

Valkey数据默认存储在/bitnami/valkey/data，移除容器后数据会丢失。通过挂载卷实现持久化：

Docker命令方式

docker run \
  -e ALLOW_EMPTY_PASSWORD=yes \
  -v /path/to/local/data:/bitnami/valkey/data \  # 本地目录挂载
  bitnami/valkey:latest

Docker Compose方式

在docker-compose.yml中添加卷配置（见上文示例），确保挂载目录对UID 1001有读写权限（非root容器要求）。

与其他容器通信

通过Docker网络实现容器间通信，使用容器名作为主机名。

命令行方式

1. 创建网络：

docker network create app-tier --driver bridge

2. 启动Valkey服务：

docker run -d --name valkey-server \
  -e ALLOW_EMPTY_PASSWORD=yes \
  --network app-tier \
  bitnami/valkey:latest

3. 启动客户端容器（连接Valkey）：

docker run -it --rm \
  --network app-tier \
  bitnami/valkey:latest valkey-cli -h valkey-server

Docker Compose方式

version: '2'
networks:
  app-tier:
    driver: bridge
services:
  valkey:
    image: bitnami/valkey:latest
    environment:
      - ALLOW_EMPTY_PASSWORD=yes
    networks:
      - app-tier
  myapp:  # 你的应用容器
    image: YOUR_APPLICATION_IMAGE  # 替换为实际应用镜像
    networks:
      - app-tier
    # 应用中使用主机名"valkey"连接Valkey服务

配置说明

环境变量

通过环境变量自定义Valkey行为，分为可定制变量和只读变量。

可定制环境变量

只读环境变量（运行时自动设置）

常见配置场景

禁用危险命令

通过VALKEY_DISABLE_COMMANDS禁用高风险命令（如FLUSHDB、CONFIG）：

docker run --name valkey \
  -e ALLOW_EMPTY_PASSWORD=yes \
  -e VALKEY_DISABLE_COMMANDS=FLUSHDB,FLUSHALL,CONFIG \
  bitnami/valkey:latest

传递额外启动参数

通过VALKEY_EXTRA_FLAGS或命令参数传递自定义配置（如内存限制）：

docker run --name valkey \
  -e ALLOW_EMPTY_PASSWORD=yes \
  bitnami/valkey:latest /opt/bitnami/scripts/valkey/run.sh --maxmemory 100mb

设置服务密码

生产环境必须设置密码，通过VALKEY_PASSWORD指定：

docker run --name valkey \
  -e VALKEY_PASSWORD=your_secure_password \  # 不支持包含@符号
  bitnami/valkey:latest

禁用AOF持久化

默认启用AOF，通过VALKEY_AOF_ENABLED=no禁用：

docker run --name valkey \
  -e ALLOW_EMPTY_PASSWORD=yes \
  -e VALKEY_AOF_ENABLED=no \
  bitnami/valkey:latest

启用访问控制列表（ACL）

挂载ACL配置文件并通过VALKEY_ACLFILE指定路径：

docker run --name valkey \
  -e VALKEY_ACLFILE=/opt/bitnami/valkey/mounted-etc/users.acl \
  -v /path/to/local/users.acl:/opt/bitnami/valkey/mounted-etc/users.acl \
  bitnami/valkey:latest

users.acl示例：

user alice on >password ~* +@all  # 允许访问所有键和命令
user bob on >password ~user:* +get  # 仅允许读取user:*键

配置主从复制

1. 启动主节点：

docker run --name valkey-primary \
  -e VALKEY_REPLICATION_MODE=primary \
  -e VALKEY_PASSWORD=primarypass \
  bitnami/valkey:latest

2. 启动从节点（连接主节点）：

docker run --name valkey-replica \
  --link valkey-primary:primary \  # 链接主节点容器
  -e VALKEY_REPLICATION_MODE=replica \
  -e VALKEY_PRIMARY_HOST=primary \  # 主节点主机名（容器名）
  -e VALKEY_PRIMARY_PORT_NUMBER=6379 \
  -e VALKEY_PRIMARY_PASSWORD=primarypass \  # 主节点密码
  -e VALKEY_PASSWORD=replicapass \  # 从节点自身密码
  bitnami/valkey:latest

Kubernetes部署

通过Helm Chart部署是在Kubernetes上使用Bitnami应用的推荐方式，详见Bitnami Valkey Chart GitHub仓库。

总结

Bitnami Valkey镜像提供了安全、灵活、易于部署的Valkey容器化方案，支持开发和生产环境。通过环境变量和卷挂载可快速配置持久化、主从复制、ACL等高级特性，结合Bitnami Secure Images可满足企业级安全需求。