Beekeeper Studio 连接 Redis 完全指南ACL 认证、TLS/SSH 与 ReJSON 支持【免费下载链接】beekeeper-studioModern and easy to use SQL client for MySQL, Postgres, SQLite, SQL Server, and more. Linux, MacOS, and Windows.项目地址: https://gitcode.com/GitHub_Trending/be/beekeeper-studio导读本指南基于 Beekeeper Studio 官方用户手册与仓库源码完整讲解如何通过图形界面连接 Redis 实例。你将掌握连接表单中每个字段的含义与默认值、Redis 6 ACL 用户名认证的正确填写方式、TLS/SSL 加密连接与 SSH 隧道两种安全通道的使用场景以及 ReJSON 模块下 JSON 文档的浏览与编辑能力。同时结合 Redis 客户端实现 的源码细节帮助你理解 Beekeeper Studio 底层是如何与 Redis 通信的。连接 Redis 的基本步骤在 Beekeeper Studio 中连接 Redis 非常直接新建连接时从连接类型Connection Type下拉框中选择Redis填写连接信息后点击Connect即可完成连接。仓库中 Redis 的方言定义apps/studio/src/shared/lib/dialects/redis.ts为该类型专门配置了 Redis 命令编辑器模式text/x-redis连接后即可开始操作。连接表单本身复用了所有数据库通用的服务器输入组件apps/studio/src/components/connection/RedisForm.vue其核心输入项与默认值如下字段说明默认值HostRedis 服务器的 IP 地址或主机名127.0.0.1PortRedis 服务器监听的端口6379UsernameRedis 用户名可选Redis 6 配合 ACL 使用空PasswordRedis 密码可选空Database目标数据库编号0端口默认值6379在源码中有多处印证连接模型 saved_connection.ts 中redis类型的默认端口为6379客户端注册表 clients/index.ts 中同样声明了defaultPort: 6379以及defaultDatabase: 0。数据库编号会直接传入底层 Redis 客户端database: parseInt(this.database.database, 10) || 0用于选择逻辑数据库。用户名认证适配 Redis 6 的 ACLRedis 6 引入了访问控制列表Access Control ListsACL允许管理员创建多个拥有不同权限的用户。如果你的 Redis 服务器启用了 ACL在连接表单中同时填写Username与Password即可。使用 ACL 的 Redis 6 实例同时填写用户名与密码仅使用密码认证的旧版 Redis保持用户名为空只填写密码。该行为在客户端实现中完全对应connect() 方法 创建连接时username只在配置了用户时传入this.server.config.user || undefinedpassword则始终传递。另外客户端在连接建立后会调用HELLO握手探测服务器的 RESP 协议版本getRespVersion()默认按 RESP2 处理以决定后续命令返回值的解析方式。需要注意Redis 官方默认配置下服务端未设置密码且仅启用默认default用户此时用户名密码均可留空直接连接。支持的连接特性与安全通道连接 Redis 后Beekeeper Studio 提供以下核心能力键Key的浏览与查看键值的编辑面向 Redis 命令的 AI Shell 支持ReJSON 模块支持查看与编辑存储在 Redis 中的 JSON 文档SSH 隧道连接TLS/SSL 加密连接。关于能力边界从源码可以看到真实情况客户端注册表 clients/index.ts 中 Redis 类型禁用了server:schema、server:domain、server:ssh等特性标注但从RedisClient.supportedFeatures()redis.ts的实现看SSH 隧道与 TLS 的连接选项实际由通用连接框架提供同时客户端明确实现了truncateAllTables()对应FLUSHDB与getTableLength()对应DBSIZE等运维操作。注连接表单中的 SSH 隧道与 TLS 配置项由 Beekeeper Studio 通用连接面板提供未在 Redis 专用表单中单独实现实际可用性以你安装版本的界面为准。ReJSON 模块支持JSON 文档的查看与编辑如果你的 Redis 服务器安装了 ReJSON 模块Redis Stack 的组成部分Beekeeper Studio 可以显示并编辑通过JSON.SET写入的 JSON 值且在值查看器中 JSON 数据会以语法高亮渲染。从 fetchRedisValue() 的实现可以看到读取 ReJSON 值时客户端调用json.get(key, { path: [$] })并返回路径$下的首个结果写入时setRedisValue()中ReJSON-RL分支调用json.set(key, $, value)。也就是说ReJSON 键在查看器中与普通 string 键一样可读可改内部自动走 JSON 模块命令。键浏览与编辑的底层机制把 Redis 抽象成一张keys 表是 Beekeeper Studio 处理 Redis 的核心设计redis.tslistTables()返回一张名为keys的逻辑表listViews()返回一张名为info的逻辑视图keys表的列包括key、value、type、encoding、ttl、memory六列其中type/encoding/memory为生成列key被视为主键getPrimaryKeys()info视图的内容来自INFO命令的输出被解析为键值对parseInfo()。当你浏览表数据时客户端会执行SCAN命令游标式遍历scanAll()支持MATCH、COUNT、TYPE参数随后对每个键并行调用TYPE、MEMORY USAGE、OBJECT ENCODING、TTL以及按类型取值的命令获取完整行信息。表头筛选输入框中的文本会被自动补上*通配符selectTop()转成SCAN ... MATCH pattern*执行相当于 Redis 的键名模糊搜索。针对不同数据类型取值与写入分别映射如下Redis 类型读取命令编辑写入命令stringGETSET自动尝试按 JSON 解析listLRANGE key 0 -1删除后LPUSH注意倒序插入setSMEMBERS删除后SADDhashHGETALL删除后逐字段HSETzsetZRANGE key 0 -1 WITHSCORES删除后ZADDstreamXRANGE key - 删除后按XADD逐条追加ReJSON-RLJSON.GET key $JSON.SET key $ value在结果网格中直接编辑单元格后保存动作会触发executeApplyChanges()redis.ts对key列的修改转为RENAME对ttl列的修改转为EXPIRE/PERSIST-1表示持久化对value列的修改则先判断现有键类型、必要时从值结构推断类型inferTypeFromValue()再走上表对应的写入命令删除行对应DEL新增行则先创建空字符串键SET key 。在查询编辑器中执行 Redis 命令Beekeeper Studio 为 Redis 提供了命令编辑器编辑器模式text/x-redis你可以在查询标签页中直接输入并执行原生 Redis 命令。底层executeCommand()redis.ts的实现要点支持一次输入多行命令按行拆分、逐条执行#开头的行为注释被跳过使用redis-splitargs解析命令行并从内置于 ui-kit 的redisCommands.json命令文档中识别命令名执行走sendCommand()并利用 Redis 官方命令定义表redis/client的 COMMANDS将原始回复按 RESP 版本转换例如SET类命令、ZRANGE ... WITHSCORES会被转换成{value, score}对象数组结果渲染做了友好化处理INFO解析为键值对、SCAN/HSCAN/SSCAN/ZSCAN解析为游标结果集、普通对象/数组/标量分别以合适的表格形式呈现只读模式下连接配置了 Read-Only非只读命令会被拦截并返回错误提示Redis 命令无法取消cancel()为空实现。例如输入SET user:1 {\name\:\Alice\} GET user:1 INFO server会依次返回各命令的结果SET返回OKGET返回 JSON 字符串INFO server则以键值对表格展示服务器信息包含redis_version等字段集成测试 redis.spec.ts 中有对应断言。集成测试验证仓库为 Redis 客户端提供了完整的集成测试apps/studio/tests/integration/lib/db/clients/redis.spec.ts测试通过 Testcontainers 启动真实的 Redis 容器初始化脚本位于 dev/docker_redis/覆盖了键的增删改查、各数据类型读写、EVAL/SCRIPT LOAD脚本命令、INFO解析以及ZRANGE WITHSCORES的转换等场景。这意味着本指南描述的行为均经过真实 Redis 实例的验证可放心作为使用参考。常见问题排查建议认证失败确认 Redis 版本Redis 6 启用 ACL 时需同时填写用户名与密码旧版只填密码并保持用户名为空连接超时检查 Host/Port 是否与redis.conf中的bind和port一致并确认服务器防火墙放行了6379端口远程连接建议优先使用 SSH 隧道或在服务器启用 TLS 后勾选 SSL 并配置相应证书客户端支持从sslCaFile、sslCertFile、sslKeyFile读取 PEM 证书内容参见 connect()看不到键确认选择了正确的 Database 编号Redis 默认 16 个逻辑库客户端通过CONFIG GET databases探测数量失败时回退为 16只读模式下命令被拒连接若启用了 Read-Only 模式SET、DEL等写命令会被拦截仅可执行只读命令。小结连接 Redis 只需在连接类型中选择Redis并填写主机、端口必要时补充用户名与密码。在此基础上Beekeeper Studio 通过keys 逻辑表 SCAN 游标 按类型映射读写命令的抽象提供了键浏览、值编辑、TTL 修改、命令编辑器以及 ReJSON JSON 文档查看等一整套可视化操作能力并通过 TLS/SSH 保障远程连接安全。如需更多连接与配置细节可继续阅读 连接指南 与 支持的数据库总览。【免费下载链接】beekeeper-studioModern and easy to use SQL client for MySQL, Postgres, SQLite, SQL Server, and more. Linux, MacOS, and Windows.项目地址: https://gitcode.com/GitHub_Trending/be/beekeeper-studio创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考