Redis Docker镜像文档

快速参考

• 维护者：
  Redis LTD

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

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

• 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-alpine, 8.0-alpine, 8.0.4-alpine3.21, 8.0-alpine3.21

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

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

• 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 用户并移除不必要的 capabilities。如果 Docker 运行时使用 --user 选项或设置了 SKIP_DROP_PRIVS=1（8.0.2 及以上版本）环境变量，则会跳过此步骤。

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

如何使用此镜像

启动 Redis 实例

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

使用持久化存储

$ docker run --name some-redis -d arm32v6/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 arm32v6/redis chown -R redis:redis /data

通过 redis-cli 连接

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

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

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

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

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

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

镜像变体

arm32v6/redis 镜像有多种版本，每种版本针对特定用例设计。

arm32v6/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/ 目录 中找到。

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