Tiny RDM Redis 客户端安装部署完整指南：Mac、Windows、Linux 与 Docker 快速上手、源码构建与故障排查清单

Tiny RDM Redis 客户端安装部署完整指南Mac、Windows、Linux 与 Docker 快速上手、源码构建与故障排查清单【免费下载链接】tiny-rdmTiny RDM (Tiny Redis Desktop Manager) - A modern, colorful, super lightweight Redis GUI client for Mac, Windows, and Linux. It also provides a web version that can be deployed via Docker.项目地址: https://gitcode.com/GitHub_Trending/ti/tiny-rdm在刚重置的 Mac 上双击 Tiny RDM系统直接弹出无法打开因为无法验证开发者同事的 Linux 上运行编译出的二进制窗口闪一下就退出终端里是libwebkit2gtk相关的动态库报错。这两个现场是 Tiny RDM 首次部署最常见的坑都发生在装完之后、连上之前。Tiny RDM 是一款基于 Wails 的轻量级跨平台 Redis GUI 客户端Mac/Windows/Linux支持 String、List、Hash、Set、ZSet、Stream 的可视化 CRUDSSH 隧道/SSL/哨兵/集群连接、实时命令监控和 20 余种数据解码器。本文按先选路线、再照步骤做、出错查表的方式覆盖桌面安装包、Docker Web 版、源码构建三条路线并附集中排错速查表。路线速览先判断你该走哪条三条路线的差异决定了你要准备的东西完全不同。按访问方式和目的自判判断依据个人本机用选路线一团队共享或无桌面环境如远程 Linux 服务器选路线二要动 Go 后端backend/services/或 Vue 前端frontend/src/才走路线三。快速上手路线桌面包安装与 Web 版部署桌面端检查清单 → 安装 → 成功判定三步走平台差异全部收进下面这张对照表不重复叙述。第一步装之前确认依赖检查项WindowsmacOSLinux最低要求Win 10/11x64/arm64macOS 12x64GTK3 WebKit 环境必备运行时WebView2 RuntimeWin10/11 通常已预装无特殊依赖libwebkit2gtk-4.0-37、libgtk-3-0缺失时的安装命令在设置 → 应用中查找并安装 WebView2—sudo apt install libwebkit2gtk-4.0-37 libgtk-3-0Debian/Ubuntu或sudo dnf install webkit2gtk4.0 gtk3Fedora安装包形态.exe安装包.dmg镜像.deb/.rpm/.tar.gz安装动作双击走向导拖入应用程序sudo dpkg -i tinyrdm_x.x.x_amd64.deb缺依赖再sudo apt install -f第二步启动并处理首次拦截macOS 若提示无法验证开发者两种解法任选其一sudo xattr -d com.apple.quarantine /Applications/Tiny\ RDM.app后重开或在系统设置 → 隐私与安全性页面底部点仍要打开。Linux 若窗口闪退先跑ldd检查动态库见文末速查表补装 WebKit 依赖即可。第三步成功判定启动后左侧是连接管理面板中间是 Key 浏览器。新建连接时填入 Redis 地址、端口、密码支持 SSH 隧道、SSL、哨兵、集群模式对话框会先发PING测试返回PONG才算连上连上后执行SET test_key ok再GET能读到值即部署完成。Web 版Docker 五分钟部署Web 版由 nginx前端静态文件 反代监听 8086和 Go 后端API/WebSocket内部 8088组成仓库内已自带 docker-compose.yml核心配置如下services: tinyrdm: image: ghcr.io/tiny-craft/tiny-rdm:latest ports: - 8086:8086 # 浏览器访问入口 environment: - ADMIN_USERNAMEadmin # 登录用户名必须设置 - ADMIN_PASSWORDtinyrdm # 登录密码必须设置 volumes: - ./data:/app/tinyrdm # 连接配置与偏好持久化docker compose up -d # 启动后浏览器访问 http://localhost:8086 登录 docker compose logs -f # 登录失败/端口不通时先看这里成功判定8086 能登录进主界面且容器重建后数据落在./data连接配置不丢。若换机器部署只需把./data目录和 compose 文件一起带走。源码构建路线环境准备到产物输出环境准备组件版本要求验证命令Go1.25go.mod 声明go 1.25.0go versionNode.js20frontend/package.json 使用 Vite 8node -vnpm9npm -vWails CLI最新 v2go install github.com/wailsapp/wails/v2/cmd/wailslatestLinux 额外项build-essential、pkg-config、libwebkit2gtk-4.0-dev仅桌面编译需要dpkg -l \| grep webkit2gtk构建步骤git clone https://gitcode.com/GitHub_Trending/ti/tiny-rdm --depth1 cd tiny-rdm/frontend npm install cd .. # 装前端依赖 wails dev # 开发模式热重载改前端即时生效 wails build -clean -production # 生产构建产物位置build/bin/Tiny RDMWindows 为.exemacOS 为.app目录。常用自定义选项-icon build/appicon.png换图标、-o ./dist/换输出目录。需要 Web 版二进制时不必手动装两套工具链直接用仓库根目录的 Dockerfile 多阶段构建node:22-alpine 编前端 golang:1.25-alpine 以-tags web编后端VITE_WEBtrue切换 Web 模式docker build -t tiny-rdm:local . # 产出与 compose 中同构的镜像端口同为 8086故障速查表报错先查这里现象 / 报错可能原因解决macOS 提示无法打开因为无法验证开发者Gatekeeper 隔离属性sudo xattr -d com.apple.quarantine /Applications/Tiny\ RDM.app或隐私与安全性中点仍要打开Linux 双击后窗口闪退终端提示libwebkit2gtk-4.0/libgtk-3.so找不到系统缺 WebKit/GTK 运行时sudo apt install libwebkit2gtk-4.0-37 libgtk-3-0Debian/Ubuntusudo dnf install webkit2gtk4.0 gtk3FedoraWindows 启动即崩溃或白屏缺 WebView2 Runtime安装Microsoft Edge WebView2 Runtime企业机检查应用白名单连接失败dial tcp: ... i/o timeout网络不通、安全组/防火墙拦了 6379nc -zv host 6379先验证端口再查云安全组与 Redisbind/protected-mode连接失败WRONGPASS或登录后NOAUTH密码填错或哨兵模式下填成了数据节点密码哨兵连接应填 sentinel 的requirepass用redis-cli -p 6379 auth pwd先自验哨兵模式提示找不到 master客户端填的 master-name 与服务端不一致redis-cli -p 26379 sentinel masters抄准名字集群模式部分操作报MOVED/超时只配了部分节点个别节点不可达redis-cli -h node cluster info确认cluster_state:ok客户端节点列表补全Web 版docker compose up后 8086 打不开端口被占用或映射写错ss -lntp \| grep 8086找占用进程compose 中改为8087:8086Web 版一直登录失败ADMIN_USERNAME/ADMIN_PASSWORD未设置或改动后未重启改环境变量后必须docker compose up -d重建容器才生效Linux 源码编译报 webkit 头文件缺失缺开发包运行时库不够sudo apt install libwebkit2gtk-4.0-dev pkg-config build-essential换机后连接配置全丢没带数据目录桌面版配置在~/.config/TinyRDMmacOS 为~/Library/Application Support/TinyRDMWindows 为%APPDATA%\TinyRDM整体拷走即可Web 版拷./data进阶调优连接、加载与扩展大 Key 空间列表 Key 默认走SCAN分段加载而非KEYS百万级 Key 不会把服务端卡死List/Hash/Set/ZSet 的值也支持分段拉取阈值可在界面偏好中调整。自定义编解码Value 展示支持自定义 decoder解码器配置文件存放在配置目录的TinyRDM/decoder子目录下路径实现见 backend/utils/convert/common.goBase64、Gzip、zstd、MessagePack 等 20 余种开箱即用。连接画像迁移连接配置支持导出/导入文件团队内交接环境时直接传文件不用逐条手填。Web 版运维GIN_MODErelease关闭调试日志会话过期时长可通过SESSION_TTL默认 24h调整敏感操作前用docker compose logs确认后端收到的请求。监控内置实时命令监控与慢日志面板排查谁在扫全库时比直接MONITOR可控。下一步行动清单按路线速览确定路线桌面包 / Docker Web / 源码构建三选一。按对应小节的三步走完成部署以PING 返回 PONG、GET 能读回 SET 的值为验收标准。出错不猜先查上文故障速查表表中没有的再docker compose logs -fWeb 版或看终端输出桌面版。需要定制时从 frontend/Vue 3 Naive UI或 backend/Go Wails 绑定入手本地用wails dev热调。语言与多语言文案在 frontend/src/langs/中/英/日/韩/西/法/德等 10 种接口路由见 backend/api/router.go许可协议见 LICENSE。【免费下载链接】tiny-rdmTiny RDM (Tiny Redis Desktop Manager) - A modern, colorful, super lightweight Redis GUI client for Mac, Windows, and Linux. It also provides a web version that can be deployed via Docker.项目地址: https://gitcode.com/GitHub_Trending/ti/tiny-rdm创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考