Another Redis Desktop Manager (ARDM) 入门指南：告别命令行，拥抱可视化管理
Redis，作为一款高性能的键值存储系统，因其闪电般的速度、丰富的数据结构以及灵活的应用场景，已成为现代应用程序开发中不可或缺的一部分。然而，对于许多初学者甚至经验丰富的开发者来说，通过命令行界面（CLI）与 Redis 进行交互有时可能显得繁琐和不够直观，尤其是在需要浏览大量数据、查看复杂结构（如 Hash、Sorted Set、Stream）或执行一些不太常见的操作时。
这时，一款优秀的图形用户界面（GUI）工具就显得尤为重要。它能将抽象的命令行操作转化为可视化的界面，让用户能够更轻松地连接、管理、浏览和操作 Redis 数据库。在众多 Redis GUI 工具中，Another Redis Desktop Manager (ARDM) 凭借其简洁美观的界面、丰富的功能、跨平台支持以及开源免费的特性，赢得了广泛的认可和喜爱。
本篇文章旨在为 Redis 和 ARDM 的新手提供一份详尽的入门指南，带你从零开始认识并掌握这款强大的可视化工具，彻底告别枯燥的命令行，高效地管理你的 Redis 数据。
什么是 Another Redis Desktop Manager (ARDM)?
简单来说，Another Redis Desktop Manager 是一个开源的、跨平台的 Redis GUI 客户端。它支持 Windows、macOS 和 Linux 操作系统，提供了一个直观友好的界面，让你能够：
- 轻松连接到本地或远程的 Redis 服务器。
- 浏览数据库中的所有 Key，支持强大的搜索和过滤功能。
- 以可视化的方式查看不同数据结构（String, List, Set, Sorted Set, Hash, Stream）的内容。
- 方便地进行数据的增删改查操作（添加、编辑、删除 Key 和其中的元素）。
- 管理 Key 的过期时间 (TTL)。
- 执行 Redis 命令的终端功能。
- 支持 Sentinel 和 Cluster 模式的连接。
- 导入和导出数据。
ARDM 的目标是提供一个比命令行更易用、更高效的 Redis 管理体验。
为什么选择 ARDM?
- 可视化操作： 最直接的好处，让复杂的数据结构一目了然，操作更直观。
- 跨平台： 不论你使用哪种主流操作系统，都能找到对应的版本。
- 开源免费： 降低使用门槛，代码公开透明，社区活跃。
- 功能丰富： 覆盖了日常 Redis 管理的绝大部分需求。
- 用户体验良好： 界面设计简洁，响应速度快。
如果你是 Redis 的新手，或者经常需要与 Redis 数据打交道，ARDM 绝对是提升效率的利器。
入门准备
在开始安装和使用 ARDM 之前，你需要确保：
- 有一个运行中的 Redis 服务器： 它可以是本地安装的 Redis 实例，也可以是远程服务器上的 Redis 服务，或者云服务商提供的 Redis 托管服务。你需要知道 Redis 服务器的 IP 地址（或主机名）和端口号，如果设置了密码，还需要知道密码。
- 你的电脑可以访问到 Redis 服务器： 如果 Redis 服务器在远程，需要确保网络是连通的，并且防火墙规则允许你的电脑连接到 Redis 服务器的端口（默认为 6379）。
准备好这些后，我们就可以开始安装 ARDM 了。
ARDM 的安装
ARDM 支持多种安装方式，你可以根据自己的操作系统和偏好选择最方便的一种。
Windows
- 下载安装包： 访问 ARDM 的官方 GitHub Release 页面 (https://github.com/qishibo/AnotherRedisDesktopManager/releases)。
- 找到最新版本的 Release，在 Assets 部分下载
Another-Redis-Desktop-Manager-x.x.x.exe(其中x.x.x是版本号) 或Another-Redis-Desktop-Manager-x.x.x-win.exe文件。 - 运行安装程序： 双击下载的
.exe文件，按照安装向导的提示完成安装。选择安装路径，通常保持默认即可。 - 安装完成后，你可以在开始菜单或桌面上找到 ARDM 的快捷方式。
macOS
- 下载
.dmg文件： 同样访问 ARDM 的 GitHub Release 页面 (https://github.com/qishibo/AnotherRedisDesktopManager/releases)。 - 找到最新版本的 Release，在 Assets 部分下载
Another-Redis-Desktop-Manager-x.x.x.dmg文件。 - 安装： 双击下载的
.dmg文件，会打开一个安装窗口。将窗口中的 ARDM 图标拖拽到 “Applications” 文件夹中。 - 现在你可以在 “Applications” 文件夹中找到 ARDM 并启动它。启动时可能会提示权限问题，按照提示在 “System Preferences” -> “Security & Privacy” -> “General” 中允许来自未知开发者的应用运行即可（如果你的设置阻止了）。
Linux
Linux 的安装方式比较多样：
- AppImage (推荐，适用于大多数发行版):
- 访问 GitHub Release 页面 (https://github.com/qishibo/AnotherRedisDesktopManager/releases)。
- 下载
Another-Redis-Desktop-Manager-x.x.x.AppImage文件。 - 给文件执行权限：打开终端，进入下载文件所在的目录，执行命令
chmod +x Another-Redis-Desktop-Manager-x.x.x.AppImage。 - 运行 AppImage 文件：双击文件或在终端执行
./Another-Redis-Desktop-Manager-x.x.x.AppImage。
- DEB (适用于 Debian/Ubuntu):
- 下载
Another-Redis-Desktop-Manager_x.x.x_amd64.deb文件。 - 使用包管理器安装：打开终端，进入下载文件所在的目录，执行
sudo dpkg -i Another-Redis-Desktop-Manager_x.x.x_amd64.deb。如果遇到依赖问题，可以运行sudo apt --fix-broken install解决。
- 下载
- RPM (适用于 Fedora/CentOS/RHEL):
- 下载
another-redis-desktop-manager-x.x.x-1.x86_64.rpm文件。 - 使用包管理器安装：打开终端，进入下载文件所在的目录，执行
sudo rpm -ivh another-redis-desktop-manager-x.x.x-1.x86_64.rpm。
- 下载
- Snapcraft (如果你的系统支持 Snap):
- 打开终端，执行
sudo snap install another-redis-desktop-manager。
- 打开终端，执行
选择其中一种适合你的方式进行安装即可。
第一次连接 Redis
安装完成后，启动 ARDM。你会看到一个简洁的界面，可能是一个空白的连接列表或者一个默认的本地连接项。
添加新的连接
- 在界面的左上角，通常会有一个 “New Connection” 或 “+” 按钮。点击它。
- 会弹出一个 “New Connection” 或 “Edit Connection” 的配置窗口。
- 填写连接信息：
- Name (名称): 给这个连接起一个名字，方便识别，比如 “本地开发Redis” 或 “生产环境Redis”。
- Host (主机): 填写 Redis 服务器的 IP 地址或主机名。如果连接本地 Redis，通常是
127.0.0.1或localhost。 - Port (端口): 填写 Redis 服务器的端口号，默认为
6379。 - Auth (密码): 如果你的 Redis 服务器设置了密码（推荐！），在这里填写密码。如果没有设置密码，留空即可。
- Connection Type (连接类型): 通常情况下，选择 “Standard” (标准连接)。如果你连接的是 Redis Sentinel 或 Redis Cluster，则需要选择对应的类型，并填写相关的主机/端口信息（对于 Sentinel，填写 Sentinel 的地址；对于 Cluster，填写 Cluster 中任一节点的地址）。作为入门，我们主要关注 Standard 类型。
- SSH Tunnel (SSH隧道): 如果你的 Redis 服务器无法直接访问，但可以通过 SSH 连接到另一台服务器，再从那台服务器连接 Redis，你可以勾选这个选项并填写 SSH 连接信息。这通常用于连接内网或受限访问的 Redis 实例。入门阶段通常用不到。
- Test Connection (测试连接): 强烈建议在保存前点击 “Test Connection” 按钮，确认连接信息是否正确并且能够成功连接到服务器。如果测试失败，请检查 IP、端口、密码以及服务器防火墙设置。
- Save (保存): 如果测试连接成功，点击 “Save” 按钮保存连接配置。
连接到 Redis
保存后，新的连接项会出现在左侧的连接列表中。双击或选中该连接项，然后点击连接按钮（通常是一个插头或播放图标），ARDM 就会尝试连接到你的 Redis 服务器。
连接成功后，界面会发生变化，左侧会显示 Redis 服务器上的数据库列表（默认为 db0 到 db15，具体数量取决于你的 Redis 配置）。
用户界面概览
连接成功后，ARDM 的主界面通常分为几个主要区域：
- 左侧面板 (Connection & Database List):
- 顶部是连接列表，列出你配置的所有 Redis 连接。
- 连接展开后，下方是该 Redis 实例上的数据库列表 (db0, db1, …)。Redis 默认有 16个数据库，通过数字区分。你可以点击不同的数据库来切换。
- 选中一个数据库后，下方会显示该数据库中的 Key 列表。
- 中间面板 (Key List):
- 显示当前选中数据库中的所有 Key。
- 顶部有搜索/过滤框，用于查找 Key。
- 显示 Key 的名称、类型 (String, List, Set, etc.) 和过期时间 (TTL)。
- 支持 Key 的排序和分页加载。
- 右侧面板 (Key Detail & Operations):
- 当你从 Key 列表中选中一个 Key 时，这个区域会显示该 Key 的详细信息。
- 根据 Key 的不同数据类型，右侧面板会以不同的方式展示其内容，并提供相应的操作按钮（编辑、删除元素、添加字段等）。
- 顶部通常有该 Key 的名称、类型、TTL 信息，以及编辑、删除 Key 的按钮。
- 底部面板 (Console/Terminal):
- 一个可选的面板，通常通过点击某个按钮（如 “Console” 或终端图标）打开。
- 你可以在这里直接输入 Redis 命令并执行，查看命令的输出结果。这对于执行一些 GUI 不支持或更方便通过命令完成的操作非常有用。
理解了这些区域的功能，你就可以开始进行具体的 Redis 数据管理操作了。
基本操作指南
接下来，我们将详细介绍如何在 ARDM 中进行各种常见的 Redis 操作。
1. 浏览 Key
连接并选择数据库后，中间面板会加载该数据库中的 Key 列表。
- 全量加载： 如果 Key 数量不多，ARDM 会一次性加载所有 Key。
- 分页加载： 如果 Key 数量很大，ARDM 会分页加载，你可以通过滚动或点击加载更多按钮来查看所有 Key。
- 刷新： 点击刷新按钮（通常是循环箭头的图标）可以重新加载 Key 列表，获取最新的数据状态。
- 按类型过滤： 在 Key 列表上方或侧边，通常有按 Key 类型过滤的选项（String, List, Hash, etc.）。你可以选中某个类型，只显示该类型的 Key。
- 按 Key 名称搜索/过滤： 在搜索框中输入 Key 名称的一部分或使用模式匹配符 (
*表示任意字符，?表示单个字符)，ARDM 会实时过滤显示符合条件的 Key。例如，输入user:*可以查找所有以user:开头的 Key。
2. 查看 Key 详情
在中间面板的 Key 列表中，点击任何一个 Key 的名称，右侧面板就会显示该 Key 的详细信息。ARDM 会根据 Key 的类型以最合适的方式呈现数据。
- String (字符串): 直接显示字符串的值。如果值是 JSON、XML 等格式，ARDM 可能提供格式化选项。你可以双击值或点击编辑按钮进行修改。
- List (列表): 以列表形式显示所有元素，通常按插入顺序（从头到尾）。可以查看每个元素的索引。右侧面板会显示列表的长度。你可以添加新元素、删除选定元素或修改特定索引的元素。
- Set (集合): 以列表形式显示所有成员。集合是无序且唯一的，所以显示顺序可能不固定。右侧面板显示集合的成员数量。你可以添加新成员或删除选定成员。
- Sorted Set (有序集合): 以列表形式显示所有成员及其对应的分数 (Score)。通常按分数排序。右侧面板显示有序集合的成员数量。你可以添加新的成员-分数对，删除选定成员，或修改成员的分数。
- Hash (哈希): 以键值对（字段-值）的形式显示所有数据。右侧面板显示哈希的字段数量。你可以添加新的字段-值对，删除选定字段，或修改特定字段的值。
- Stream (流): 以列表形式显示流中的消息条目 (Entry)。每个条目都有一个唯一的 ID 和一组字段-值对。右侧面板显示流的长度。你可以查看条目内容，但通常不能直接修改或删除单个条目（需要使用特定的 Stream 命令）。ARDM 可能会提供添加新条目的界面。
在查看 Key 详情时，你可以很方便地复制 Key 名称、值或其中的元素。
3. 添加新的 Key
- 在中间面板的 Key 列表上方或侧边，找到并点击 “Add New Key” 或 “+” 按钮。
- 会弹出一个窗口或在右侧面板出现一个表单，让你填写新 Key 的信息。
- 选择 Key Type (类型): 选择你要创建的 Key 的数据类型 (String, List, Set, Hash, Sorted Set, Stream)。
- Key Name (键名): 输入新 Key 的名称。Key 名称是唯一的。
- Value/Initial Content (值/初始内容): 根据选择的类型，填写对应的值或初始内容：
- String: 直接输入字符串值。
- List/Set/Sorted Set: 可以输入一个或多个初始成员，通常每行一个，Sorted Set 还需要指定分数。
- Hash: 输入初始的字段-值对。
- Stream: 通常不需要初始内容，创建 Key 后再添加条目。
- TTL (Time To Live – 过期时间): 可选。如果你希望 Key 在一段时间后自动删除，可以在这里设置过期时间，单位通常是秒。输入
-1表示永不过期。 - Save (保存): 填写完毕后，点击保存按钮。如果 Key 名称已存在，通常会有提示。
4. 编辑现有 Key
选中 Key 后，右侧面板会显示 Key 的详情和编辑选项。
- 编辑 Key 名称或 TTL: 通常在右侧面板顶部，有 Key 名称和 TTL 的显示区域，点击编辑图标或双击可以直接修改。修改后记得保存。
- 编辑 String 值: 直接在值显示区域修改文本，然后点击保存按钮。
- 编辑复合类型 (List, Set, ZSet, Hash) 的元素/字段: 右侧面板会列出 Key 的内容。
- 添加元素/字段: 找到添加按钮（通常是 “+”)，会弹出新窗口或在列表中添加一行让你输入新的元素/字段及值。
- 编辑元素/字段: 双击列表中的某个元素/字段的值，或者点击编辑图标，修改后保存该项或整个 Key。
- 删除元素/字段: 选中列表中的一个或多个元素/字段，点击删除按钮（通常是垃圾桶图标）。
- Stream: 查看 Stream 的条目内容。通常不能直接编辑条目，但可以方便地查看每个条目的 ID、时间和字段值。
5. 删除 Key
在中间面板的 Key 列表中，选中一个或多个要删除的 Key。然后点击删除按钮（通常是垃圾桶图标），ARDM 会弹出一个确认对话框，确认后即可删除选中的 Key。
你也可以在查看 Key 详情时，点击右侧面板顶部的删除按钮来删除当前 Key。
6. 管理 TTL (过期时间)
TTL 是 Redis 中一个非常实用的特性，可以为 Key 设置一个生存时间，时间到达后 Key 会自动删除。
- 查看 TTL: 在中间 Key 列表或右侧 Key 详情面板，都可以看到 Key 的 TTL。通常显示剩余的秒数。如果显示
-1表示永不过期，显示-2表示 Key 已过期或不存在。 - 设置/修改 TTL: 在添加或编辑 Key 时，可以设置或修改 TTL。在 Key 详情面板顶部，点击 TTL 值旁边的编辑图标，输入新的过期时间（秒）。
- 移除 TTL: 如果一个 Key 设置了 TTL，你可以在编辑 TTL 的地方将其值设置为
-1，或者通常 ARDM 会提供一个 “Persist” (持久化) 或 “Remove TTL” 的选项，点击即可移除 Key 的过期时间，使其变为永不过期。
7. 使用 Console (终端)
虽然 ARDM 提供了丰富的可视化操作，但有时直接执行 Redis 命令会更高效或能完成 GUI 不支持的操作。ARDM 内置了一个终端功能。
- 找到并点击 “Console” 或终端图标按钮，通常在底部或顶部菜单栏。
- 底部会弹出一个终端面板。
- 在终端输入框中输入标准的 Redis 命令，例如：
GET mykey(获取 String 类型 Key 的值)HGETALL myhash(获取 Hash 类型 Key 的所有字段和值)LLEN mylist(获取 List 类型的长度)KEYS *(获取所有 Key – 注意：在生产环境 KEYS * 可能会阻塞 Redis，请谨慎使用！ 通常推荐使用SCAN命令)INFO(获取 Redis 服务器信息)PING(检查连接是否正常)SELECT 1(切换到数据库 1)
- 按回车键执行命令。命令的输出会显示在终端面板中。
Console 功能让你在需要时能够随时切换到命令行模式，提供了极大的灵活性。
8. 导入和导出数据
ARDM 通常支持将 Redis 数据导出到文件，或从文件导入数据。这对于数据迁移、备份或在不同环境间同步数据非常有用。
- 导出：
- 选中你想要导出数据的数据库（或保持在连接级别导出所有数据库）。
- 在菜单栏找到 “Connection” 或 “Database”，然后选择 “Export Data” 或类似的选项。
- 选择导出格式（常见的有 RDB 快照文件或 JSON 格式）和保存路径。
- 点击导出。
- 导入：
- 选中你想要导入数据的目标数据库。
- 在菜单栏找到 “Connection” 或 “Database”，然后选择 “Import Data” 或类似的选项。
- 选择要导入的文件（RDB 或 JSON）。
- 确认导入选项（例如，是否清空目标数据库，是否覆盖现有 Key 等）。
- 点击导入。
注意： 导入/导出操作可能会耗时，并且如果处理不当可能导致数据丢失或覆盖，操作前请务必谨慎并最好进行备份。
实用技巧和高级功能 (入门进阶)
当你熟悉了基本操作后，可以探索 ARDM 的一些实用技巧和更进一步的功能：
- 连接管理： 在 “Connection” -> “Manage Connections” 中，你可以编辑、复制、删除、导入或导出连接配置，方便你在不同电脑或团队成员间共享连接设置。
- 界面偏好设置： 在 “Edit” -> “Preferences” 或 “Settings” 菜单中，你可以调整 ARDM 的外观（主题、字体大小）、语言、Key 列表的显示方式（树状结构 vs 列表），以及其他行为设置（如自动刷新间隔）。
- Key 显示方式： 对于某些复合类型（如 Hash），ARDM 可能提供不同的视图模式，例如表格视图，让数据更易读。
- SSH Tunnel 配置： 如果你的 Redis 在防火墙后，但可以通过一个跳板机访问，利用 SSH Tunnel 功能可以在 ARDM 中直接配置，无需额外的 SSH 客户端转发。
- 使用 SCAN 代替 KEYS： ARDM 在内部搜索 Key 时，如果 Key 数量多，通常会智能地使用
SCAN命令而不是KEYS *，以避免阻塞服务器。但在 Console 中执行命令时，你需要自己注意选择高效的命令。 - 数据格式化： 对于存储 JSON 或序列化数据的 String 类型 Key，ARDM 可能提供自动检测并格式化显示的功能。
常见问题及故障排除
- 无法连接到 Redis：
- 检查 Redis 服务器是否正在运行。
- 检查填写的 IP 地址和端口号是否正确。
- 检查填写的密码是否正确（区分大小写）。
- 检查服务器的防火墙设置，确保允许来自你电脑 IP 的连接到 Redis 端口。
- 如果是远程连接，检查网络是否通畅。
- 如果使用了 SSH Tunnel，检查 SSH 连接信息是否正确。
- 连接成功但看不到 Key：
- 确保你连接的是正确的数据库（db0, db1, etc.）。
- 确保数据库中确实有 Key。
- 尝试刷新 Key 列表。
- 检查搜索/过滤条件是否清空。
- 数据类型显示错误：
- Redis 的 Key 类型是固定的。如果你通过 GUI 添加 Key 时选择了错误的类型，数据可能会混乱。删除错误的 Key，重新以正确的类型添加。
- 如果 Key 是通过其他方式（如程序代码）写入的，确保写入时使用了正确的 Redis 命令对应的数据结构。
总结
Another Redis Desktop Manager 是一款功能强大且易于使用的 Redis 可视化管理工具。通过本指南的学习，你应该已经掌握了 ARDM 的安装、连接配置、界面布局以及最常用的数据浏览和操作方法。
使用 ARDM，你可以极大地提高与 Redis 交互的效率，无论是日常开发中的数据查看和调试，还是进行数据库管理任务，它都能提供直观友好的体验。
尽管 ARDM 提供了丰富的功能，但它并不能替代对 Redis 本身概念和命令的理解。建议你在使用 GUI 工具的同时，也学习 Redis 的核心数据结构、命令和最佳实践，这将帮助你更好地利用 Redis 的强大能力。
现在，就开始使用 Another Redis Desktop Manager，愉快地管理你的 Redis 数据库吧！