redis/redisinsight

Redis Insight 介绍与使用指南

一、概述

Redis Insight 是面向 Redis 开发者的工具，支持各类 Redis 部署环境（包括 Redis Open Source、Redis Stack、Redis Enterprise Software、Redis Enterprise Cloud 及 Amazon ElastiCache），可优化开发流程。核心功能包括：可视化浏览与操作数据、提供高级命令行界面及诊断工具等（更多功能见 项目仓库）。

若你觉得 Redis Insight 实用，欢迎为 GitHub 仓库 点亮 star，让我们了解你对工具的认可。

二、通过 Docker 运行 Redis Insight

以下是两种 Docker 安装方式，按需选择：

1. 不持久化数据

直接运行容器，数据不会保留：

bash
docker run -d --name redisinsight -p 5540:5540 redis/redisinsight:latest

2. 持久化数据

需先将 Docker 卷挂载到 /data 路径，再执行命令：

bash
docker run -d --name redisinsight -p 5540:5540 -v redisinsight:/data redis/redisinsight:latest

权限问题处理

若上述命令返回权限错误，需确保 ID 为 1000 的用户对挂载的卷（如示例中的 redisinsight）有访问权限。

访问与健康检查

• 启动后，浏览器访问 `[***] 即可使用。
• 健康检查端点：`[***] 三、配置环境变量

可通过环境变量自定义 Redis Insight 运行参数，配置项如下：

四、预配置数据库连接

Redis Insight 支持通过环境变量或 JSON 文件预配置数据库连接，实现集中化高效配置。以下是两种方式的具体操作：

方式一：通过环境变量配置

注意事项：

• 配置多个数据库连接时，需将每个环境变量中的 * 替换为唯一标识符（如 1、2 等）；仅配置单个连接时可省略 *，默认 ID 为 0。
• 修改环境变量后，需重启 Redis Insight 生效。
• 若重启时未携带这些环境变量，已添加的连接将被清除。

方式二：通过 JSON 文件配置

注意事项：

• JSON 文件格式需与 Redis Insight 导出的数据库连接配置文件一致。
• 文件中需为每个连接指定唯一 id，避免冲突。
• 修改 JSON 文件后，需重启 Redis Insight 生效。
• 若移除 JSON 文件，通过该文件添加的连接将被清除。

五、Redis Insight API

API 文档地址：[***]