注意：这是官方redis镜像的i386架构构建版本库——更多信息请参见官方镜像文档中的“非amd64架构？”和官方镜像FAQ中的“镜像源在Git中已更改，该怎么办？”。

快速参考

• 维护者：
  Redis LTD

• 获取帮助：
  Docker社区Slack、Server Fault、Unix & Linux 或 Stack Overflow

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

• 8.2.2, 8.2, 8, 8.2.2-bookworm, 8.2-bookworm, 8-bookworm, latest, bookworm

• 8.2.2-alpine, 8.2-alpine, 8-alpine, 8.2.2-alpine3.22, 8.2-alpine3.22, 8-alpine3.22, alpine, alpine3.22

• 8.0.4, 8.0, 8.0.4-bookworm, 8.0-bookworm

• 8.0.4-alpine, 8.0-alpine, 8.0.4-alpine3.21, 8.0-alpine3.21

• 7.4.6, 7.4, 7, 7.4.6-bookworm, 7.4-bookworm, 7-bookworm

• 7.4.6-alpine, 7.4-alpine, 7-alpine, 7.4.6-alpine3.21, 7.4-alpine3.21, 7-alpine3.21

• 7.2.11, 7.2, 7.2.11-bookworm, 7.2-bookworm

• 7.2.11-alpine, 7.2-alpine, 7.2.11-alpine3.21, 7.2-alpine3.21

• 6.2.20, 6.2, 6, 6.2.20-bookworm, 6.2-bookworm, 6-bookworm

• 6.2.20-alpine, 6.2-alpine, 6-alpine, 6.2.20-alpine3.21, 6.2-alpine3.21, 6-alpine3.21

快速参考（续）

• 问题反馈地址：
  [***]

• 支持的架构：(更多信息)
  amd64、arm32v5、arm32v6、arm32v7、arm64v8、i386、mips64le、ppc64le、riscv64、s390x

• 镜像 artifact 详情：
  repo-info 仓库的 repos/redis/ 目录（历史记录）
  （镜像元数据、传输大小等）

• 镜像更新：
  official-images 仓库的 library/redis 标签
  official-images 仓库的 library/redis 文件（历史记录）

• 本描述的来源：
  docs 仓库的 redis/ 目录（历史记录）

什么是 Redis？

Redis 是全球最快的数据平台。它提供云原生和本地部署的缓存、向量搜索和 NoSQL 数据库解决方案，能无缝集成到任何技术栈中——使数字用户能够轻松构建、扩展和部署支撑世界运行的高速应用。

redis.io

!logo

安全性

为便于通过 Docker 网络从其他容器访问 Redis，默认情况下“保护模式”处于关闭状态。这意味着如果您将端口暴露到主机外部（例如通过 docker run 的 -p 选项），任何人都可以无密码访问。强烈建议如果计划将 Redis 实例暴露到互联网，务必设置密码（通过提供配置文件）。有关 Redis 安全性的更多信息，请参见以下链接：

• Redis 安全文档
• 保护模式
• antirez 关于 Redis 安全性的几点说明

进程用户与权限

默认情况下，Redis Docker 镜像会通过切换到 redis 用户并移除不必要的权限来降低权限。如果 Docker 以 --user 选项运行，或设置了 SKIP_DROP_PRIVS=1（8.0.2 及以上版本）环境变量，则会跳过此步骤。

注意：不建议使用 SKIP_DROP_PRIVS，因为这会降低容器的安全性。

如何使用本镜像

启动 Redis 实例

$ docker run --name some-redis -d i386/redis

使用持久化存储启动

$ docker run --name some-redis -d i386/redis redis-server --save 60 1 --loglevel warning

有多种持久化策略可供选择。上述命令会每 60 秒且至少有 1 次写入操作时保存数据库快照（这也会产生更多日志，因此 loglevel 选项可能更合适）。如果启用持久化，数据会存储在 VOLUME /data 中，可通过 --volumes-from some-volume-container 或 -v /docker/host/dir:/data 使用（参见 Docker 卷文档）。

有关 Redis 持久化的更多信息，请参见 Redis 官方文档。

文件和目录权限

Redis 会尝试修正数据和配置目录及文件的所有权和权限（8.0.2 及以上版本），如果它们设置不正确。此调整仅在基本默认场景中执行，以避免干扰自定义或用户特定配置。

您可以通过设置 SKIP_FIX_PERMS=1（8.0.2 及以上版本）环境变量跳过此步骤。

手动设置文件和目录权限

如果您希望自行处理文件权限，可以使用 docker run 命令设置挂载卷的正确所有权。例如：

$ docker run --rm -v /your/host/path:/data i386/redis chown -R redis:redis /data

通过 redis-cli 连接

$ docker run -it --network some-network --rm i386/redis redis-cli -h some-redis

此外，如果需要使用自定义 redis.conf...

您可以创建自己的 Dockerfile，将上下文的 redis.conf 添加到 /data/ 中，如下所示：

FROM i386/redis
COPY redis.conf /usr/local/etc/redis/redis.conf
CMD [ "redis-server", "/usr/local/etc/redis/redis.conf" ]

或者，您也可以通过 docker run 选项实现类似效果：

$ docker run -v /myredis/conf:/usr/local/etc/redis --name myredis i386/redis redis-server /usr/local/etc/redis/redis.conf

其中 /myredis/conf/ 是包含您的 redis.conf 文件的本地目录。使用此方法无需为 Redis 容器编写 Dockerfile。

映射的目录应可写，因为根据配置和操作模式，Redis 可能需要创建额外配置文件或重写现有文件。

镜像变体

i386/redis 镜像有多种版本，每种版本适用于特定用例。

i386/redis:<version>

这是默认镜像。如果不确定需求，可能需要使用此版本。它设计为既可作为临时容器（挂载源代码并启动容器以运行应用），也可作为构建其他镜像的基础。

某些标签可能包含如 bookworm 之类的名称，这些是 Debian 的发行版代号，表示镜像基于哪个发行版。如果您的镜像需要安装除镜像自带软件之外的其他包，建议显式指定这些代号，以减少 Debian 新版本发布时的兼容性问题。

i386/redis:<version>-alpine

此镜像基于流行的 Alpine Linux 项目，可在 官方 alpine 镜像 中获取。Alpine Linux 比大多数发行版基础镜像小得多（约 5MB），因此通常生成更精简的镜像。

当最终镜像大小是首要考虑因素时，此变体非常有用。需要注意的是，它使用 musl libc 而非 glibc 等，因此软件可能会因对 libc 的依赖或假设深度而遇到问题。有关可能出现的问题及使用 Alpine 基础镜像的优缺点比较，请参见 此 Hacker News 评论线程。

为最小化镜像大小，Alpine 基础镜像通常不包含额外相关工具（如 git 或 bash）。如需使用此类工具，可基于此镜像创建自己的 Dockerfile 并安装所需包（如果不熟悉如何安装包，参见 alpine 镜像说明 中的示例）。

许可证

从 Redis 8.0 开始，Redis 采用三许可证模型，可选择 Redis 源可用许可证 v2 - RSALv2、服务器端公共许可证 v1 - SSPLv1 或 GNU Affero 通用公共许可证 v3 - AGPLv3。Redis 旧版本（<=7.2.4）采用 3-Clause BSD 许可证，Redis 7.4.x-7.8.x 采用双重 RSALv2 或 SSPLv1 许可证。

另请查看 Redis 许可证概述 和 Redis 商标政策。

与所有 Docker 镜像一样，这些镜像可能还包含其他软件，这些软件可能采用其他许可证（如基础发行版中的 Bash 等，以及主要软件的任何直接或间接依赖项）。

可在 repo-info 仓库的 redis/ 目录 中找到一些能够自动检测到的额外许可证信息。

对于任何预构建镜像的使用，镜像用户有责任确保对该镜像的任何使用符合其中包含的所有软件的相关许可证。