11notes/redis

REDIS

!size!https://raw.githubusercontent.com/11notes/static/refs/heads/main/img/markdown/transparent5x2px.png!pulls!https://raw.githubusercontent.com/11notes/static/refs/heads/main/img/markdown/transparent5x2px.png%5B](https://github.com/11notes/docker-redis/issues)!https://raw.githubusercontent.com/11notes/static/refs/heads/main/img/markdown/transparent5x2px.png!swiss_made

以无root权限、无发行版的方式安全运行Redis。

简介 📢

对于构建实时数据驱动应用的开发者，Redis是首选的、最快且功能最丰富的缓存、数据结构服务器以及文档和向量查询引擎。

!https://github.com/11notes/docker-redis/blob/master/img/RedisInsight.png?raw=true

概要 📖

我能用它做什么？ 该镜像将以https://github.com/11notes/RTFM/blob/main/linux/container/image/rootless.md%E5%92%8Chttps://github.com/11notes/RTFM/blob/main/linux/container/image/distroless.md%E6%96%B9%E5%BC%8F%E8%BF%90%E8%A1%8CRedis%EF%BC%8C%E4%BB%A5%E6%8F%90%E9%AB%98%E5%AE%89%E5%85%A8%E6%80%A7%E3%80%82%E9%99%A4%E4%BA%86%E6%AF%94%E5%A4%A7%E5%A4%9A%E6%95%B0%E9%95%9C%E5%83%8F%E6%9B%B4%E5%AE%89%E5%85%A8%E3%80%81%E6%9B%B4%E7%B2%BE%E7%AE%80%E5%A4%96%EF%BC%8C%E5%AE%83%E8%BF%98%E6%8F%90%E4%BE%9B%E9%A2%9D%E5%A4%96%E7%9A%84%E5%90%AF%E5%8A%A8%E5%8F%82%E6%95%B0%EF%BC%8C%E5%8F%AF%E5%B0%86Redis%E5%90%AF%E5%8A%A8%E4%B8%BA%E5%91%BD%E4%BB%A4%E6%A8%A1%E5%BC%8F%E3%80%81%E5%89%AF%E6%9C%AC%E6%A8%A1%E5%BC%8F%E6%88%96%E7%BA%AF%E5%86%85%E5%AD%98%E6%95%B0%E6%8D%AE%E5%BA%93%EF%BC%88%E4%B8%8D%E6%8C%81%E4%B9%85%E5%8C%96%E6%95%B0%E6%8D%AE%E5%88%B0%E7%A3%81%E7%9B%98%EF%BC%89%E3%80%82%E5%8F%AA%E9%9C%80%E6%8F%90%E4%BE%9B%E6%89%80%E9%9C%80%E5%91%BD%E4%BB%A4%E5%8D%B3%E5%8F%AF%EF%BC%9A

命令 📟

• --cmd - 对通过REDIS_HOST环境变量指定的Redis数据库执行所有命令
• --replica MASTER - 作为MASTER的副本启动（MASTER可以是IP、FQDN或容器DNS）
• --in-memory - 仅以纯内存方式启动Redis
• ¹ - ... 以及更多？

独特价值主张 💶

为什么我应该运行此镜像而不是其他已存在的镜像？ 好问题！因为...

• ... 此镜像以https://github.com/11notes/RTFM/blob/main/linux/container/image/rootless.md%E6%96%B9%E5%BC%8F%E8%BF%90%E8%A1%8C%EF%BC%8C%E7%94%A8%E6%88%B7ID/%E7%BB%84ID%E4%B8%BA1000:1000
• ... 此镜像是https://github.com/11notes/RTFM/blob/main/linux/container/image/distroless.md%E7%9A%84%EF%BC%8C%E5%9B%A0%E6%AD%A4%E6%B2%A1%E6%9C%89shell
• ... 此镜像通过CI/CD自动更新到最新版本
• ... 此镜像包含健康检查
• ... 此镜像以只读方式运行
• ... 此镜像在发布前后会自动扫描CVE漏洞
• ... 此镜像通过安全且固定的CI/CD流程创建
• ... 此镜像体积非常小
• ... 此镜像可用于在Redis启动后执行命令

如果您重视安全性、简洁性和极致优化，那么此镜像可能适合您。

对比 🏁

以下是此镜像与最常用或原始镜像的对比。

卷 📁

• /redis/etc - redis.conf配置文件目录
• /redis/var - Redis数据目录

Compose配置 ✂️

如果您想使用密钥而非环境变量，请查看https://github.com/11notes/docker-redis/blob/master/compose.secrets.yml%E3%80%82

yaml
name: "kv"

x-lockdown: &lockdown
  # 防止对镜像本身的写访问
  read_only: true
  # 防止容器内任何进程获取更多权限
  security_opt:
    - "no-new-privileges=true"

x-image-redis: &image
  image: "11notes/redis:8.2.3"
  <<: *lockdown

services:
  redis:
    <<: *image
    environment:
      REDIS_PASSWORD: "${REDIS_PASSWORD}"
      TZ: "Europe/Zurich"
    networks:
      backend:
    volumes:
      - "redis.etc:/redis/etc"
      - "redis.var:/redis/var"
    tmpfs:
      - "/run:uid=1000,gid=1000"
    restart: "always"

  # 启动redis的副本
  replica:
    <<: *image
    environment:
      REDIS_PASSWORD: "${REDIS_PASSWORD}"
      TZ: "Europe/Zurich"
    command: "--replica redis"
    networks:
      backend:
    volumes:
      - "replica.etc:/redis/etc"
      - "replica.var:/redis/var"
    tmpfs:
      - "/run:uid=1000,gid=1000"
    restart: "always"

  # 仅以纯内存方式启动Redis
  in-memory:
    <<: *image
    environment:
      REDIS_PASSWORD: "${REDIS_PASSWORD}"
      TZ: "Europe/Zurich"
    command: "--in-memory"
    networks:
      backend:
    volumes:
      - "in-memory.etc:/redis/etc"
    tmpfs:
      - "/run:uid=1000,gid=1000"
    restart: "always"

  # 通过redis-cli执行CLI命令
  cli:
    <<: *image
    depends_on:
      redis:
        condition: "service_healthy"
        restart: true
    environment:
      REDIS_HOST: "redis"
      REDIS_PASSWORD: "${REDIS_PASSWORD}"
      TZ: "Europe/Zurich"
    # 以命令模式启动redis
    entrypoint: ["/usr/local/bin/redis", "--cmd"]
    # 按顺序执行的命令
    command: 
      - PING
      - --version
      - SET key value NX
      - GET key
    networks:
      backend:

  # 用于查看数据库的演示容器
  gui:
    image: "redis/redisinsight"
    environment:
      RI_REDIS_HOST0: "redis"
      RI_REDIS_PASSWORD0: "${REDIS_PASSWORD}"
      RI_REDIS_HOST1: "replica"
      RI_REDIS_PASSWORD1: "${REDIS_PASSWORD}"
      RI_REDIS_HOST2: "in-memory"
      RI_REDIS_PASSWORD2: "${REDIS_PASSWORD}"
      TZ: "Europe/Zurich"
    ports:
      - "3000:5540/tcp"
    networks:
      backend:
      frontend:

volumes:
  redis.etc:
  redis.var:
  replica.etc:
  replica.var:
  in-memory.etc:

networks:
  frontend:
  backend:
    internal: true

要了解如何更改此容器镜像的默认UID/GID，请参考https://github.com/11notes/RTFM/blob/main/linux/container/image/11notes/how-to.changeUIDGID.md#change-uidgid-the-correct-way%E3%80%82

默认设置 🗃️

环境变量 📝

主要标签 🏷️

以下是镜像的主要标签。每个提交及其简写sha256值也有对应的标签。

• https://hub.docker.com/r/11notes/redis/tags?name=8.2.3

没有latest标签，我应该如何处理更新？

我的观点是:latest标签是一个坏习惯，根本不应该使用。许多开发者在新版本中引入破坏性变更，这会给使用:latest的人带来麻烦。如果您不想将标签更改为最新的语义化版本，只需使用语义化版本的短版本。不使用:8.2.3，您可以使用:8或:8.2。由于这些标签会在每个新版本中更新为软件的最新版本，使用它们与使用:latest类似，但至少固定在主版本或次版本上，理论上不会引入破坏性变更。

如果您仍然坚持使用此应用的最新版本，只需使用:rolling标签，但请注意！您将立即获得应用的最新版本，无论是否有破坏性变更或安全问题。风险自负！

仓库 ☁️

docker pull 11notes/redis:8.2.3
docker pull ghcr.io/11notes/redis:8.2.3
docker pull quay.io/11notes/redis:8.2.3

源 💾

• https://github.com/11notes/docker-redis

基础镜像 🏛️

此镜像不基于其他镜像，而是使用https://hub.docker.com/_/scratch%E4%BD%9C%E4%B8%BA%E5%9F%BA%E7%A1%80%E5%B1%82%E3%80%82 该镜像包含以下添加的无发行版层：

• https://github.com/11notes/docker-distroless/blob/master/arch.dockerfile - 包含用户、时区和根CA证书，无其他内容

构建工具 🧰

• https://github.com/redis/redis

一般提示 📌

• 使用反向代理（如Traefik、Nginx、HAproxy）终止TLS并保护您的端点
• 使用Let’s Encrypt DNS-01挑战获取服务的有效SSL证书

ElevenNotes™️

此镜像的使用风险由您自行承担。更新镜像到不同版本前，请务必进行备份。查看https://github.com/11notes/docker-redis/releases%E4%BA%86%E8%A7%A3%E7%A0%B4%E5%9D%8F%E6%80%A7%E5%8F%98%E6%9B%B4%E3%80%82%E5%A6%82%E6%9E%9C%E4%BD%BF%E7%94%A8%E6%AD%A4%E9%95%9C%E5%83%8F%E9%81%87%E5%88%B0%E9%97%AE%E9%A2%98%EF%BC%8C%E8%AF%B7%E6%8F%90%E4%BA%A4https://github.com/11notes/docker-redis/issues%EF%BC%8C%E8%B0%A2%E8%B0%A2%E3%80%82%E5%A6%82%E6%9E%9C%E6%82%A8%E6%9C%89%E9%97%AE%E9%A2%98%E6%88%96%E5%BB%BA%E8%AE%AE%EF%BC%8C%E8%AF%B7%E5%88%9B%E5%BB%BA%E6%96%B0%E7%9A%84https://github.com/11notes/docker-redis/discussions%E8%80%8C%E9%9D%9Eissue%E3%80%82%E6%82%A8%E5%8F%AF%E4%BB%A5%E5%9C%A8https://github.com/11notes?tab=repositories%E4%B8%8A%E6%89%BE%E5%88%B0%E6%88%91%E7%9A%84%E6%89%80%E6%9C%89%E5%85%B6%E4%BB%96%E4%BB%93%E5%BA%93%E3%80%82

创建于 03.11.2025, 06:32:49 (CET)===SHORT_DESC=== 以无root权限、无发行版的方式安全运行Redis，具有轻量级、高安全性特点，支持命令模式、副本模式和纯内存模式等多种启动方式。 ===FULL_DESC===# REDIS !size!https://raw.githubusercontent.com/11notes/static/refs/heads/main/img/markdown/transparent5x2px.png!pulls!https://raw.githubusercontent.com/11notes/static/refs/heads/main/img/markdown/transparent5x2px.png%5B](https://github.com/11notes/docker-redis/issues)!https://raw.githubusercontent.com/11notes/static/refs/heads/main/img/markdown/transparent5x2px.png!swiss_made

以无root权限、无发行版的方式安全运行Redis。

简介 📢

对于构建实时数据驱动应用的开发者，Redis是首选的、最快且功能最丰富的缓存、数据结构服务器以及文档和向量查询引擎。

!https://github.com/11notes/docker-redis/blob/master/img/RedisInsight.png?raw=true

概要 📖

我能用它做什么？ 该镜像将以https://github.com/11notes/RTFM/blob/main/linux/container/image/rootless.md%E5%92%8Chttps://github.com/11notes/RTFM/blob/main/linux/container/image/distroless.md%E6%96%B9%E5%BC%8F%E8%BF%90%E8%A1%8CRedis%EF%BC%8C%E4%BB%A5%E6%8F%90%E9%AB%98%E5%AE%89%E5%85%A8%E6%80%A7%E3%80%82%E9%99%A4%E4%BA%86%E6%AF%94%E5%A4%A7%E5%A4%9A%E6%95%B0%E9%95%9C%E5%83%8F%E6%9B%B4%E5%AE%89%E5%85%A8%E3%80%81%E6%9B%B4%E7%B2%BE%E7%AE%80%E5%A4%96%EF%BC%8C%E5%AE%83%E8%BF%98%E6%8F%90%E4%BE%9B%E9%A2%9D%E5%A4%96%E7%9A%84%E5%90%AF%E5%8A%A8%E5%8F%82%E6%95%B0%EF%BC%8C%E5%8F%AF%E5%B0%86Redis%E5%90%AF%E5%8A%A8%E4%B8%BA%E5%91%BD%E4%BB%A4%E6%A8%A1%E5%BC%8F%E3%80%81%E5%89%AF%E6%9C%AC%E6%A8%A1%E5%BC%8F%E6%88%96%E7%BA%AF%E5%86%85%E5%AD%98%E6%95%B0%E6%8D%AE%E5%BA%93%EF%BC%88%E4%B8%8D%E6%8C%81%E4%B9%85%E5%8C%96%E6%95%B0%E6%8D%AE%E5%88%B0%E7%A3%81%E7%9B%98%EF%BC%89%E3%80%82%E5%8F%AA%E9%9C%80%E6%8F%90%E4%BE%9B%E6%89%80%E9%9C%80%E5%91%BD%E4%BB%A4%E5%8D%B3%E5%8F%AF%EF%BC%9A

命令 📟

• --cmd - 对通过REDIS_HOST环境变量指定的Redis数据库执行所有命令
• --replica MASTER - 作为MASTER的副本启动（MASTER可以是IP、FQDN或容器DNS）
• --in-memory - 仅以纯内存方式启动Redis
• ¹ - ... 以及更多？

独特价值主张 💶

为什么我应该运行此镜像而不是其他已存在的镜像？ 好问题！因为...

• ... 此镜像以https://github.com/11notes/RTFM/blob/main/linux/container/image/rootless.md%E6%96%B9%E5%BC%8F%E8%BF%90%E8%A1%8C%EF%BC%8C%E7%94%A8%E6%88%B7ID/%E7%BB%84ID%E4%B8%BA1000:1000
• ... 此镜像是https://github.com/11notes/RTFM/blob/main/linux/container/image/distroless.md%E7%9A%84%EF%BC%8C%E5%9B%A0%E6%AD%A4%E6%B2%A1%E6%9C%89shell
• ... 此镜像通过CI/CD自动更新到最新版本
• ... 此镜像包含健康检查
• ... 此镜像以只读方式运行
• ... 此镜像在发布前后会自动扫描CVE漏洞
• ... 此镜像通过安全且固定的CI/CD流程创建
• ... 此镜像体积非常小