manlongdan/library_redis

快速参考

• 维护者:
  https://redis.io/

• 获取帮助:
  https://dockr.ly/comm-slack、Server Fault、https://unix.stackexchange.com/help/on-topic 或 https://stackoverflow.com/help/on-topic

支持的标签及对应Dockerfile链接

• https://github.com/redis/docker-library-redis/blob/a13b78815d980881e57f15b9cf13cd2f26f3fab6/debian/Dockerfile
• https://github.com/redis/docker-library-redis/blob/a13b78815d980881e57f15b9cf13cd2f26f3fab6/alpine/Dockerfile
• https://github.com/redis/docker-library-redis/blob/***a8cf05b98137d88bc17e77db90c24cc783/debian/Dockerfile
• https://github.com/redis/docker-library-redis/blob/***a8cf05b98137d88bc17e77db90c24cc783/alpine/Dockerfile
• https://github.com/redis/docker-library-redis/blob/732a2608af90db97efa8ddd993fcbb63f5d2883b/7.4/debian/Dockerfile
• https://github.com/redis/docker-library-redis/blob/732a2608af90db97efa8ddd993fcbb63f5d2883b/7.4/alpine/Dockerfile
• https://github.com/redis/docker-library-redis/blob/732a2608af90db97efa8ddd993fcbb63f5d2883b/7.2/debian/Dockerfile
• https://github.com/redis/docker-library-redis/blob/732a2608af90db97efa8ddd993fcbb63f5d2883b/7.2/alpine/Dockerfile
• https://github.com/redis/docker-library-redis/blob/732a2608af90db97efa8ddd993fcbb63f5d2883b/6.2/debian/Dockerfile
• https://github.com/redis/docker-library-redis/blob/732a2608af90db97efa8ddd993fcbb63f5d2883b/6.2/alpine/Dockerfile

快速参考（续）

• 提交问题:
  https://github.com/redis/docker-library-redis/issues?q=

• 支持的架构: (https://github.com/docker-library/official-images#architectures-other-than-amd64)
  https://hub.docker.com/r/amd64/redis/、https://hub.docker.com/r/arm32v5/redis/、https://hub.docker.com/r/arm32v6/redis/、https://hub.docker.com/r/arm32v7/redis/、https://hub.docker.com/r/arm64v8/redis/、https://hub.docker.com/r/i386/redis/、https://hub.docker.com/r/mips64le/redis/、https://hub.docker.com/r/ppc64le/redis/、https://hub.docker.com/r/riscv64/redis/、https://hub.docker.com/r/s390x/redis/

• 镜像 artifact 详情:
  https://github.com/docker-library/repo-info/blob/master/repos/redis (https://github.com/docker-library/repo-info/commits/master/repos/redis)
  (镜像元数据、传输大小等)

• 镜像更新:
  https://github.com/docker-library/official-images/issues?q=label%3Alibrary%2Fredis
  https://github.com/docker-library/official-images/blob/master/library/redis (https://github.com/docker-library/official-images/commits/master/library/redis)

• 本描述来源:
  https://github.com/docker-library/docs/tree/master/redis (https://github.com/docker-library/docs/commits/master/redis)

什么是 Redis？

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

https://redis.io

安全性

为方便通过 Docker 网络从其他容器访问 Redis，默认关闭"保护模式"。这意味着如果您将端口暴露到主机外部（如通过 docker run 的 -p 参数），任何人都可以无密码访问。强烈建议在将 Redis 实例暴露到互联网时设置密码（通过提供配置文件）。更多安全信息请参考：

• https://redis.io/docs/latest/operate/oss_and_stack/management/security/
• https://redis.io/docs/latest/operate/oss_and_stack/management/security/#protected-mode
• antirez 关于 Redis 安全的几点说明

进程用户与权限

默认情况下，Redis Docker 镜像会降低权限：切换到 redis 用户并移除不必要的能力。如果 Docker 运行时使用 --user 选项或设置 SKIP_DROP_PRIVS=1（8.0.2 及以上版本支持）环境变量，则会跳过此步骤。

注意：不推荐使用 SKIP_DROP_PRIVS，因为它会降低容器的安全性。

如何使用本镜像

启动 Redis 实例

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

启动带持久化存储的实例

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

Redis 支持多种持久化策略。上述命令会在至少1次写操作后，每60秒保存一次数据库快照（同时会产生更多日志，因此 loglevel 选项可能有用）。如果启用持久化，数据会存储在 VOLUME /data 目录，可通过 --volumes-from some-volume-container 或 -v /docker/host/dir:/data 挂载（详见 https://docs.docker.com/engine/tutorials/dockervolumes/）。

更多关于 Redis 持久化的信息，请参考 https://redis.io/docs/latest/operate/oss_and_stack/management/persistence/。

文件与目录权限

Redis 会尝试修正数据和配置目录（8.0.2及以上版本支持）的所有权和权限（如果设置不正确）。此调整仅在基础默认场景下执行，以避免干扰自定义或用户特定的配置。

您可以通过设置 SKIP_FIX_PERMS=1（8.0.2及以上版本支持）环境变量跳过此步骤。

手动设置文件与目录权限

如果您希望自行处理文件权限，可以使用 docker run 命令设置挂载卷的正确所有权：

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

通过 redis-cli 连接

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

使用自定义 redis.conf

您可以创建自己的 Dockerfile，将上下文目录中的 redis.conf 复制到 /data/：

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

或者，您也可以通过 docker run 选项实现类似效果：

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 容器编写 Dockerfile。

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

镜像变体

redis 镜像有多种版本，适用于不同场景：

redis:<version>

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

部分标签包含 bookworm 等名称，这些是 Debian 发行版的代码名，指示镜像基于哪个版本构建。如果您的镜像需要安装额外包，建议显式指定这些标签，以减少 Debian 新版本发布时的兼容性问题。

redis:<version>-alpine

此镜像基于流行的 https://alpinelinux.org（来自 https://hub.docker.com/_/alpine）。Alpine Linux 比大多数发行版基础镜像小得多（约5MB），因此生成的镜像更精简。

当您优先考虑最小化最终镜像大小时，此变体非常有用。需要注意的是，它使用 https://musl.libc.org 而非 https://www.etalabs.net/compare_libcs.html，因此软件可能因 libc 依赖/假设而出现问题。更多讨论请参考 Hacker News 评论。

为最小化镜像大小，Alpine 镜像通常不包含额外工具（如 git 或 bash）。您可以基于此镜像在自己的 Dockerfile 中添加所需工具（详见 https://hub.docker.com/_/alpine/）。

许可证

从 Redis 8.0 开始，Redis 采用三许可模式，可选择 https://redis.io/legal/rsalv2-agreement/、https://redis.io/legal/server-side-public-license-sspl/ 或 https://opensource.org/license/agpl-v3。Redis <=7.2.4 版本基于 https://opensource.org/license/bsd-3-clause 许可，Redis 7.4.x-7.8.x 基于双许可（RSALv2 或 SSPLv1）。

请同时查看 https://redis.io/legal/licenses/ 和 https://redis.io/legal/trademark-policy/。

与所有 Docker 镜像一样，此镜像可能包含其他软件，这些软件可能受其他许可证约束（如基础发行版中的 Bash 等，以及主软件的直接或间接依赖）。

自动检测到的额外许可证信息可在 https://github.com/docker-library/repo-info/tree/master/repos/redis 中找到。

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