Redis 官方镜像（arm64v8 架构）介绍

说明

本文档对应 Redis 官方镜像 的 arm64v8 架构专属仓库。更多信息可参考官方镜像文档的「非 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 用户并移除不必要的系统权限，以降低安全风险。若通过 --user 选项指定用户，或设置环境变量 SKIP_DROP_PRIVS=1（8.0.2 及以上版本支持），则会跳过权限降级步骤。注意：不推荐使用 SKIP_DROP_PRIVS，这会降低容器安全性。

如何使用本镜像

启动 Redis 实例

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

启动带持久化存储的实例

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

上述命令配置 Redis 每 60 秒内若有至少 1 次写入操作，则保存数据库快照；--loglevel warning 可减少日志输出。持久化数据默认存储在 VOLUME /data，可通过 --volumes-from some-volume-container 或 -v /docker/host/dir:/data 挂载外部存储（详见 Docker 卷文档）。关于 Redis 持久化的更多信息，参见 官方文档。

文件与目录权限

Redis（8.0.2 及以上版本）会尝试自动修正数据目录和配置文件的所有权及权限（仅在基础默认场景下），避免干扰自定义配置。若需跳过此步骤，可设置环境变量 SKIP_FIX_PERMS=1。

手动设置文件权限

若需自行管理权限，可通过以下命令调整挂载卷的所有权：

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

通过 redis-cli 连接

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

（some-network 为容器所在网络，some-redis 为 Redis 容器名称）

使用自定义配置文件

方法 1：通过 Dockerfile 构建

创建包含自定义 redis.conf 的 Dockerfile：

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

方法 2：直接通过 docker run 挂载

无需编写 Dockerfile，直接挂载配置目录：

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

（/myredis/conf/ 为本地目录，包含你的 redis.conf 文件。挂载目录需可写，因 Redis 可能需要创建或重写配置文件。）

镜像变体

arm64v8/redis 提供多种镜像变体，适用于不同场景：

arm64v8/redis:<version>

默认镜像，基于 Debian 系统（标签中含 bookworm 等字样表示 Debian 发行版代号）。若不确定需求，建议使用此变体。它既可用作临时容器，也可作为基础镜像构建其他镜像。

arm64v8/redis:<version>-alpine

基于 Alpine Linux（alpine 官方镜像），体积极小（约 5MB），适合对镜像大小有严格要求的场景。注意：Alpine 使用 musl libc 而非 glibc，部分依赖 glibc 的软件可能存在兼容性问题（详见 相关讨论）。如需额外工具（如 git、bash），需在 Dockerfile 中自行安装（参考 Alpine 镜像文档）。

许可协议

• Redis 8.0 及以上版本采用三许可模式：Redis 源码可用许可 v2（RSALv2）、服务器端公共许可 v1（SSPLv1） 或 GNU Affero 通用公共许可 v3（AGPLv3）。
• Redis 7.4.x-7.8.x 采用双许可：RSALv2 或 SSPLv1。
• Redis 7.2.4 及以下版本采用 3-Clause BSD 许可。

更多信息参见 Redis 许可协议概述 和 Redis 商标政策。

与所有 Docker 镜像一样，本镜像可能包含其他软件（如基础系统的 Bash 等），其许可协议需另行确认。自动检测到的许可信息可参考 repo-info 仓库的 redis/ 目录。

使用前请确保遵守所有包含软件的许可协议。