跳到主要内容

Redis

本文提供 Redis 的配置示例与配置原因说明。

1. 目录与挂载约定​

/app/redis/
├─ docker-compose.yml
├─ data/
├─ logs/
└─ users.acl

说明：

  • data：Redis 持久化数据目录（RDB/AOF）
  • logs：Redis 日志目录，便于问题定位
  • users.acl：Redis ACL 用户配置文件

2. ACL 配置文件​

/app/redis/users.acl：

user default on >change_me ~* &* +@all

说明：

  • default：Redis 默认用户名
  • on：启用该用户
  • >change_me：设置密码。> 是 ACL 语法前缀，不可省略，Redis 靠它区分密码与其他指令；省略会报 Syntax error
  • ~*：允许访问所有 key。~ 是 key pattern 前缀
  • &*：允许访问所有 Pub/Sub 频道。& 是 channel pattern 前缀
  • +@all：允许执行所有命令。+ 是权限授予前缀，@all 表示所有命令类别

注意：ACL 文件必须使用 LF 换行（Unix 风格），不能是 CRLF（Windows 风格），否则 Redis 会报 Syntax error。创建文件时可使用 printf 'user default on >change_me ~* &* +@all\n' > /app/redis/users.acl，或在已有文件上执行 sed -i 's/\r$//' /app/redis/users.acl 转换行尾。

3. Compose 配置示例​

/app/redis/docker-compose.yml：

services:
  redis:
    image: redis:7.2-alpine
    container_name: redis
    restart: unless-stopped
    ports:
      - "6379:6379"
    command: ["redis-server", "--appendonly", "yes", "--logfile", "/var/log/redis/redis.log", "--aclfile", "/etc/redis/users.acl"]
    volumes:
      - ./data:/data
      - ./logs:/var/log/redis
      - ./users.acl:/etc/redis/users.acl:ro
    healthcheck:
      test: ["CMD", "redis-cli", "-a", "change_me", "ping"]
      interval: 30s
      timeout: 20s
      retries: 3
      start_period: 30s

配置原因：

  • 通过 ACL 文件配置用户认证，比 --requirepass 更灵活，后续可扩展多用户和权限控制
  • ACL 文件只读挂载，避免运行时意外篡改
  • --appendonly yes 开启 AOF，提升数据持久化可靠性
  • 增加 healthcheck，可及时发现 Redis 无响应或启动异常

4. 验证连接​

启动后可通过 redis-cli 验证密码认证是否生效：

# 无密码连接会被拒绝
docker exec -it redis redis-cli ping
# 输出: (error) NOAUTH Authentication required.

# 使用密码连接
docker exec -it redis redis-cli -a change_me ping
# 输出: PONG

# 写入测试
docker exec -it redis redis-cli -a change_me set test_key "hello"
# 输出: OK

# 读取测试
docker exec -it redis redis-cli -a change_me get test_key
# 输出: "hello"

# 查看 ACL 用户列表
docker exec -it redis redis-cli -a change_me acl list
# 输出: user default on #... ~* &* +@all

5. 常用命令​

# 启动 Redis
cd /app/redis && docker compose up -d

# 关闭 Redis
cd /app/redis && docker compose down

# 查看容器日志
docker logs -f redis