RedisInsight:macOS 上管理 Redis 的 GUI 工具使用指南
【免费下载链接】RedisInsightRedis GUI by Redis项目地址: https://gitcode.com/GitHub_Trending/re/RedisInsight
Redis Insight 是 Redis 官方推出的 Redis GUI 工具,支持浏览 key、执行命令、分析慢查询,覆盖 Redis OSS、Cluster 与 Cloud,适合在 macOS 上做开发联调与运维排障的你。
先跑起来——安装与首次连接
- 直接安装:从官网 redis.io/insight 的 mac.target。
- 源码构建:
git clone https://gitcode.com/GitHub_Trending/re/RedisInsight cd RedisInsight yarn install# 按你的芯片选择一条 npm run package:mac:arm # Apple Silicon npm run package:mac # Intel首次启动进入 Add a database,选择 Standalone(Redis OSS)类型,填写主机与端口(本地默认localhost:6379),点 Connect 即完成第一个连接。
日常怎么用——三个高频操作
浏览 key 并查看过期时间
在 Browser 页签输入 key 名或用*模式扫描。点击某个 key 打开详情页,Header 区直接展示 TTL(剩余过期时间)、类型、所属 db;右侧面板可编辑 value,支持 JSON、Hex、ASCII 等显示格式。对应界面在 redisinsight/ui/src/pages/browser/。
在 Workbench 执行命令
打开实例后切到 Workbench,输入命令即可获得自动补全;执行结果按数据结构类型可视化,支持 raw 模式查看原始输出,历史命令可在输入框内回翻。Workbench 的返回结果大小上限由RI_COMMAND_EXECUTION_MAX_RESULT_SIZE控制,默认 1MB。源码位于 redisinsight/ui/src/pages/workbench/。
定位慢命令
进入实例的 Slow Log 页签,基于 Redis 原生 SLOWLOG 命令列出耗时命令及其发生时间。需要逐条观察实时请求时,切到 Profiler 页签,可以看到每条命令的执行耗时与参数。页面入口在 redisinsight/ui/src/pages/slow-log/。
Mac 平台上的差异点
- 官方 DMG 同时提供 x64 与 arm64 架构,Apple Silicon 无需 Rosetta 转译运行。
- 连接凭据默认通过 keytar 模块存入 macOS 系统钥匙串,而不是明文文件,由 redisinsight/api/config/default.ts 中
encryption.keytar(默认开启)控制。 - 分发版启用 hardenedRuntime 与 notarize,签名权限见 resources/entitlements.mac.plist;App Store 版另用
mas配置打包,入口在 electron-builder-mas.js。 - 界面默认支持 macOS 深色模式(
darkModeSupport配置)。
配置项速查
| 配置项 | 默认值 | 作用 | 对应文件路径 |
|---|---|---|---|
| RI_APP_PORT | 5540 | 内置 API 服务端口 | redisinsight/api/config/default.ts |
| RI_CONNECTIONS_TIMEOUT_DEFAULT | 30000 | 建立 Redis 连接的超时(毫秒) | 同上 |
| RI_SCAN_COUNT_DEFAULT | 200 | key 扫描时每批取的条数 | 同上 |
| RI_MAX_PAYLOAD_SIZE | 512MB | 单次 HTTP 请求体上限 | 同上 |
| RI_COMMAND_EXECUTION_MAX_RESULT_SIZE | 1048576 | Workbench 结果展示上限(字节) | 同上 |
| RI_LOG_LEVEL | info | 日志级别 | 同上 |
| RI_DATA_DIR | 应用数据目录 | 本地数据(含 SQLite 库)存放位置 | 同上 |
| RI_REDIS_CLIENTS_IDLE_THRESHOLD | 3600000 | 空闲连接回收阈值(毫秒) | 同上 |
以上均定义在 redisinsight/api/config/default.ts,以环境变量覆盖默认值;桌面端运行时可在 redisinsight/desktop/config.json 中查看默认环境。
遇到问题时
- 现象:连接提示超时或失败。原因:默认连接超时仅 30 秒,网络慢或被防火墙拦截。解法:先确认防火墙放行 6379、TLS 设置与 Redis 端一致;仍超时则在启动环境中调大
RI_CONNECTIONS_TIMEOUT_DEFAULT。 - 现象:首次打开 DMG 提示"无法验证开发者"。原因:Gatekeeper 对未走 App Store 渠道应用的默认检查。解法:右键点应用图标选"打开",或在"系统设置 > 隐私与安全性"中点"仍要打开"。
- 现象:启动报错加载 better-sqlite3 或 keytar 原生模块失败。原因:预编译二进制与当前 CPU 架构不匹配。解法:执行
npm run rebuild重新编译,或重新下载与芯片匹配的发行版。
更多入口见 README.md 的 How to debug 与 Feedback 章节,反馈可直接提交到项目 Issues 区。
【免费下载链接】RedisInsightRedis GUI by Redis项目地址: https://gitcode.com/GitHub_Trending/re/RedisInsight
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考