Docker Compose 一键部署 Redis + Redis-Commander 可视化管理工具

一、方案简介

本文提供一套完整 docker-compose-redis.yml 编排文件，可一次性启动 Redis 6.2 服务与 Redis Commander 可视化管理面板，具备容器自重启、健康检查、持久化配置、内置网桥网络、登录鉴权等能力，适配 Windows Docker Desktop 环境，开箱即用。 整体架构分为两个服务：

1. redis：核心 Redis 缓存服务，挂载自定义配置文件，对外开放 6379 端口；
2. redis-admin（redis-commander）：Web 可视化管理后台，通过内网连接 Redis，提供页面操作 Redis 数据，访问端口 8081，内置账号密码登录。

二、完整 Compose 配置文件

文件名：docker-compose-redis.yml

# docker compose -f docker-compose-redis.yml up -d
version: '3.9'

services:
# Redis
  redis:
    image: redis:6.2
    container_name: redis
    restart: always
    hostname: redis
    privileged: true
    ports:
      - 6379:6379
    volumes:
      - C:/docker/redis/config/redis.conf:/usr/local/etc/redis/redis.conf
    command: redis-server /usr/local/etc/redis/redis.conf
    networks:
      - my-network
    healthcheck:
      test: [ "CMD", "redis-cli", "ping" ]
      interval: 10s
      timeout: 5s
      retries: 3

  # RedisAdmin https://github.com/joeferner/redis-commander
  redis-admin:
    image: spryker/redis-commander:0.8.0
    container_name: redis-admin
    hostname: redis-commander
    restart: always
    ports:
      - 8081:8081
    environment:
      - REDIS_HOSTS=local:redis:6379
      - HTTP_USER=admin
      - HTTP_PASSWORD=admin
      - LANG=C.UTF-8
      - LANGUAGE=C.UTF-8
      - LC_ALL=C.UTF-8
    networks:
      - my-network
    depends_on:
      redis:
        condition: service_healthy

networks:
  my-network:
    driver: bridge

redis.conf文件

文件存放地址： C:/docker/redis/config/redis.conf

bind 0.0.0.0
port 6379

三、配置逐段解析

1. 版本与基础规范

version: '3.9'：指定 Compose 文件语法版本，兼容新版 Docker Desktop。

2. Redis 核心服务配置

配置项	作用说明
image: redis:6.2	固定使用 Redis 6.2 镜像，版本稳定兼容多数业务
container_name: redis	固定容器名称，方便 docker exec 进入容器操作
restart: always	容器异常退出、宿主机重启后自动拉起，保障服务常驻
privileged: true	赋予容器高级权限，适配持久化、内核参数修改场景
ports: 6379:6379	端口映射，宿主机 6379 端口对外提供 Redis 连接
volumes 挂载	Windows 本地路径 C:/docker/redis/config/redis.conf 挂载至容器，支持自定义 Redis 持久化、密码、最大内存等配置
command	启动时加载外部自定义配置文件
healthcheck 健康检查	每 10 秒执行 redis-cli ping 检测服务存活，超时 5 秒，最多重试 3 次；未就绪时标记服务不健康

3. Redis Commander 可视化管理面板

1. 镜像 ：spryker/redis-commander:0.8.0，开源 Redis Web 管理工具，项目开源地址：https://github.com/joeferner/redis-commander
2. 访问端口 ：8081，浏览器访问 http://127.0.0.1:8081 即可打开管理页面
3. 环境变量说明
   • REDIS_HOSTS=local:redis:6379：通过自定义网桥网络，使用容器名 redis 内网互通，无需暴露公网 IP
   • HTTP_USER / HTTP_PASSWORD：Web 登录账号密码，默认均为 admin，生产环境务必修改
   • 多语言 UTF-8 配置：避免中文 key/value 乱码
4. depends_on 依赖控制 condition: service_healthy：仅当 Redis 健康检查通过后，才启动管理面板，避免启动时报 Redis 连接失败。

4. 自定义网桥网络 my-network

单独创建 bridge 网桥，两个服务加入同一网络，容器间可通过 hostname 互相访问，隔离宿主机其他容器，网络更安全清晰。

四、部署前置准备（Windows 环境）

1. 在本地创建目录：C:/docker/redis/config/
2. 下载官方 redis.conf 配置文件放入该目录，可按需修改：设置访问密码、开启 RDB/AOF 持久化、限制最大内存、关闭保护模式等；
3. 确保本地已安装并启动 Docker Desktop。

五、常用操作命令

1. 后台启动服务

docker compose -f docker-compose-redis.yml up -d

2. 查看容器运行日志

# 查看redis日志
docker logs redis
# 查看管理面板日志
docker logs redis-admin

3. 停止服务（保留数据与配置）

docker compose -f docker-compose-redis.yml down

4. 停止并删除镜像 / 容器（清空环境）

docker compose -f docker-compose-redis.yml down --rmi all

5. 进入 Redis 容器命令行

docker exec -it redis redis-cli

六、访问与使用

1. Redis 客户端连接 本地工具（Redis Desktop Manager、Another Redis Desktop Manager）连接地址：127.0.0.1:6379，配置文件设置密码后需携带密码登录。
2. Web 可视化后台 浏览器访问：http://localhost:8081 登录账号：admin /admin 功能：查看所有库、增删改查 Key、批量操作、监控 Redis 状态、查看慢日志等。

七、生产环境优化建议

1. 修改 Redis Commander 登录账号密码，避免默认弱口令；
2. redis.conf 中配置 Redis 访问密码，禁止无密码暴露公网；
3. 增加数据持久化挂载目录，将 RDB/AOF 文件映射到宿主机，防止容器删除数据丢失；
4. 限制容器内存，通过 mem_limit 配置防止 Redis 占用宿主机全部内存；
5. 服务器部署（Linux）需修改 volume 挂载路径，将 Windows 路径替换为 Linux 本地目录如 /data/redis/config/redis.conf；
6. 对外使用防火墙限制 6379、8081 端口访问，仅内网信任 IP 可连接。

八、总结

这套 Compose 编排实现 Redis 服务与可视化管理工具一体化部署，自带健康检查、自启动、内网互通能力，大幅降低本地 / 测试环境 Redis 部署成本。无需单独安装 Redis，一条命令即可完成整套环境搭建，可视化面板替代命令行操作，适合开发、测试场景快速使用，简单调整配置后也可用于内网测试服务器。

---

---

---