Redis Docker镜像使用指南

基础参考信息

维护者

Redis LTD（***网站）

获取帮助

• Docker社区Slack：dockr.ly/comm-slack
• Server Fault：相关主题
• Unix & Linux：相关主题
• Stack Overflow：相关主题

支持的标签及对应Dockerfile链接

按Redis版本从高到低排列，包含基于Debian（bookworm）和Alpine的镜像：

8.2.x 版本

• Debian (bookworm) 基础：8.2.2, 8.2, 8, 8.2.2-bookworm, 8.2-bookworm, 8-bookworm, latest, bookworm
  Dockerfile链接

• Alpine 基础：8.2.2-alpine, 8.2-alpine, 8-alpine, 8.2.2-alpine3.22, 8.2-alpine3.22, 8-alpine3.22, alpine, alpine3.22
  Dockerfile链接

8.0.x 版本

• Debian (bookworm) 基础：8.0.4, 8.0, 8.0.4-bookworm, 8.0-bookworm
  Dockerfile链接

• Alpine 基础：8.0.4-alpine, 8.0-alpine, 8.0.4-alpine3.21, 8.0-alpine3.21
  Dockerfile链接

7.4.x 版本

• Debian (bookworm) 基础：7.4.6, 7.4, 7, 7.4.6-bookworm, 7.4-bookworm, 7-bookworm
  Dockerfile链接

• Alpine 基础：7.4.6-alpine, 7.4-alpine, 7-alpine, 7.4.6-alpine3.21, 7.4-alpine3.21, 7-alpine3.21
  Dockerfile链接

7.2.x 版本

• Debian (bookworm) 基础：7.2.11, 7.2, 7.2.11-bookworm, 7.2-bookworm
  Dockerfile链接

• Alpine 基础：7.2.11-alpine, 7.2-alpine, 7.2.11-alpine3.21, 7.2-alpine3.21
  Dockerfile链接

6.2.x 版本

• Debian (bookworm) 基础：6.2.20, 6.2, 6, 6.2.20-bookworm, 6.2-bookworm, 6-bookworm
  Dockerfile链接

• Alpine 基础：6.2.20-alpine, 6.2-alpine, 6-alpine, 6.2.20-alpine3.21, 6.2-alpine3.21, 6-alpine3.21
  Dockerfile链接

补充参考信息

• 提交issue地址：GitHub Issues
• 支持的架构：amd64, arm32v5, arm32v6, arm32v7, arm64v8, i386, mips64le, ppc64le, riscv64, s390x（各架构镜像链接见原始文档）
• 镜像详情：repo-info仓库redis目录（含元数据、传输大小等）
• 镜像更新：official-images仓库library/redis标签 及 文件历史
• 本文档来源：docs仓库redis目录

Redis简介

Redis是全球最快的数据平台，提供云原生及本地部署的缓存、向量搜索和NoSQL数据库解决方案，可无缝集成到各类技术栈，帮助用户构建、扩展和部署高性能应用。

官网：redis.io

!Redis logo

安全注意事项

保护模式与访问控制

为方便容器间通信，默认关闭“保护模式”。若通过-p参数将端口暴露到主机外部（如公网），Redis会无密码开放访问。强烈建议通过配置文件设置密码。相关安全文档：

• Redis安全文档
• 保护模式说明
• Redis安全注意事项

进程用户与权限

默认情况下，镜像会切换到redis用户并移除不必要权限以降低风险。若使用--user指定用户，或设置SKIP_DROP_PRIVS=1（8.0.2及以上），则跳过此步骤。注意：不推荐使用SKIP_DROP_PRIVS，这会降低容器安全性。

使用方法

启动Redis实例

基础命令（后台运行，指定容器名称）：

console
$ docker run --name some-redis -d redis

启用持久化存储

以下命令配置每60秒内有至少1次写操作时保存快照，并降低日志级别：

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

数据默认存储在/data卷，可通过-v /host/dir:/data挂载主机目录，或--volumes-from使用数据卷容器（详见Docker卷文档）。更多持久化说明见Redis***文档。

文件与目录权限

Redis（8.0.2及以上）会自动修正数据和配置目录的所有权及权限（基础场景）。若需跳过，设置SKIP_FIX_PERMS=1。

手动设置权限（调整挂载卷所有权）：

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

通过redis-cli连接

在同一网络中连接到Redis实例：

console
$ docker run -it --network some-network --rm redis redis-cli -h some-redis

--network some-network指定网络（需提前创建或使用默认网络），-h some-redis为目标容器名称。

使用自定义配置文件

方法1：通过Dockerfile构建

创建包含自定义配置的镜像：

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

方法2：直接挂载配置文件

挂载主机配置目录并指定配置文件路径：

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

/myredis/conf需包含redis.conf，且目录需可写（Redis可能生成/修改配置文件）。

镜像变体

redis:<version>（默认）

基于Debian bookworm，适合大多数场景，可作为临时容器或基础镜像。标签含bookworm表示基于Debian该版本，安装额外包时建议显式指定以避免依赖变更。

redis:<version>-alpine

基于Alpine Linux（约5MB基础镜像），体积更小，适合对镜像大小敏感的场景。注意：使用musl libc而非glibc，可能存在软件兼容性问题（如依赖glibc特性的程序）。如需额外工具（如git、bash），需在Dockerfile中手动安装。

许可证

• Redis 8.0及以上：三许可证可选，包括RSALv2、SSPLv1、AGPLv3。
• Redis 7.4.x-7.8.x：双许可证（RSALv2或SSPLv1）。
• Redis 7.2.4及以下：3-Clause BSD许可证。

镜像中其他软件的许可证信息可参考repo-info仓库redis目录。使用前请确保遵守所有包含软件的许可证要求。