RedisInsight:macOS 上管理 Redis 的 GUI 工具使用指南
2026/9/19 12:45:42 网站建设 项目流程

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_PORT5540内置 API 服务端口redisinsight/api/config/default.ts
RI_CONNECTIONS_TIMEOUT_DEFAULT30000建立 Redis 连接的超时(毫秒)同上
RI_SCAN_COUNT_DEFAULT200key 扫描时每批取的条数同上
RI_MAX_PAYLOAD_SIZE512MB单次 HTTP 请求体上限同上
RI_COMMAND_EXECUTION_MAX_RESULT_SIZE1048576Workbench 结果展示上限(字节)同上
RI_LOG_LEVELinfo日志级别同上
RI_DATA_DIR应用数据目录本地数据(含 SQLite 库)存放位置同上
RI_REDIS_CLIENTS_IDLE_THRESHOLD3600000空闲连接回收阈值(毫秒)同上

以上均定义在 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),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询