thedutchselection/redis

Redis Docker镜像文档

镜像概述

本镜像基于Redis官方源码构建，用于快速部署和运行Redis服务。Redis是一个开源的内存数据结构存储系统，以高性能、灵活的特性被广泛应用于各类场景，支持作为数据库、缓存和消息代理使用。

核心功能与特性

• 内存数据存储：将数据存储在内存中，提供毫秒级响应速度，适用于高频访问场景
• 多数据结构支持：原生支持字符串（String）、哈希（Hash）、列表（List）、集合（Set）、有序集合（Sorted Set）等多种数据结构
• 持久化机制：支持RDB（快照）和AOF（追加文件）两种持久化方式，可根据需求配置数据持久化策略
• 高可用性：支持主从复制、哨兵（Sentinel）和集群（Cluster）模式，保障服务稳定运行和横向扩展
• 丰富扩展功能：提供发布/订阅、事务、Lua脚本、地理空间索引、流（Stream）等高级功能
• 轻量级部署：镜像体积精简，依赖少，可快速启动，资源占用低

使用场景与适用范围

• 缓存系统：作为应用层与数据库之间的缓存层，减少数据库访问压力，提升应用响应速度
• 会话存储：存储分布式系统中的用户会话数据，支持跨服务会话共享
• 实时数据分析：处理实时生成的数据流，如实时计数器、排行榜、社交网络动态等
• 消息队列：基于发布/订阅功能实现简单的消息队列系统，支持消息传递和异步处理
• 高频读写场景：适用于需要快速读写的业务场景，如电商商品库存、实时统计数据等

使用方法与配置说明

快速启动

使用以下命令快速启动一个基础Redis容器：

bash
docker run -d --name redis -p 6379:6379 docker.xuanyuan.run/thedutchselection/redis:latest

持久化配置

默认情况下，Redis数据仅存储在内存中。如需启用持久化，可通过挂载数据卷实现数据持久化存储：

bash
# 启动容器并挂载数据目录（AOF/RDB文件将存储在宿主机./redis-data目录）
docker run -d --name redis -p 6379:6379 -v $(pwd)/redis-data:/data docker.xuanyuan.run/thedutchselection/redis:latest

自定义配置

通过挂载自定义配置文件覆盖默认配置，满足个性化需求：

1. 准备配置文件：在宿主机创建配置目录（如./redis-conf），并添加redis.conf配置文件，示例配置：

   conf
   bind 0.0.0.0  # 允许外部访问（容器环境推荐）
   port 6379     # 服务监听端口
   requirepass your_secure_password  # 设置访问密码
   appendonly yes  # 启用AOF持久化
   maxmemory 2g    # 限制最大使用内存为2GB
   maxmemory-policy allkeys-lru  # 内存满时采用LRU策略淘汰键
   

2. 启动容器并挂载配置：

   bash
   docker run -d --name redis \
     -p 6379:6379 \
     -v $(pwd)/redis-data:/data \
     -v $(pwd)/redis-conf:/etc/redis \
     docker.xuanyuan.run/thedutchselection/redis:latest \
     redis-server /etc/redis/redis.conf
   

环境变量配置

支持通过环境变量快速配置Redis核心参数，无需手动修改配置文件：

示例：设置访问密码并启用AOF持久化

bash
docker run -d --name redis \
  -p 6379:6379 \
  -e REDIS_PASSWORD=SecurePass123 \
  -e REDIS_APPENDONLY=yes \
  -e REDIS_MAXMEMORY=1g \
  -v $(pwd)/redis-data:/data \
  docker.xuanyuan.run/thedutchselection/redis:latest

Docker Compose配置

通过docker-compose.yml实现多环境统一配置与部署：

yaml
version: '3'
services:
  redis:
    image: docker.xuanyuan.run/thedutchselection/redis:latest
    container_name: redis-service
    ports:
      - "6379:6379"  # 宿主机端口:容器端口
    environment:
      - REDIS_PASSWORD=ProdPass@2024  # 生产环境密码
      - REDIS_APPENDONLY=yes  # 启用AOF持久化
      - REDIS_MAXMEMORY=4g  # 限制最大内存为4GB
    volumes:
      - ./redis/data:/data  # 数据持久化目录
      - ./redis/conf:/etc/redis  # 自定义配置目录（可选）
    restart: unless-stopped  # 非手动停止时自动重启
    networks:
      - app-network  # 接入应用网络（如需与其他服务通信）

networks:
  app-network:
    driver: bridge

注意事项

• 数据安全：生产环境中必须启用持久化（AOF/RDB）并定期备份数据目录，避免数据丢失
• 内存管理：根据业务需求合理配置maxmemory和内存淘汰策略（如allkeys-lru），防止内存溢出
• 访问控制：通过requirepass设置强密码，避免未授权访问；容器内建议绑定0.0.0.0，通过宿主机防火墙限制外部访问IP
• 高可用部署：单节点适用于开发/测试环境，生产环境建议部署Redis集群或使用哨兵模式实现高可用
• 权限配置：宿主机数据目录需确保容器进程有读写权限（可通过chmod 777 ./redis-data临时授权，生产环境建议配置专用用户权限）