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

-** 已发布镜像工件详情：**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 amd64/redis

使用持久化存储

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

通过redis-cli连接

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

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

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

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

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

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

镜像变体

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

amd64/redis:<version>

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

某些标签可能包含bookworm等名称，这些是Debian发行版的代号，表示镜像基于哪个发行版。如果镜像需要安装除基础镜像外的其他软件包，建议显式指定这些代号，以减少Debian新版本发布时的中断。

amd64/redis:<version>-alpine

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

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

为最小化镜像大小，Alpine-based镜像通常不包含额外的相关工具（如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/目录中找到一些能够自动检测到的额外许可证信息。

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