本站支持搜索的镜像仓库:Docker Hub、gcr.io、ghcr.io、quay.io、k8s.gcr.io、registry.gcr.io、elastic.co、mcr.microsoft.com
Redis® Cluster 是 Redis 的分布式实现,支持数据自动分片、高可用与水平扩展。Bitnami Redis® Cluster 镜像基于 Bitnami Secure Images 构建,提供预配置的集群环境,简化分布式 Redis 集群的部署与管理。该镜像适用于需要高性能、高可用分布式内存缓存或数据存储的应用场景,如高并发系统缓存、分布式会话存储等。
自 2025 年 8 月 28 日起,Bitnami 将调整公共镜像目录,推进 Bitnami Secure Images 计划:
2.50.0、10.6)将从 docker.io/bitnami 迁移至 docker.io/bitnamilegacy 仓库,且不再接收更新。latest 标签镜像(适用于开发),非加固 Debian 基础镜像逐步弃用。详情参见 Bitnami Secure Images 公告。
从 Docker Hub 拉取最新版:
docker pull bitnami/redis-cluster:latest
拉取特定版本(替换 [TAG] 为版本号,如 7.2.4):
docker pull bitnami/redis-cluster:[TAG]
克隆仓库并构建:
git clone [***] cd bitnami/redis-cluster/[VERSION]/[OPERATING-SYSTEM] # 替换为具体版本和操作系统 docker build -t bitnami/redis-cluster:latest .
快速启动单节点集群(仅开发测试,允许空密码):
docker run --name redis-cluster -e ALLOW_EMPTY_PASSWORD=yes bitnami/redis-cluster:latest
挂载本地目录至 /bitnami 实现数据持久化:
docker run \ --name redis-cluster \ -e ALLOW_EMPTY_PASSWORD=yes \ -v /path/to/local/persistence:/bitnami # 替换为本地实际路径 bitnami/redis-cluster:latest
通过 Docker 网络实现多容器通信:
docker network create redis-cluster-network --driver bridge
docker run \ --name redis-node-1 \ --network redis-cluster-network \ -e ALLOW_EMPTY_PASSWORD=yes \ bitnami/redis-cluster:latest
redis-node-1)和端口(默认 6379)访问集群。redis.conf挂载自定义配置文件覆盖默认配置:
docker run \ --name redis-cluster \ -e ALLOW_EMPTY_PASSWORD=yes \ -v /path/to/your_redis.conf:/opt/bitnami/redis/mounted-etc/redis.conf \ # 本地配置文件路径 -v /path/to/persistence:/bitnami \ bitnami/redis-cluster:latest
overrides.conf)仅覆盖部分配置,无需替换完整 redis.conf:
docker run \ --name redis-cluster \ -e ALLOW_EMPTY_PASSWORD=yes \ -v /path/to/overrides.conf:/opt/bitnami/redis/mounted-etc/overrides.conf \ # 本地覆盖配置路径 bitnami/redis-cluster:latest
| 名称 | 描述 | 默认值 |
|---|---|---|
REDIS_DATA_DIR | Redis 数据目录 | ${REDIS_VOLUME_DIR}/data |
REDIS_AOF_ENABLED | 是否启用 AOF 持久化 | yes |
REDIS_RDB_POLICY | RDB 持久化策略(格式:<秒>#<修改次数>,多策略空格分隔) | nil |
REDIS_RDB_POLICY_DISABLED | 是否禁用 RDB 策略 | no |
REDIS_PORT_NUMBER | 客户端端口号 | $REDIS_DEFAULT_PORT_NUMBER |
ALLOW_EMPTY_PASSWORD | 是否允许空密码访问 | no |
REDIS_PASSWORD | Redis 访问密码 | nil |
REDIS_TLS_ENABLED | 是否启用 TLS | no |
REDIS_TLS_PORT_NUMBER | TLS 端口(需 REDIS_TLS_ENABLED=yes) | 6379 |
REDIS_CLUSTER_REPLICAS | 集群副本数量 | 1 |
REDIS_CLUSTER_DYNAMIC_IPS | 是否使用动态 IP 创建集群 | yes |
REDIS_NODES | 集群节点列表(逗号分隔) | nil |
| 名称 | 描述 | 值 |
|---|---|---|
REDIS_VOLUME_DIR | 持久化基础目录 | /bitnami/redis |
REDIS_CONF_DIR | 配置目录 | ${REDIS_BASE_DIR}/etc |
REDIS_LOG_FILE | 日志文件路径 | ${REDIS_LOG_DIR}/redis.log |
REDIS_DEFAULT_PORT_NUMBER | 默认端口号 | 6379 |
部署 3 主 3 从集群:
# 主节点 docker run -d --name redis-node-1 --network redis-cluster-network -e ALLOW_EMPTY_PASSWORD=yes -e REDIS_CLUSTER_CREATOR=yes bitnami/redis-cluster:latest docker run -d --name redis-node-2 --network redis-cluster-network -e ALLOW_EMPTY_PASSWORD=yes bitnami/redis-cluster:latest docker run -d --name redis-node-3 --network redis-cluster-network -e ALLOW_EMPTY_PASSWORD=yes bitnami/redis-cluster:latest # 从节点 docker run -d --name redis-node-4 --network redis-cluster-network -e ALLOW_EMPTY_PASSWORD=yes bitnami/redis-cluster:latest docker run -d --name redis-node-5 --network redis-cluster-network -e ALLOW_EMPTY_PASSWORD=yes bitnami/redis-cluster:latest docker run -d --name redis-node-6 --network redis-cluster-network -e ALLOW_EMPTY_PASSWORD=yes bitnami/redis-cluster:latest
docker exec -it redis-node-1 redis-cli --cluster create \ redis-node-1:6379 redis-node-2:6379 redis-node-3:6379 \ redis-node-4:6379 redis-node-5:6379 redis-node-6:6379 \ --cluster-replicas 1 --cluster-yes
创建 docker-compose.yml 部署 3 主 3 从集群:
version: '3' services: redis-node-1: image: bitnami/redis-cluster:latest environment: - ALLOW_EMPTY_PASSWORD=yes - REDIS_CLUSTER_CREATOR=yes - REDIS_CLUSTER_REPLICAS=1 - REDIS_NODES=redis-node-1,redis-node-2,redis-node-3,redis-node-4,redis-node-5,redis-node-6 networks: - redis-cluster-network volumes: - redis-data-1:/bitnami redis-node-2: image: bitnami/redis-cluster:latest environment: - ALLOW_EMPTY_PASSWORD=yes - REDIS_NODES=redis-node-1,redis-node-2,redis-node-3,redis-node-4,redis-node-5,redis-node-6 networks: - redis-cluster-network volumes: - redis-data-2:/bitnami redis-node-3: image: bitnami/redis-cluster:latest environment: - ALLOW_EMPTY_PASSWORD=yes - REDIS_NODES=redis-node-1,redis-node-2,redis-node-3,redis-node-4,redis-node-5,redis-node-6 networks: - redis-cluster-network volumes: - redis-data-3:/bitnami redis-node-4: image: bitnami/redis-cluster:latest environment: - ALLOW_EMPTY_PASSWORD=yes - REDIS_NODES=redis-node-1,redis-node-2,redis-node-3,redis-node-4,redis-node-5,redis-node-6 networks: - redis-cluster-network volumes: - redis-data-4:/bitnami redis-node-5: image: bitnami/redis-cluster:latest environment: - ALLOW_EMPTY_PASSWORD=yes - REDIS_NODES=redis-node-1,redis-node-2,redis-node-3,redis-node-4,redis-node-5,redis-node-6 networks: - redis-cluster-network volumes: - redis-data-5:/bitnami redis-node-6: image: bitnami/redis-cluster:latest environment: - ALLOW_EMPTY_PASSWORD=yes - REDIS_NODES=redis-node-1,redis-node-2,redis-node-3,redis-node-4,redis-node-5,redis-node-6 networks: - redis-cluster-network volumes: - redis-data-6:/bitnami networks: redis-cluster-network: driver: bridge volumes: redis-data-1: redis-data-2: redis-data-3: redis-data-4: redis-data-5: redis-data-6:
启动集群:
docker-compose up -d
挂载证书并启用 TLS:
docker run \ --name redis-cluster \ -v /path/to/certs:/opt/bitnami/redis/certs \ # 本地证书目录(含 redis.crt、redis.key、CA 证书) -v /path/to/persistence:/bitnami \ -e ALLOW_EMPTY_PASSWORD=yes \ -e REDIS_TLS_ENABLED=yes \ -e REDIS_TLS_CERT_FILE=/opt/bitnami/redis/certs/redis.crt \ -e REDIS_TLS_KEY_FILE=/opt/bitnami/redis/certs/redis.key \ -e REDIS_TLS_CA_FILE=/opt/bitnami/redis/certs/redisCA.crt \ bitnami/redis-cluster:latest
容器日志输出至 stdout,可通过以下命令查看:
docker logs redis-cluster
docker pull bitnami/redis-cluster:latest
docker stop redis-cluster && docker rm -v redis-cluster
docker run --name redis-cluster -v /path/to/persistence:/bitnami bitnami/redis-cluster:latest
通过环境变量启用 FIPS 模式:
docker run \ --name redis-cluster \ -e OPENSSL_FIPS=yes # 启用 FIPS 模式(默认值),设置 no 禁用 bitnami/redis-cluster:latest
注意:生产环境建议使用 Bitnami Secure Images,获取长期支持与安全更新。
免费版仅支持 Docker Hub 加速,不承诺可用性和速度;专业版支持更多镜像源,保证可用性和稳定速度,提供优先客服响应。
免费版仅支持 docker.io;专业版支持 docker.io、gcr.io、ghcr.io、registry.k8s.io、nvcr.io、quay.io、mcr.microsoft.com、docker.elastic.co 等。
当返回 402 Payment Required 错误时,表示流量已耗尽,需要充值流量包以恢复服务。
通常由 Docker 版本过低导致,需要升级到 20.x 或更高版本以支持 V2 协议。
先检查 Docker 版本,版本过低则升级;版本正常则验证镜像信息是否正确。
使用 docker tag 命令为镜像打上新标签,去掉域名前缀,使镜像名称更简洁。
探索更多轩辕镜像的使用方法,找到最适合您系统的配置方式
通过 Docker 登录方式配置轩辕镜像加速服务,包含7个详细步骤
在 Linux 系统上配置轩辕镜像源,支持主流发行版
在 Docker Desktop 中配置轩辕镜像加速,适用于桌面系统
在 Docker Compose 中使用轩辕镜像加速,支持容器编排
在 k8s 中配置 containerd 使用轩辕镜像加速
在宝塔面板中配置轩辕镜像加速,提升服务器管理效率
在 Synology 群晖NAS系统中配置轩辕镜像加速
在飞牛fnOS系统中配置轩辕镜像加速
在极空间NAS中配置轩辕镜像加速
在爱快ikuai系统中配置轩辕镜像加速
在绿联NAS系统中配置轩辕镜像加速
在威联通NAS系统中配置轩辕镜像加速
在 Podman 中配置轩辕镜像加速,支持多系统
配置轩辕镜像加速9大主流镜像仓库,包含详细配置步骤
无需登录即可使用轩辕镜像加速服务,更加便捷高效
需要其他帮助?请查看我们的 常见问题 或 官方QQ群: 13763429