环境Windows Docker DesktopCompose 版本 3.9Redis6.2带密码认证、数据持久化、健康检查Redis‑Commander 自动预配置连接无需网页手动新增连接。没有密码看下面这个Docker Compose 一键部署 Redis Redis-Commander 可视化管理工具_redis docker-compose 官方推荐-CSDN博客一、整体说明Redis 开启密码访问禁止无密码访问外部配置文件挂载C:/docker/redis/config/redis.confRedis 数据持久化存储在 Docker 命名卷redis-data容器删除数据不丢失Redis‑Commander 使用官方原版镜像环境变量预配置 Redis 连接启动即自动连接 Redis自定义桥接网络my-network容器间使用容器名做域名通信健康检查监控 Redis 服务状态redis‑admin 等待 Redis 健康后才启动二、目录准备Windows 本地手动创建配置目录Docker 不会自动生成文件夹C:\docker\redis\config在该目录新建配置文件redis.conf内容如下bind 0.0.0.0 port 6379 requirepass Admin12456789⚠️重点注意requirepass密码不要加双引号引号会被识别为密码一部分造成认证失败。三、docker‑compose‑redis.yml 完整配置# docker compose -f docker-compose-redis.yml up -d # version: 3.9 version: 3.9 services: redis: image: redis:6.2 container_name: redis restart: always hostname: redis ports: - 6379:6379 volumes: - C:/docker/redis/config/redis.conf:/usr/local/etc/redis/redis.conf - redis-data:/data command: redis-server /usr/local/etc/redis/redis.conf networks: - my-network healthcheck: test: [CMD, redis-cli, -a, Admin12456789, ping] interval: 10s timeout: 5s retries: 3 redis-admin: # 替换为原版redis-commander镜像不再使用spryker老镜像 image: rediscommander/redis-commander:latest container_name: redis-admin hostname: redis-commander restart: always ports: - 8081:8081 environment: # REDIS_HOSTS格式名称:host:port:db:password - REDIS_HOSTSlocal:redis:6379:0:Admin12456789 - HTTP_USERadmin - HTTP_PASSWORDadmin networks: - my-network depends_on: redis: condition: service_healthy networks: my-network: driver: bridge volumes: redis-data:配置关键点解读redis 服务volumes挂载本地 redis 配置文件redis-data命名卷用于持久化 Redis 数据。command指定 Redis 加载挂载进来的外部配置文件启动。healthcheck带密码执行ping检测 Redis 可用性设置间隔、超时、重试次数。restart: alwaysdocker 重启自动拉起 redis 容器。redis‑admin 可视化面板使用官方镜像rediscommander/redis-commander:latest摒弃老旧 spryker 镜像修复密码带特殊字符解析 bug。REDIS_HOSTS环境变量预配置 Redis 连接无需网页手动添加连接容器内部使用容器名redis作为主机名访问 redis 服务。HTTP_USER / HTTP_PASSWORD面板登录账号密码。depends_on等待 redis 服务健康检查通过后才启动 redis‑admin避免启动顺序导致连接报错。网络与卷自定义 bridge 网络my-network两个服务接入同一网络容器之间可以用容器名做域名访问。redis-data命名卷持久化 Redis 数据容器销毁数据不会丢失。四、部署启停命令在docker‑compose‑redis.yml所在目录的 PowerShell 执行停止并销毁旧容器修改配置后必须执行清理旧环境变量docker compose -f docker-compose-redis.yml down后台启动服务docker compose -f docker-compose-redis.yml up -d查看容器运行状态docker compose -f docker-compose-redis.yml ps查看 redis‑admin 日志排查连接异常docker logs redis-admin五、验证服务1. 验证 Redis 本身密码连通docker exec -it redis redis-cli -a Admin12456789 ping正常返回PONG代表 redis 密码认证正常。2. 访问 Redis‑Commander 可视化面板浏览器访问http://127.0.0.1:8081登录账号admin密码admin进入页面会自动加载名为local的 Redis 连接直接操作 redis 数据不需要手动新增连接。六、常见踩坑汇总❌NOAUTH Authentication required原因密码配置不一致conf 文件密码带引号、或者 redis‑admin 环境变量密码写错conf 文件requirepass不要写引号。❌redis‑admin 尝试连接localhost:6379旧 spryker 镜像缺陷密码包含特殊符号解析错乱解决切换官方rediscommander/redis-commander:latest镜像。❌健康检查失败healthcheck 里面redis‑cli ping没有携带 redis 密码必须带上‑a 你的密码参数。❌修改 compose 配置后不生效只执行 up‑d 不会清理旧容器环境修改 yml 后必须先执行 down 再 up‑d。Windows 挂载配置文件报错找不到文件C:\docker\redis\config文件夹需要手动创建Docker 不会自动创建本地文件夹。七、客户端连接示例本地 redis‑cli 连接redis-cli -h 127.0.0.1 -p 6379 -a Admin12456789生产环境建议不要直接把 redis6379 端口暴露公网定期修改复杂密码使用 ACL 做细粒度账号权限管理。