redis/redisinsight
Redis Insight 是 Redis 官方推出的最佳图形用户界面（GUI）工具，它集数据结构可视化浏览与编辑、实时性能监控、集群管理、问题诊断及开发调试等功能于一体，能够帮助开发者和管理员更高效地操作与维护 Redis 数据库，凭借官方出品的可靠性和专业性，成为 Redis 生态中简化日常管理、提升工作效率的不可或缺的利器。
让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
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. 不持久化数据
直接运行容器，数据不会保留：
bashdocker run -d --name redisinsight -p 5540:5540 docker.xuanyuan.run/redis/redisinsight:latest
2. 持久化数据
需先将 Docker 卷挂载到 /data 路径，再执行命令：
bashdocker run -d --name redisinsight -p 5540:5540 -v redisinsight:/data docker.xuanyuan.run/redis/redisinsight:latest
权限问题处理
若上述命令返回权限错误，需确保 ID 为 1000 的用户对挂载的卷（如示例中的 redisinsight）有访问权限。
访问与健康检查
- 启动后，浏览器访问 `[] 即可使用。
- 健康检查端点：`[] 三、配置环境变量
可通过环境变量自定义 Redis Insight 运行参数，配置项如下：
| 变量名 | 用途 | 默认值 | 补充说明 |
|---|---|---|---|
| RI_APP_PORT | 监听端口 | Docker: 5540 桌面版: 5530 | 详见 [Express 文档] |
| RI_APP_HOST | 连接主机 | Docker: 0.0.0.0 桌面版: 127.0.0.1 | 详见 [Express 文档] |
| RI_SERVER_TLS_KEY | HTTPS 私钥 | n/a | PEM 格式（可路径或字符串），参考 [PEM 格式说明] |
| RI_SERVER_TLS_CERT | HTTPS 证书 | n/a | PEM 格式公钥证书，参考 [PEM 格式说明] |
| RI_ENCRYPTION_KEY | 数据加密密钥 | n/a | 仅 Docker 可用；用于加密本地存储的敏感信息（如数据库密码、Workbench 历史），需与后续 docker run 命令使用相同密钥解密 |
| RI_LOG_LEVEL | 日志级别 | info | 优先级从高到低：error > warn > info > http > verbose > debug > silly |
| RI_FILES_LOGGER | 日志写入文件 | true | Docker 日志路径：/data/logs；桌面版：<用户主目录>/.redisinsight-app/logs |
| RI_STDOUT_LOGGER | 日志输出到 STDOUT | true | |
| RI_PROXY_PATH | 代理子路径配置 | n/a | 仅 Docker 可用 |
| RI_DATABASE_MANAGEMENT | 禁用数据库连接管理 | true | 设为 false 时，无法添加、编辑或删除数据库连接 |
四、预配置数据库连接
Redis Insight 支持通过环境变量或 JSON 文件预配置数据库连接，实现集中化高效配置。以下是两种方式的具体操作：
方式一：通过环境变量配置
注意事项：
- 配置多个数据库连接时，需将每个环境变量中的
*替换为唯一标识符（如 1、2 等）；仅配置单个连接时可省略*，默认 ID 为 0。 - 修改环境变量后，需重启 Redis Insight 生效。
- 若重启时未携带这些环境变量，已添加的连接将被清除。
| 变量名 | 用途 | 默认值 | 补充说明 |
|---|---|---|---|
| RI_REDIS_HOST* | Redis 数据库主机 | N/A | |
| RI_REDIS_PORT* | Redis 数据库端口 | 6379 | |
| RI_REDIS_ALIAS* | 连接别名 | {host}:{port} | |
| RI_REDIS_USERNAME* | 连接用户名 | default | |
| RI_REDIS_PASSWORD* | 连接密码 | 无密码 | |
| RI_REDIS_TLS* | 是否启用 TLS 连接 | FALSE | 接受 TRUE 或 FALSE |
| RI_REDIS_TLS_CA_BASE64* | CA 证书（base64 格式） | N/A | 可通过此变量提供，或通过 RI_REDIS_TLS_CA_PATH* 指定文件路径 |
| RI_REDIS_TLS_CA_PATH* | CA 证书文件路径 | N/A | |
| RI_REDIS_TLS_CERT_BASE64* | 客户端证书（base64 格式） | N/A | 可通过此变量提供，或通过 RI_REDIS_TLS_CERT_PATH* 指定文件路径 |
| RI_REDIS_TLS_CERT_PATH* | 客户端证书文件路径 | N/A | |
| RI_REDIS_TLS_KEY_BASE64* | 客户端私钥（base64 格式） | N/A | 可通过此变量提供，或通过 RI_REDIS_TLS_KEY_PATH* 指定文件路径 |
| RI_REDIS_TLS_KEY_PATH* | 客户端私钥文件路径 | N/A |
方式二：通过 JSON 文件配置
注意事项：
- JSON 文件格式需与 Redis Insight 导出的数据库连接配置文件一致。
- 文件中需为每个连接指定唯一
id，避免冲突。 - 修改 JSON 文件后，需重启 Redis Insight 生效。
- 若移除 JSON 文件，通过该文件添加的连接将被清除。
五、Redis Insight API
API 文档地址：[]
更多相关 Docker 镜像与资源
以下是 redis/redisinsight 相关的常用 Docker 镜像，适用于 不同场景 等不同场景：
- redislabs/redisinsight Docker 镜像说明（RedisInsight 管理工具，Redis Labs 官方版本）
- oblakstudio/redisinsight Docker 镜像说明（RedisInsight 可视化管理，适合 Redis 数据浏览与调试）
- library/redis Docker 镜像说明（官方标准版本，适合通用场景）
- bitnami/redis Docker 镜像说明（企业级配置，适合生产环境）
- redislabs/redis Docker 镜像说明（官方实验与扩展版本）
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 redisinsight 镜像标签
DockerHub 原生拉取命令
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
"Docker访问体验非常流畅，大镜像也能快速完成下载。"