Docker Compose中Redis-Commander无法连接Redis服务求助

核心问题原因 #

• Redis绑定地址限制：添加--bind 127.0.0.1后，Redis仅监听容器内部的127.0.0.1，Redis-Commander作为独立容器，无法通过Docker内部网络访问该地址。
• 容器启动时机不匹配：depends_on仅保证Redis容器先启动，但不等待Redis服务完全就绪，Commander可能在Redis初始化完成前就发起连接请求。
• 配置冗余冲突：同时通过environment和command设置Redis密码，虽不直接报错，但易导致配置逻辑混乱。

修复步骤 #

1. 调整Redis绑定配置 #

移除--bind 127.0.0.1参数，Redis默认会监听容器所有网卡（0.0.0.0），确保Docker内部网络的其他容器能通过服务名redis访问。

2. 优化容器启动依赖 #

给redis-commander的depends_on添加健康检查条件，确保仅在Redis服务就绪后才启动Commander。

3. 统一Redis认证配置 #

使用Redis官方镜像的环境变量设置密码，避免command与environment重复配置。

最终Docker Compose配置 #

version: '3.8'

services:
  redis:
    image: redis:latest
    restart: always
    ports:
      - '6379:6379'
    environment:
      - REDIS_PASSWORD=myPassword
      - REDIS_USERNAME=myUsername
    volumes:
      - cache:/data
    healthcheck:
      test: ["CMD", "redis-cli", "--user", "redis://myUsername:myPassword@localhost:6379", "ping"]
      interval: 10s
      timeout: 5s
      retries: 3
      start_period: 5s

  redis-commander:
    image: rediscommander/redis-commander
    depends_on:
      redis:
        condition: service_healthy
    ports:
      - "8081:8081"
    environment:
      - REDIS_HOSTS=local:redis:6379:0:myPassword:myUsername

volumes:
  cache:

额外说明 #

• REDIS_HOSTS格式为name:host:port:db:password:username，这里命名为local方便在Redis-Commander界面识别。
• 健康检查命令改为带认证的redis-cli ping，确保能准确检测Redis服务就绪状态。
• 移除了无用的redis和redis-commander卷，Redis数据已挂载到cache卷。

内容的提问来源于stack exchange，提问作者Json