bitnamisecure/valkey

Bitnami 安全镜像：Valkey

什么是 Valkey？

Valkey 是一个高性能数据结构服务器，主要用于处理键/值工作负载。它支持多种原生数据结构和可扩展的插件系统，用于添加新的数据结构和访问模式。

Valkey 概述
商标声明：本软件列表由 Bitnami 打包。所提及的相关商标归各自公司所有，使用这些商标并不意味着任何关联或背书。

快速入门

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

警告：这些快速设置仅适用于开发环境。建议您更改不安全的默认凭据，并查看配置部分中的可用配置选项，以实现更安全的部署。

为什么使用 Bitnami 安全镜像？

这些是由 Bitnami 构建和维护的强化、最小化 CVE 镜像。Bitnami 安全镜像基于云优化、安全强化的企业级 https://vmware.github.io/photon/%E3%80%82%E9%80%89%E6%8B%A9 BSI 镜像的理由：

• 流行开源软件的强化安全镜像，具有近零漏洞
• 漏洞分类与优先级划分，包含 VEX 声明、KEV 和 EPSS 评分
• 专注合规性，支持 FIPS、STIG 和离线选项，包括安全物料清单（SBOM）
• 通过 in-toto 提供软件供应链来源证明
• 为互联网上最受欢迎的 Helm 图表提供一流支持

每个镜像都附带有价值的安全元数据。您可以在 我们的公共目录 中查看元数据。注意：某些数据仅对 BSI 商业订阅用户 开放。

!https://github.com/bitnami/containers/blob/main/BSI%20UI%201.png?raw=true "Application details" !https://github.com/bitnami/containers/blob/main/BSI%20UI%202.png?raw=true "Packaging report"

如果您正在寻找基于 Debian Linux 的上一代镜像，请参见 https://hub.docker.com/u/bitnamilegacy%E3%80%82

如何在 Kubernetes 中部署 Valkey？

将 Bitnami 应用部署为 Helm Chart 是在 Kubernetes 上使用我们应用的最简单方式。有关安装的更多信息，请参见 https://github.com/bitnami/charts/tree/master/bitnami/valkey%E3%80%82

为什么使用非 root 容器？

非 root 容器镜像增加了一层额外的安全性，通常推荐用于生产环境。但是，由于它们以非 root 用户运行，通常无法执行特权任务。在 我们的文档 中了解更多关于非 root 容器的信息。

支持的标签及对应的 Dockerfile 链接

了解 Bitnami 标签策略以及滚动标签和不可变标签之间的区别，请参见 我们的文档页面。

您可以通过查看分支文件夹中的 tags-info.yaml 文件（即 bitnami/ASSET/BRANCH/DISTRO/tags-info.yaml）来了解不同标签之间的对应关系。

通过关注 https://github.com/bitnami/containers 订阅项目更新。

获取此镜像

获取 Bitnami Valkey Docker 镜像的推荐方式是从 https://hub.docker.com/r/bitnami/valkey 拉取预构建镜像。

console
docker pull REGISTRY_NAME/bitnami/valkey:latest

要使用特定版本，您可以拉取带版本的标签。您可以在 Docker Hub 仓库中查看 https://hub.docker.com/r/bitnami/valkey/tags/%E3%80%82

console
docker pull REGISTRY_NAME/bitnami/valkey:[TAG]

如果需要，您也可以通过克隆仓库、切换到包含 Dockerfile 的目录并执行 docker build 命令来自建镜像。请记住在以下示例命令中用正确的值替换 APP、VERSION 和 OPERATING-SYSTEM 路径占位符。

console
git clone https://github.com/bitnami/containers.git
cd bitnami/APP/VERSION/OPERATING-SYSTEM
docker build -t REGISTRY_NAME/bitnami/APP:latest .

持久化数据库

Valkey 提供多种 持久化选项。此容器默认使用 AOF 持久化，但您可以在 docker-compose.yaml 文件中通过添加 command: /opt/bitnami/scripts/valkey/run.sh --appendonly no 来覆盖此配置。或者，您也可以使用 VALKEY_AOF_ENABLED 环境变量，如 https://github.com/bitnami/containers/blob/main/bitnami/valkey#disabling-aof-persistence 中所述。

如果删除容器，所有数据都将丢失，下次运行镜像时数据库将重新初始化。为避免数据丢失，您应该挂载一个在容器删除后仍能保留的卷。

要实现持久化，您应该在 /bitnami 路径挂载一个目录。如果挂载的目录为空，将在首次运行时初始化。

console
docker run \
    -e ALLOW_EMPTY_PASSWORD=yes \
    -v /path/to/valkey-persistence:/bitnami/valkey/data \
    REGISTRY_NAME/bitnami/valkey:latest

您也可以通过修改此仓库中的 https://github.com/bitnami/containers/blob/main/bitnami/valkey/docker-compose.yml 文件来实现：

yaml
services:
  valkey:
  ...
    volumes:
      - /path/to/valkey-persistence:/bitnami/valkey/data
  ...

注意：由于这是一个非 root 容器，挂载的文件和目录必须对 UID 1001 具有适当的权限。

连接到其他容器

使用 Docker 容器网络，运行在容器内的 Valkey 服务器可以轻松被应用容器访问。

连接到同一网络的容器可以使用容器名称作为主机名进行通信。

使用命令行

在此示例中，我们将创建一个 Valkey 客户端实例，它将连接到与客户端在同一 docker 网络上运行的服务器实例。

步骤 1：创建网络

console
docker network create app-tier --driver bridge

步骤 2：启动 Valkey 服务器实例

使用 --network app-tier 参数执行 docker run 命令，将 Valkey 容器附加到 app-tier 网络。

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

步骤 3：启动 Valkey 客户端实例

最后，我们创建一个新的容器实例来启动 Valkey 客户端，并连接到上一步创建的服务器：

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

使用 Docker Compose 文件

未指定时，Docker Compose 会自动设置一个新网络，并将所有部署的服务附加到该网络。但是，我们将显式定义一个名为 app-tier 的新 bridge 网络。在此示例中，假设您希望从自己的自定义应用镜像（在以下代码片段中由服务名称 myapp 标识）连接到 Valkey 服务器。

yaml
version: '2'

networks:
  app-tier:
    driver: bridge

services:
  valkey:
    image: REGISTRY_NAME/bitnami/valkey:latest
    environment:
      - ALLOW_EMPTY_PASSWORD=yes
    networks:
      - app-tier
  myapp:
    image: YOUR_APPLICATION_IMAGE
    networks:
      - app-tier

重要提示：

1. 请将上述代码片段中的 YOUR_APPLICATION_IMAGE 占位符替换为您的应用镜像
2. 在应用容器中，使用主机名 valkey 连接到 Valkey 服务器

使用以下命令启动容器：

console
docker-compose up -d

配置

环境变量

可自定义环境变量

只读环境变量

禁用 Valkey 命令

出于安全原因，您可能需要禁用某些命令。首次运行时，可以使用以下环境变量指定要禁用的命令：

• VALKEY_DISABLE_COMMANDS：要禁用的 Valkey 命令的逗号分隔列表。默认为空。

console
docker run --name valkey -e VALKEY_DISABLE_COMMANDS=FLUSHDB,FLUSHALL,CONFIG REGISTRY_NAME/bitnami/valkey:latest

或者，修改此仓库中的 https://github.com/bitnami/containers/blob/main/bitnami/valkey/docker-compose.yml 文件：

yaml
services:
  valkey:
  ...
    environment:
      - VALKEY_DISABLE_COMMANDS=FLUSHDB,FLUSHALL,CONFIG
  ...

如 docker-compose 中所指定，FLUSHDB 和 FLUSHALL 命令被禁用。如果不想禁用任何命令，请注释或删除该环境变量：

yaml
services:
  valkey:
  ...
    environment:
      # - VALKEY_DISABLE_COMMANDS=FLUSHDB,FLUSHALL
  ...

向 valkey-server 启动命令传递额外命令行标志

可以通过将额外命令行标志作为 run.sh 脚本的参数来传递给 valkey 服务命令：

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

或者，修改此仓库中的 https://github.com/bitnami/containers/blob/main/bitnami/valkey/docker-compose.yml 文件：

yaml
services:
  valkey:
  ...
    environment:
      - ALLOW_EMPTY_PASSWORD=yes
    command: /opt/bitnami/scripts/valkey/run.sh --maxmemory 100mb
  ...

首次运行时设置服务器密码

首次运行镜像时传递 VALKEY_PASSWORD 环境变量，会将 Valkey 服务器密码设置为 VALKEY_PASSWORD 的值（或 VALKEY_PASSWORD_FILE 中指定的文件内容）。

console
docker run --name valkey -e VALKEY_PASSWORD=password123 REGISTRY_NAME/bitnami/valkey:latest

或者，修改此仓库中的 [docker-compose.yml](https://github.com/bitnami/containers/blob/main/bit