注意：这是redis官方镜像的arm32v7架构构建的“特定架构”仓库——更多信息，请参见官方镜像文档中的“除amd64之外的架构？”在官方镜像文档中以及官方镜像FAQ中的“Git中的镜像源已更改，现在该怎么办？”在官方镜像FAQ中。

快速参考

• 维护者：
  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 arm32v7/redis

使用持久化存储启动

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

通过redis-cli连接

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

此外，如果您想使用自己的redis.conf...

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

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

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

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

镜像变体

arm32v7/redis镜像有多种版本，每种版本设计用于特定用例。

arm32v7/redis:<version>

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

某些标签可能包含如bookworm之类的名称，这些是Debian的版本代号，表示镜像基于哪个发行版。如果您的镜像需要安装超出镜像自带的其他软件包，可能需要显式指定其中一个版本，以最大程度减少Debian新版本发布时的中断。

arm32v7/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/目录中。

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