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通信,支持拦截器和请求缓存
四、手动部署流程
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 应用配置与启动
- 复制配置模板并修改:
cp redis-manager-dashboard/src/main/resources/application.properties.example redis-manager-dashboard/src/main/resources/application.properties
- 编辑配置文件,设置数据库连接:
# 数据库连接配置
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!
- 启动应用:
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
六、快速使用入门
6.1 首次访问与登录
- 打开浏览器访问:
http://服务器IP:8080 - 使用默认账号登录:admin/admin123
- 首次登录将强制要求修改密码
6.2 集群添加向导
- 在左侧菜单选择"集群管理"→"添加集群"
- 填写集群名称和至少一个节点地址(如:192.168.1.100:6379)
- 点击"测试连接"验证节点可达性
- 确认信息无误后点击"导入"完成添加
6.3 基本监控查看
添加集群后,可在"监控中心"查看:
- 集群整体健康状态
- 各节点内存、CPU使用情况
- 关键性能指标趋势图表
- 慢查询分析和热点Key识别
七、常见问题排查
7.1 数据库连接失败
症状:启动时报错"Unable to acquire JDBC Connection" 排查步骤:
- 检查MySQL服务是否正常运行
- 验证数据库账号密码是否正确
- 确认数据库URL中的主机和端口可访问
- 检查数据库驱动版本兼容性
7.2 集群无法连接
可能原因:
- Redis节点未开启远程访问权限
- 防火墙阻止了到Redis节点的连接
- Redis配置了密码但未在添加集群时提供
- 集群处于保护模式且未配置bind地址
💡 解决提示:尝试使用redis-cli命令手动连接节点,确认网络通畅。
7.3 监控数据不更新
若发现监控数据停止更新:
- 检查应用是否正常运行
- 查看日志文件中的错误信息
- 确认Redis节点是否开启了INFO命令权限
- 检查系统时间是否同步
八、高级功能配置
8.1 告警系统设置
Redis Manager提供多渠道告警功能:
- 在"告警管理"中创建告警渠道(邮件、钉钉等)
- 设置告警规则(如内存使用率阈值)
- 关联集群与告警规则
- 查看历史告警记录和处理状态
8.2 用户权限控制
为不同角色配置精细化权限:
- 在"用户管理"中创建用户账号
- 分配适当角色(管理员、操作员、只读用户)
- 设置集群访问权限
- 查看操作日志审计用户行为
通过以上配置,Redis Manager将成为您Redis集群运维的得力助手,大幅提升管理效率并降低操作风险。
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考








