bitnamisecure/memcached

Bitnami Memcached 镜像

什么是 Memcached？

Memcached 是一个高性能、分布式内存对象缓存系统，通用性强，主要用于通过减轻数据库负载来加速动态Web应用。

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

快速启动

console
docker run --name memcached REGISTRY_NAME/bitnami/memcached:latest

为什么使用 Bitnami 安全镜像？

• Bitnami 安全镜像和 Helm 图表旨在使开源软件更安全且适合企业使用。
• 使用行业标准的漏洞可利用性交换 (VEX)、KEV 和 EPSS 评分，更快地分类安全漏洞，并透明了解 CVE 风险。
• 我们的加固镜像使用最小化操作系统 (Photon Linux)，减少***面，同时通过行业标准包格式保持可扩展性。
• 持续构建的镜像在上游补丁发布后数小时内更新，帮助您保持更安全的合规状态。
• Bitnami 容器、虚拟机和云镜像使用相同的组件和配置方法，便于根据项目需求在不同格式之间切换。
• 加固镜像附带证明签名 (Notation)、SBOM、病毒扫描报告和其他元数据，这些元数据在符合 SLSA-3 标准的软件工厂中生成。

仅有部分 BSI 应用可免费使用。想要访问全部应用目录及企业支持？立即尝试 Bitnami 安全镜像商业版。

如何在 Kubernetes 中部署 Memcached？

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

为什么使用非 root 容器？

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

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

了解更多关于 Bitnami 标签策略以及滚动标签和不可变标签之间的区别，请参阅我们的文档页面 in our documentation page。

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

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

获取此镜像

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

console
docker pull REGISTRY_NAME/bitnami/memcached:latest

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

console
docker pull REGISTRY_NAME/bitnami/memcached:[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 .

连接到其他容器

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

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

使用命令行

步骤 1：创建网络

console
docker network create app-tier --driver bridge

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

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

console
docker run -d --name memcached-server \
    --network app-tier \
    REGISTRY_NAME/bitnami/memcached:latest

步骤 3：启动应用容器

console
docker run -d --name myapp \
    --network app-tier \
    YOUR_APPLICATION_IMAGE

重要提示：

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

使用 Docker Compose 文件

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

yaml
version: '2'

networks:
  app-tier:
    driver: bridge

services:
  memcached:
    image: REGISTRY_NAME/bitnami/memcached:latest
    networks:
      - app-tier
  myapp:
    image: YOUR_APPLICATION_IMAGE
    networks:
      - app-tier

重要提示：

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

使用以下命令启动容器：

console
docker-compose up -d

配置

环境变量

可自定义环境变量

只读环境变量

指定缓存大小

默认情况下，Bitnami Memcached 容器不会指定任何缓存大小，将使用 Memcached 默认值（64MB）启动。您可以使用 MEMCACHED_CACHE_SIZE 环境变量（以 MB 为单位）指定不同的值。

console
docker run --name memcached -e MEMCACHED_CACHE_SIZE=128 REGISTRY_NAME/bitnami/memcached:latest

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

yaml
services:
  memcached:
  ...
    environment:
      - MEMCACHED_CACHE_SIZE=128
  ...

指定最大并发连接数

默认情况下，Bitnami Memcached 容器不会指定最大并发连接数，将使用 Memcached 默认值（1024 个并发连接）启动。您可以使用 MEMCACHED_MAX_CONNECTIONS 环境变量指定不同的值。

console
docker run --name memcached -e MEMCACHED_MAX_CONNECTIONS=2000 REGISTRY_NAME/bitnami/memcached:latest

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

yaml
services:
  memcached:
  ...
    environment:
      - MEMCACHED_MAX_CONNECTIONS=2000
  ...

指定处理请求的线程数

默认情况下，Bitnami Memcached 容器不会指定处理请求的线程数，将使用 Memcached 默认值（4 个线程）启动。您可以使用 MEMCACHED_THREADS 环境变量指定不同的值。

console
docker run --name memcached -e MEMCACHED_THREADS=4 REGISTRY_NAME/bitnami/memcached:latest

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

yaml
services:
  memcached:
  ...
    environment:
      - MEMCACHED_THREADS=4
  ...

指定最大项目大小（slab 大小）

默认情况下，Memcached 容器不会指定最大项目大小，将使用 Memcached 默认值（*** ~ 1 兆字节）启动。您可以使用 MEMCACHED_MAX_ITEM_SIZE 环境变量指定不同的值。仅接受数值 - 使用 8388608 代替 8m。

console
docker run --name memcached -e MEMCACHED_MAX_ITEM_SIZE=8388608 REGISTRY_NAME/bitnami/memcached:latest

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

yaml
services:
  memcached:
  ...
    environment:
      - MEMCACHED_MAX_ITEM_SIZE=8388608
  ...

创建 Memcached 管理员用户

默认情况下，Memcached 服务器上的身份验证处于禁用状态。要启用身份验证，请使用 MEMCACHED_PASSWORD 环境变量（或 MEMCACHED_PASSWORD_FILE 指定的文件内容）指定 Memcached 管理员用户的密码。

要自定义 Memcached 管理员用户的用户名（默认为 root），应指定 MEMCACHED_USERNAME 变量。

console
docker run --name memcached \
  -e MEMCACHED_USERNAME=my_user \
  -e MEMCACHED_PASSWORD=my_password \
  REGISTRY_NAME/bitnami/memcached:latest

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

yaml
version: '2'

services:
  memcached:
  ...
    environment:
      - MEMCACHED_USERNAME=my_user
      - MEMCACHED_PASSWORD=my_password
  ...

MEMCACHED_USERNAME 的默认值为 root。

向 memcached 传递额外的命令行标志

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

console
docker run --name memcached REGISTRY_NAME/bitnami/memcached:latest /opt/bitnami/scripts/memcached/run.sh -vvv

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

yaml
services:
  memcached:
  ...
    command: /opt/bitnami/scripts/memcached/run.sh -vvv
  ...

有关参数的完整列表，请参阅 Memcached 手册页。

使用自定义 SASL 配置

要加载您自己的 SASL 配置文件，您必须使它们对容器可用。您可以通过以下方式实现：

• 挂载包含自定义配置的卷
• 通过环境变量添加自定义配置

默认情况下，启用身份验证时，Memcached 的 SASL 配置会写入 /opt/bitnami/memcached/sasl2/memcached.conf 文件，内容如下：

config
mech_list: plain
sasldb_path: /opt/bitnami/memcached/conf/memcachedsasldb

/opt/bitnami/memcached/conf/memcachedsasldb 是包含 Memcached 用户列表的 sasldb 文件路径。

Bitnami 安全镜像中的 FIPS 配置

Bitnami 安全镜像 目录中的 Bitnami Memcached Docker 镜像包含额外功能和设置，可将容器配置为具有 FIPS 功能。您可以配置以下环境变量：

• OPENSSL_FIPS：OpenSSL 是否以 FIPS 模式运行。yes（默认）、no。

日志

Bitnami Memcached Docker 镜像将容器日志发送到 stdout。要查看日志：

console
docker logs memcached

或使用 Docker Compose：

console
docker-compose logs memcached

如果您希望以不同方式使用容器日志，可以使用 --log-driver 选项配置容器的 日志驱动程序。默认配置下，Docker 使用 json-file 驱动程序。

维护

升级此镜像

Bitnami 会尽快提供 Memcached 的最新版本，包括安全补丁。我们建议您按照以下步骤升级容器。

步骤 1：获取更新的镜像

console
docker pull REGISTRY_NAME/bitnami/memcached:latest

如果使用 Docker Compose，请将 image 属性的值更新为 REGISTRY_NAME/bitnami/memcached:latest。

步骤 2：删除当前运行的容器

console
docker rm -v memcached

或使用 Docker Compose：

console
docker-compose rm -v memcached

步骤 3：运行新镜像

从新镜像重新创建容器。

console
docker run --name memcached REGISTRY_NAME/bitnami/memcached:latest

或使用 Docker Compose：

console
docker-compose up memcached

重要变更

1.5.18-debian-9-r13 和 1.5.19-ol-7-r1

• 修复了在版本 1.5.18-debian-9-r6 和 1.5.18-ol-7-r7 中引入的 Memcached 认证回归问题 (#62)。

1.5.18-debian-9-r6 和 1.5.18-ol-7-r