Redis Manager：一站式Redis集群管理平台使用指南

一、Redis Manager功能全景

1.1 核心能力概览

Redis Manager是一款面向Redis集群的全方位管理工具，提供从集群部署到日常运维的完整解决方案。无论是监控集群健康状态、执行数据操作，还是配置告警规则，都能通过直观的界面完成，避免了复杂的命令行操作。

1.2 主要应用场景

• 集群可视化管理：通过图形化界面查看节点状态、槽位分布和复制关系
• 实时性能监控：跟踪内存使用、命中率、QPS等关键指标
• 数据操作中心：支持键值对的增删改查及批量操作
• 智能告警系统：自定义告警规则并通过多种渠道推送通知
• 自动化部署：支持在多种环境中快速部署Redis集群

图1：Redis Manager控制台首页，展示集群状态概览

二、部署环境准备

2.1 基础依赖说明

在开始部署前，请确保环境满足以下要求：

• Java运行时：JDK 8或更高版本（用于运行后端服务）
• 数据库：MySQL 5.7+（存储配置和监控数据）
• 构建工具：Maven 3.5+（用于编译源代码）
• 容器支持：Docker 19.03+（如选择容器化部署）

💡 系统资源建议：生产环境建议至少2核CPU、4GB内存，确保监控数据处理流畅。

2.2 数据库环境配置

首先创建专用数据库和用户：

CREATE DATABASE redis_manager CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'redis_user'@'localhost' IDENTIFIED BY 'SecurePassword123!';
GRANT ALL PRIVILEGES ON redis_manager.* TO 'redis_user'@'localhost';
FLUSH PRIVILEGES;

📌 安全提示：请将上述密码替换为强密码，并限制数据库访问IP。

三、核心技术栈解析

3.1 后端技术架构

• Spring生态：基于Spring Boot构建RESTful API，简化配置与部署
• 数据访问层：MyBatis-Plus提供高效数据库操作支持
• Redis客户端：Jedis和Lettuce双客户端支持，适配不同Redis版本
• 任务调度：Quartz实现定时任务，处理监控数据采集和报告生成

3.2 前端技术栈

• Vue.js框架：轻量级JavaScript框架，构建响应式用户界面
• Element UI：提供丰富的UI组件，加速界面开发
• ECharts：实现监控数据的可视化展示
• Axios：处理前后端HTTP通信，支持拦截器和请求缓存

图2：数据操作模块支持多种Redis数据类型的可视化管理

四、手动部署流程

4.1 源代码获取与编译

首先获取项目源代码并构建：

# 克隆项目仓库到本地
git clone https://gitcode.com/gh_mirrors/re/redis-manager
cd redis-manager

# 使用Maven构建项目，跳过测试以加速构建
mvn clean package -DskipTests

构建成功后，会在redis-manager-dashboard/target目录下生成可执行JAR文件。

4.2 应用配置与启动

1. 复制配置模板并修改：

cp redis-manager-dashboard/src/main/resources/application.properties.example redis-manager-dashboard/src/main/resources/application.properties

2. 编辑配置文件，设置数据库连接：

# 数据库连接配置
spring.datasource.url=jdbc:mysql://127.0.0.1:3306/redis_manager?useUnicode=true&characterEncoding=utf-8&serverTimezone=Asia/Shanghai
spring.datasource.username=redis_user
spring.datasource.password=SecurePassword123!

3. 启动应用：

cd redis-manager-dashboard
java -jar target/redis-manager-dashboard-1.0.0.jar

启动成功后，控制台会显示"Started RedisManagerApplication"信息。

4.3 前端资源构建

如果前端代码有修改，需要单独构建：

cd redis-manager-ui/redis-manager-vue
npm install
npm run build

构建产物会输出到dist目录，可通过Nginx等Web服务器提供访问。

五、容器化部署方案

5.1 Docker快速部署

对于追求简单部署的场景，推荐使用Docker：

# 拉取并启动容器
docker run -d --name redis-manager \
  -p 8080:8080 \
  -e DATASOURCE_URL="jdbc:mysql://127.0.0.1:3306/redis_manager?useUnicode=true&characterEncoding=utf-8&serverTimezone=Asia/Shanghai" \
  -e DATASOURCE_USERNAME="redis_user" \
  -e DATASOURCE_PASSWORD="SecurePassword123!" \
  reasonduan/redis-manager

📌 参数说明：-p参数映射容器端口到主机，-e参数设置环境变量。

5.2 自定义Docker构建

如需基于最新代码构建镜像：

# 在项目根目录执行构建
docker build -t my-redis-manager -f docker/Dockerfile .

# 使用自定义镜像启动
docker run -d --name redis-manager -p 8080:8080 my-redis-manager

图3：Docker部署配置界面，支持自动和手动模式

六、快速使用入门

6.1 首次访问与登录

1. 打开浏览器访问：http://服务器IP:8080
2. 使用默认账号登录：admin/admin123
3. 首次登录将强制要求修改密码

6.2 集群添加向导

1. 在左侧菜单选择"集群管理"→"添加集群"
2. 填写集群名称和至少一个节点地址（如：192.168.1.100:6379）
3. 点击"测试连接"验证节点可达性
4. 确认信息无误后点击"导入"完成添加

图4：集群导入向导，支持多种Redis部署模式

6.3 基本监控查看

添加集群后，可在"监控中心"查看：

• 集群整体健康状态
• 各节点内存、CPU使用情况
• 关键性能指标趋势图表
• 慢查询分析和热点Key识别

七、常见问题排查

7.1 数据库连接失败

症状：启动时报错"Unable to acquire JDBC Connection" 排查步骤：

1. 检查MySQL服务是否正常运行
2. 验证数据库账号密码是否正确
3. 确认数据库URL中的主机和端口可访问
4. 检查数据库驱动版本兼容性

7.2 集群无法连接

可能原因：

• Redis节点未开启远程访问权限
• 防火墙阻止了到Redis节点的连接
• Redis配置了密码但未在添加集群时提供
• 集群处于保护模式且未配置bind地址

💡 解决提示：尝试使用redis-cli命令手动连接节点，确认网络通畅。

7.3 监控数据不更新

若发现监控数据停止更新：

1. 检查应用是否正常运行
2. 查看日志文件中的错误信息
3. 确认Redis节点是否开启了INFO命令权限
4. 检查系统时间是否同步

图5：Redis性能监控面板，展示关键指标实时数据

八、高级功能配置

8.1 告警系统设置

Redis Manager提供多渠道告警功能：

1. 在"告警管理"中创建告警渠道（邮件、钉钉等）
2. 设置告警规则（如内存使用率阈值）
3. 关联集群与告警规则
4. 查看历史告警记录和处理状态

图6：告警规则管理界面，支持多种触发条件

8.2 用户权限控制

为不同角色配置精细化权限：

1. 在"用户管理"中创建用户账号
2. 分配适当角色（管理员、操作员、只读用户）
3. 设置集群访问权限
4. 查看操作日志审计用户行为

通过以上配置，Redis Manager将成为您Redis集群运维的得力助手，大幅提升管理效率并降低操作风险。