Tiny RDM 跨平台安装指南：Windows、macOS、Linux 三平台一次配好

Tiny RDM 跨平台安装指南Windows、macOS、Linux 三平台一次配好【免费下载链接】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-rdmTiny RDM 是一个基于 Wails 框架的轻量级 Redis GUI 客户端后端用 Go 编写、前端用 Vue 实现打包后不内嵌浏览器安装包通常只有十几 MB。它解决的核心问题是在日常开发中需要查看和修改 Redis 里的 String、Hash、List、Set、ZSet、Stream 数据时不想每次切回命令行。完成一次 Tiny RDM 跨平台安装后你可以新建连接、浏览 Key、做可视化 CRUD、对 value 做 Base64/Gzip 等解码并实时监控服务器命令。本文按先跑起来、再验证、后构建的顺序写适合有基础命令行经验、准备在三大桌面系统上部署它的开发者。一条命令拿到可用版本预编译包是最快的路径建议先走这条路源码构建放在后文。打开项目仓库的 Releases 页面按当前系统选择对应架构的产物平台产物形态获取方式Windows.exe安装程序双击按向导安装默认目录C:\Program Files\Tiny RDMmacOS.dmg磁盘镜像挂载后把应用拖入 ApplicationsLinux.deb/.rpm/.tar.gz包管理器安装或解压即用⚠️ Linux 上如果下载的是通用二进制包直接解压后运行主程序即可启动依赖 WebKit 运行库缺失的情况见后文 QA。三平台差异一览把三个平台并排看差异主要集中在安装产物和运行时依赖上对比项WindowsmacOSLinux安装命令向导安装或winget类工具拖拽到 Applicationssudo dpkg -i xxx.deb/sudo rpm -ivh xxx.rpm运行时依赖WebView2 RuntimeWin11 自带Win10 需单独装无特殊依赖libwebkit2gtk-4.0及 GTK3 环境安装后验证开始菜单启动应用程序文件夹启动桌面快捷方式或终端启动常见坑WebView2 未安装导致白屏隔离属性导致无法验证开发者WebKit 动态库缺失启动即退出最低资源4GB 内存、50MB 磁盘4GB 内存、50MB 磁盘4GB 内存、50MB 磁盘三个平台的最小配置要求一致都是 4GB 内存加 50MB 磁盘空间架构上支持 x64Windows 另有 arm64 包。启动确认与最小可用配置装完后先做两步确认界面能起来再用一条真实连接确认链路是通的。启动确认双击启动后应看到主界面左侧是连接管理面板中间是 Key 浏览器右侧是数据操作区。界面同时支持明暗两套主题。新建连接点击添加连接填入 Redis 的地址、端口和密码。保存时客户端会发送PING返回PONG即连接成功。我一般先确认这一步通过再去做任何 Key 操作。发一条测试命令打开命令行模式CLI执行下面两条能看到回显即说明读写链路完整SET tiny_rdm_test ok GET tiny_rdm_test如果连接失败先别怀疑软件用redis-cli -h ip -p 6379 PING从命令行验证一下网络与端口能区分是防火墙问题还是配置问题。源码构建环境、命令、产物需要定制或参与开发时才需要走源码构建。环境要求如下组件版本要求说明Go1.25go.mod 中声明的版本Node.js20前端使用 Vue3 Vite见 frontend/README.mdNPM9随 Node 一起安装Wails CLI最新用 go install 安装无需额外配置关键命令按顺序执行即可前两步是为了把 Wails CLI 和前端依赖装好第三步直接编译运行# 安装 Wails 命令行工具 go install github.com/wailsapp/wails/v2/cmd/wailslatest # 拉取源码并安装前端依赖 git clone https://gitcode.com/GitHub_Trending/ti/tiny-rdm --depth1 cd tiny-rdm npm install --prefix ./frontend# 开发模式带前端热重载 wails dev # 生产构建 wails build -clean -production构建完成后产物位于build/bin/目录Windows 是.exemacOS 是.appLinux 是可执行文件。需要带调试信息加-debug需要自定义输出目录用-o一般默认即可。遇到问题时6 个高频问题以下按现象 → 原因 → 解决组织命令可直接复制。1. macOS 提示无法打开因为无法验证开发者原因应用带有隔离quarantine属性未做公证签名时 Gatekeeper 会拦截。 解决执行下面命令后重新打开应用。sudo xattr -d com.apple.quarantine /Applications/Tiny\ RDM.app2. Linux 启动后立即退出终端报libwebkit2gtk相关错误原因缺少 WebKit 动态库。 解决Debian/Ubuntu 执行sudo apt install libwebkit2gtk-4.0-37Fedora 执行sudo dnf install webkit2gtk4.0装完再启动。3. Windows 安装后打开是空白窗口原因WebView2 Runtime 未安装Win10 较老版本不预装。 解决从微软官网安装 Microsoft Edge WebView2 运行库无需重装 Tiny RDM。4.npm install报Unsupported engine或依赖安装失败原因Node 版本低于 20。 解决升级 Node 到 20用node -v确认后再装依赖。5. 终端提示wails: command not found原因Go 的安装目录go env GOPATH下的bin不在 PATH 里。 解决把该目录加入 PATH或直接用~/go/bin/wails dev的绝对路径执行。6. Web 版部署后访问 8086 端口打不开原因端口映射或登录凭据环境变量未生效。 解决确认容器处于运行状态docker compose ps再用ADMIN_USERNAME/ADMIN_PASSWORD对应的账号登录http://localhost:8086详见下一节配置示例。进阶能力自定义解码器与 Web 版部署自定义解码器。Tiny RDM 内置 Base64、Gzip、Zstd、MsgPack、YAML 等二十多种转换实现见 backend/utils/convert/对 List、Hash、Set、ZSet 的 value 可以逐条解码。当内置类型不够用时可以按步骤组合自定义规则一条先 Base64 解码、再 Gzip 解压的规则大致如下{ name: base64gzip, steps: [ { type: base64, action: decode }, { type: gzip, action: decompress } ] }保存后在查看 value 的解码入口选择该规则即可生效。Web 版 Docker 部署。桌面端之外Tiny RDM 提供可经 Docker 部署的 Web 版适合团队共享一台 Redis 管理入口。仓库内已附带 docker-compose.yml最小可用的自定义配置如下services: tinyrdm: image: ghcr.io/tiny-craft/tiny-rdm:latest container_name: tinyrdm restart: unless-stopped ports: - 8086:8086 environment: - ADMIN_USERNAMEadmin - ADMIN_PASSWORD你的密码 volumes: - ./data:/app/tinyrdmdocker compose up -d后浏览器访问http://localhost:8086登录。容器内部由 Nginx 托管前端并反向代理 Go 后端见 docker/entrypoint.sh./data卷用于持久化连接配置升级镜像时不丢失。下一步可以做什么把常用连接导出为配置文件换机器时直接导入省去逐条重填开启实时命令监控Monitor观察线上命令分布配合慢日志列表定位慢查询用 SCAN 分段加载默认批量 3000见 backend/consts/default_config.go处理百万级 Key 的库想提交代码或翻译先读 .github/CONTRIBUTING.md中文版见 .github/CONTRIBUTING_zh.md。【免费下载链接】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），仅供参考