Bitnami Memcached Docker镜像文档

1. 镜像概述和主要用途

关于Memcached

Memcached是一款高性能、分布式的内存对象缓存系统，设计用于加速动态Web应用，通过减轻数据库负载提升应用响应速度。其通用架构使其适用于多种场景，核心功能是将频繁访问的数据存储在内存中，减少对后端数据库的直接查询。

Bitnami Memcached镜像用途

Bitnami Memcached Docker镜像是预配置的轻量级部署方案，旨在简化Memcached的搭建流程。该镜像基于Bitnami安全最佳实践构建，提供开箱即用的缓存服务，支持快速集成到开发、测试及生产环境。

2. 核心功能和特性

• 安全加固：遵循Bitnami Secure Images标准，基于最小化Photon Linux操作系统构建，减少攻击面，提供CVE透明度（通过VEX/KEV）、软件物料清单（SBOM）及安全 attestation签名。

• 非root用户运行：容器默认以非root用户（memcached）运行，降低权限提升风险，符合生产环境安全最佳实践。

• 配置灵活性：支持通过环境变量自定义缓存大小、连接数、认证信息等核心参数，同时提供自定义SASL配置能力。

• 标准化部署：与Bitnami Helm Charts兼容，支持Docker Compose及Kubernetes等多种部署方式，确保开发与生产环境配置一致性。

• 供应链安全：通过SLSA-3合规的构建工厂生成，包含病毒扫描报告、漏洞利用评分（EPSS）及及时的上游补丁更新。

3. 使用场景和适用范围

• 动态Web应用加速：缓存数据库查询结果、API响应等频繁访问数据，降低后端服务负载。
• 开发与测试环境：快速搭建本地缓存服务，模拟生产环境缓存行为。
• 分布式系统缓存层：作为微服务架构中的共享缓存组件，提升跨服务数据访问效率。
• 会话存储：存储用户会话数据，替代传统文件或数据库会话存储方案。

注意：该镜像的免费版本（latest标签）主要面向开发用途，生产环境建议使用Bitnami Secure Images商业版以获取长期支持。

4. 快速开始

基本部署命令

docker run --name memcached bitnami/memcached:latest

5. 注意事项：Bitnami Catalog变更通知

自2025年8月28日起，Bitnami将对公共镜像仓库进行重大调整：

• 镜像迁移：所有现有镜像（含历史版本标签，如2.50.0、10.6）将迁移至docker.io/bitnamilegacy仓库，不再接收更新。
• 版本支持：免费 tier 将仅提供安全加固的"latest"标签镜像，非加固的Debian基础镜像逐步停止支持。
• 生产建议：生产环境需迁移至Bitnami Secure Images，以获取加固容器、CVE透明报告、企业级支持等特性。

详细信息参见Bitnami Secure Images公告。

6. 获取镜像

推荐方式：拉取预构建镜像

从Docker Hub获取最新版本：

docker pull bitnami/memcached:latest

指定版本拉取（需注意2025年8月28日后版本标签迁移至legacy仓库）：

docker pull bitnami/memcached:[TAG]  # 例如: docker pull bitnami/memcached:2.50.0

手动构建镜像

git clone [***]
cd bitnami/memcached/[VERSION]/[OS]  # 替换为具体版本和操作系统
docker build -t bitnami/memcached:latest .

7. 部署方法

7.1 基础部署（docker run）

# 基本运行（默认配置：64MB缓存，11211端口）
docker run --name memcached -p 11211:11211 bitnami/memcached:latest

# 自定义缓存大小（128MB）
docker run --name memcached -e MEMCACHED_CACHE_SIZE=128 -p 11211:11211 bitnami/memcached:latest

# 启用认证（用户名my_user，密码my_password）
docker run --name memcached \
  -e MEMCACHED_USERNAME=my_user \
  -e MEMCACHED_PASSWORD=my_password \
  -p 11211:11211 \
  bitnami/memcached:latest

7.2 Docker Compose部署

创建docker-compose.yml文件：

version: '2'

networks:
  app-tier:
    driver: bridge

services:
  memcached:
    image: bitnami/memcached:latest
    ports:
      - "11211:11211"
    environment:
      - MEMCACHED_CACHE_SIZE=256  # 缓存大小256MB
      - MEMCACHED_MAX_CONNECTIONS=2048  # 最大连接数2048
    networks:
      - app-tier
  # 应用服务示例（需替换为实际应用镜像）
  myapp:
    image: YOUR_APPLICATION_IMAGE
    networks:
      - app-tier
    depends_on:
      - memcached

启动服务：

docker-compose up -d

7.3 容器网络连接

方法1：使用Docker网络

# 创建网络
docker network create app-tier --driver bridge

# 启动Memcached并加入网络
docker run -d --name memcached-server --network app-tier bitnami/memcached:latest

# 应用容器连接到同一网络（使用memcached-server作为主机名访问）
docker run -d --name myapp --network app-tier YOUR_APPLICATION_IMAGE

方法2：Docker Compose自动网络（见7.2示例）

Compose自动创建网络并连接所有服务，应用容器通过服务名（如memcached）访问缓存服务。

8. 配置说明

8.1 环境变量

8.1.1 可定制环境变量

8.1.2 只读环境变量（内部配置）

8.2 核心配置示例

调整缓存大小

docker run --name memcached -e MEMCACHED_CACHE_SIZE=512 bitnami/memcached:latest

设置最大连接数

docker run --name memcached -e MEMCACHED_MAX_CONNECTIONS=4096 bitnami/memcached:latest

配置工作线程数

docker run --name memcached -e MEMCACHED_THREADS=8 bitnami/memcached:latest

自定义启动参数

# 开启详细日志（-vvv）并限制CPU使用（-c 1024）
docker run --name memcached bitnami/memcached:latest /opt/bitnami/scripts/memcached/run.sh -vvv -c 1024

8.3 SASL认证配置

默认认证启用时，SASL配置文件位于/opt/bitnami/memcached/sasl2/memcached.conf，内容如下：

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

自定义SASL配置方法：

1. 挂载包含自定义sasl2目录的卷：

docker run --name memcached -v /path/to/custom/sasl2:/opt/bitnami/memcached/conf/sasl2 bitnami/memcached:latest

8.4 FIPS模式配置（Bitnami Secure Images）

商业版Secure Images支持FIPS模式，通过环境变量控制：

• OPENSSL_FIPS：是否启用FIPS模式，可选值yes（默认）/no

9. 日志管理

容器日志输出至stdout，可通过以下命令查看：

# 查看单个容器日志
docker logs memcached

# 查看Compose服务日志
docker-compose logs memcached

# 实时日志
docker logs -f memcached

可通过--log-driver参数配置日志驱动（如json-file、syslog等）：

docker run --name memcached --log-driver json-file --log-opt max-size=10m bitnami/memcached:latest

10. 维护与升级

10.1 升级镜像

# 1. 获取最新镜像
docker pull bitnami/memcached:latest

# 2. 停止并删除旧容器（数据非持久化场景）
docker stop memcached && docker rm memcached

# 3. 启动新容器
docker run --name memcached -p 11211:11211 bitnami/memcached:latest

10.2 数据持久化

Memcached为内存数据库，默认无持久化。如需状态保留，需使用外部工具（如memcached-tool）定期备份。

11. 重要变更记录

• 1.5.18-debian-9-r13及1.5.19-ol-7-r1：修复1.5.18版本中引入的认证 regression 问题。
• 1.5.18-debian-9-r6及1.5.18-ol-7-r7：减小镜像体积，配置逻辑迁移至Bash脚本；SASL配置目录变更为/opt/bitnami/memcached/conf/sasl2/；支持通过MEMCACHED_PASSWORD_FILE文件传入密码。
• 1.5.0-r1：迁移至非root容器模式，容器及服务均以用户1001运行。
• 1.4.25-r4：MEMCACHED_USER参数重命名为MEMCACHED_USERNAME。
• 1.4.25-r0：日志仅输出至stdout，不再写入卷。

12. 许可信息

Copyright © 2025 Broadcom. 本软件包由Bitnami打包，相关商标归各自公司所有。许可协议遵循Apache License 2.0，详情参见Apache官方网站。

注意：2025年8月28日后，历史版本镜像将迁移至bitnamilegacy仓库且不再更新，生产环境请使用Bitnami Secure Images商业版。