zeroteampro/redis

Redis

支持amd64和arm64架构的Redis镜像，包含多个扩展模块，且默认redis.conf可通过环境变量进行扩展配置。

模块

• https://github.com/RediSearch/RediSearch
• https://github.com/RedisJSON/RedisJSON
• https://github.com/RedisTimeSeries/RedisTimeSeries

镜像变体（tags）

latest

最新稳定版本。

v*（推荐）

特定稳定版本。例如 v7.0.2。

main

最新main分支构建版本。通常稳定，但不保证。如需最新稳定且经过测试的版本，请使用latest。

edge

开发者实验版本。可能无法正常工作。非专业用户请勿使用。

如何使用此镜像

启动实例

bash
docker run -d --name redis zeroteampro/redis
# 备选仓库
docker run -d --name redis registry.zero-team.pro/redis

启动带挂载存储的实例

bash
docker run -d --name redis -v /opt/project/redis:/data zeroteampro/redis

启动特定版本实例

bash
docker run -d --name redis zeroteampro/redis:<version>

开放端口

bash
docker run -d --name redis -p 6379:6379 zeroteampro/redis

通过环境变量扩展默认redis.conf

bash
docker run -d --name redis -e REDIS_PASSWORD=verySecurePassword zeroteampro/redis

上述命令会在默认redis.conf中添加requirepass verySecurePassword配置。

生产环境启用TLS的Redis

bash
docker run -d --name redis -e REDIS_TLS_ON=true -v /path/to/certs/:/certs zeroteampro/redis

开发环境启用TLS的Redis（自动生成证书）

bash
docker run -d --name redis -e REDIS_TLS_ON=true -e REDIS_TLS_GEN=true -v /path/to/certs/:/certs zeroteampro/redis

新证书将生成在certs目录中。

通过自定义redis.custom.conf扩展默认配置

bash
docker run -d --name redis -v /path/to/redis.conf:/app/redis.custom.conf zeroteampro/redis

替换默认redis.conf

bash
docker run -d --name redis -v /path/to/redis.conf:/app/redis.conf zeroteampro/redis

注意！部分环境变量会扩展/app/redis.conf。请勿在自定义redis.conf和环境变量中使用相同的配置项（列表见下文）。

从环境变量扩展redis.conf

REDIS_PASSWORD

环境变量：

yaml
REDIS_PASSWORD=somePassword

对应redis.conf配置：

dosini
requirepass somePassword

REDIS_MAX_MEMORY

环境变量：

yaml
REDIS_MAX_MEMORY=2gb

对应redis.conf配置：

dosini
maxmemory 2gb

REDIS_SAVE

环境变量：

yaml
REDIS_SAVE="60 1"

对应redis.conf配置：

dosini
save 60 1

REDIS_LOG_LEVEL

默认日志级别为notice。

环境变量：

yaml
REDIS_LOG_LEVEL=debug

对应redis.conf配置：

dosini
loglevel debug

REDIS_TLS_ON

环境变量：

yaml
REDIS_TLS_ON=true

对应redis.conf配置：

dosini
port 0
tls-port 6379

tls-cert-file /certs/server.crt
tls-key-file /certs/server.key
tls-ca-cert-file /certs/ca.crt
tls-dh-params-file /certs/redis.dh

REDIS_TLS_GEN

环境变量：

dosini
REDIS_TLS_GEN=true

在/certs目录中生成新证书。生产环境请勿使用自动生成的证书。

自定义Docker镜像

Dockerfile示例

Containerfile
FROM zeroteampro/redis[:version]

COPY redis.conf /app/redis.conf

# 可选：修改CMD
# 默认：#CMD ["/app/start-redis.sh"]

# 脚本会将/app/redis.conf复制到/usr/local/etc/redis/redis.conf，
# 用环境变量扩展配置，然后使用/usr/local/etc/redis/redis.conf启动redis-server
CMD ["/app/start-redis.sh"] # 此镜像默认CMD

# 使用自定义配置并忽略环境变量
# 注意！默认CMD脚本仍会使用/app/redis.conf，但会同时用环境变量扩展配置。
# 使用以下自定义CMD将忽略上述所有环境变量
CMD ["redis-server", "/app/redis.conf"]