注意：这是redis官方镜像的ppc64le架构构建版本的“按架构”仓库——更多信息，请参见官方镜像文档中的“除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

快速参考（续）

• 提交issue的地址：
  [***]

• 支持的架构：(更多信息)
  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 ppc64le/redis

启动带持久化存储的实例

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

Redis 提供多种持久化策略。上述命令会每 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 ppc64le/redis chown -R redis:redis /data

通过 redis-cli 连接

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

自定义 redis.conf

可创建自己的 Dockerfile，将上下文目录中的 redis.conf 添加到 /data/，例如：

FROM ppc64le/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 ppc64le/redis redis-server /usr/local/etc/redis/redis.conf

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

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

镜像变体

ppc64le/redis 镜像有多种版本，适用于不同场景。

ppc64le/redis:<version>

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

部分标签可能包含 bookworm 等名称，这些是 Debian 的版本代号，表示镜像基于该 Debian 版本构建。如果镜像需要安装基础镜像之外的额外软件包，建议显式指定这些标签，以减少 Debian 新版本发布时的兼容性问题。

ppc64le/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/ 目录 中找到一些自动检测到的额外许可证信息。

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