sudo mkdir -p /opt/data/ops/redis
cd /opt/data/ops/redis

# =============================================================================
# Redis 8 Docker Compose 部署文件
# 镜像版本：redis:8（对应 Redis 8.10.2，与《Ubuntu 22.04 安装 Redis 8 指南》版本一致）
# 使用方式：cd /opt/data/ops/redis && docker compose up -d
# 密码等敏感值通过环境变量注入，请先 export（见文档"六、常用环境变量表"章节）
# =============================================================================

services:
  redis:
    # 镜像版本：8.x 官方镜像
    image: redis:8

    # 容器名称，方便 docker ps / docker logs 定位
    container_name: redis-8

    # 重启策略：容器异常退出时自动重启（除非手动 stop）
    restart: unless-stopped

    # ---- 常用环境变量配置（值由外部环境变量注入）----
    environment:
      - TZ=Asia/Shanghai                        # 容器时区（与宿主机一致）
      - REDIS_PASSWORD=${REDIS_PASSWORD:?请在环境变量中设置} # 密码（供健康检查等容器内命令使用）

    # ---- 启动命令：使用自定义配置文件 + 密码注入 ----
    # 注意：redis.conf 中的 requirepass 无法做变量替换，
    # 因此密码通过命令行参数传入（优先级高于配置文件）
    command:
      - "redis-server"
      - "/usr/local/etc/redis/redis.conf"
      - "--requirepass"
      - "${REDIS_PASSWORD:?请在环境变量中设置}"

    # ---- 端口映射：宿主机16379 -> 容器6379 ----
    ports:
      - "16379:6379"

    # ---- 数据持久化（重要）----
    # ./data 为宿主机数据目录（对应 conf 中 dir /data），AOF/RDB 文件落在该目录
    volumes:
      - ./data:/data
      # ---- 配置文件持久化（重要）----
      # ./conf 为宿主机配置目录，挂载到 /usr/local/etc/redis/redis.conf，
      # 编辑 ./conf/redis.conf 后 docker compose restart redis 即可生效
      - ./conf/redis.conf:/usr/local/etc/redis/redis.conf

    # ---- 健康检查：redis-cli ping 判断数据库就绪 ----
    healthcheck:
      test: ["CMD-SHELL", "redis-cli -a $${REDIS_PASSWORD} ping | grep PONG"]
      interval: 10s      # 每 10 秒检查一次
      timeout: 5s        # 单次检查超时
      retries: 10        # 连续 10 次失败视为不健康
      start_period: 15s  # 启动后 15 秒才开始检查

    # 容器日志大小限制，防止磁盘被日志占满
    logging:
      driver: json-file
      options:
        max-size: "50m"
        max-file: "3"

# Redis 自定义配置文件（挂载到 /usr/local/etc/redis/redis.conf）
# 启动命令：redis-server /usr/local/etc/redis/redis.conf
# 修改后重启容器生效：docker compose restart redis

# ---- 网络 ----
# 监听所有网卡（配合端口映射供外部连接，密码保护）
bind 0.0.0.0
port 6379
protected-mode yes

# ---- 持久化（重要）----
# 数据目录（对应数据卷 ./data:/data），AOF/RDB 文件保存在此
dir /data
# 开启 AOF 追加持久化（每次写命令追加，重启数据不丢失）
appendonly yes
appendfilename "appendonly.aof"
# AOF 刷盘策略：everysec 每秒刷盘（性能与安全的折中）
appendfsync everysec

# ---- 内存 ----
# 内存上限（按需调整，0 表示不限制）
# maxmemory 512mb
# 达到上限后的淘汰策略（默认 noeviction 拒绝写入）
# maxmemory-policy allkeys-lru

# ---- 密码 ----
# 说明：requirepass 由 compose 命令行参数注入（--requirepass），
# 此处不写死密码；如需固定密码可取消注释：
# requirepass your-password

# ---- 安全/常规 ----
# 后台运行（容器内必须为 no，由 docker 管理进程）
daemonize no
# 日志级别：debug/verbose/notice/warning
loglevel notice
# 日志文件（容器内建议使用 stdout，即不设置 logfile，由 docker logs 收集）
# logfile /var/log/redis/redis-server.log
# 数据库数量
databases 16

# 注入密码（供启动命令与健康检查使用）
export REDIS_PASSWORD='your-password'

docker compose up -d

# 查看容器状态（healthy 表示健康检查通过）
docker ps --filter name=redis-8

# 使用密码连接测试
docker exec -it redis-8 redis-cli -a "$REDIS_PASSWORD" ping

# 数据读写与持久化验证
docker exec -it redis-8 redis-cli -a "$REDIS_PASSWORD" set hello world
docker exec -it redis-8 redis-cli -a "$REDIS_PASSWORD" get hello

# 验证鉴权生效（无密码访问应被拒绝）
docker exec -it redis-8 redis-cli ping

(error) NOAUTH Authentication required.

# 先注入环境变量
export REDIS_PASSWORD='your-password'

docker run -d \
  --name redis-8 \
  --restart unless-stopped \
  -e TZ=Asia/Shanghai \
  -e REDIS_PASSWORD="$REDIS_PASSWORD" \
  -p 16379:6379 \
  -v /opt/data/ops/redis/data:/data \
  -v /opt/data/ops/redis/conf/redis.conf:/usr/local/etc/redis/redis.conf \
  --health-cmd='redis-cli -a "$REDIS_PASSWORD" ping | grep PONG' \
  --health-interval=10s \
  --health-timeout=5s \
  --health-retries=10 \
  --health-start-period=15s \
  redis:8 \
  redis-server /usr/local/etc/redis/redis.conf \
  --requirepass "$REDIS_PASSWORD"

# 查看日志
docker logs -f redis-8

# 重启容器（数据保留）
docker compose restart

# 停止并移除容器（保留数据）
docker compose down

# 彻底移除容器 + 数据目录（谨慎操作！）
docker compose down -v

# 进入 redis-cli 交互
docker exec -it redis-8 redis-cli -a "$REDIS_PASSWORD"