常见问题

整理了用户最常提出的问题,希望能帮您快速找到答案。若以下内容未能解决您的问题,请前往 GitHub Issues 反馈。

安装与启动

ARDM 是免费的吗?有功能限制吗?

ARDM 完全免费开源,基于 MIT 协议开放全部源代码。所有功能对全部用户无任何限制——没有付费版、没有功能阉割、没有广告植入、没有使用次数限制。您可以自由将其用于个人项目、商业产品、教育教学等任意场景,无需任何授权或付费。

项目依赖 GitHub Stars、社区贡献与企业赞助维持运营。如果您觉得 ARDM 对您有帮助,欢迎在 GitHub 上点一个 Star,或将产品推荐给身边的开发者,这就是对我们最大的支持。

macOS 提示「无法验证开发者」或「来自身份不明的开发者」怎么办?

这是 macOS Gatekeeper 的安全机制,所有非 App Store 分发的应用首次启动都会触发。ARDM 的安装包已通过 Apple 公证(Notarization),您可以放心使用。解决方法如下:

1. 在 Finder 中找到 ARDM 应用,右键点击选择「打开」。
2. 弹出的安全提示框中点击「打开」按钮即可。
3. 若仍未弹出选项,请前往「系统设置 → 隐私与安全性」,在底部找到「已阻止使用 ARDM」的提示,点击「仍要打开」。

此操作只需执行一次,之后即可正常双击启动。

Windows 被 SmartScreen 拦截怎么办?

Windows SmartScreen 对未在 Microsoft Store 上架或未达到一定下载量的应用会显示警告。ARDM 的安装包已进行代码签名,您可以放心使用。当看到 SmartScreen 提示时:

1. 点击「更多信息」链接。
2. 点击「仍要运行」按钮即可继续安装。

若您仍然不放心,可以前往 GitHub Releases 页面核对安装包的 SHA256 校验值,确保下载文件完整无损。

Linux 的 .AppImage 无法运行怎么办?

.AppImage 是 Linux 上的便携式应用格式,无需安装即可运行。首次使用前需要赋予执行权限:

chmod +x ARDM-1.6.5-x86_64.AppImage
./ARDM-1.6.5-x86_64.AppImage

若运行时报错缺少 FUSE 依赖,请先安装 libfuse2:Ubuntu/Debian 执行 sudo apt install libfuse2;Fedora 执行 sudo dnf install fuse-libs;Arch 执行 sudo pacman -S fuse2

若 .AppImage 仍无法满足需求,也可以下载 .deb 包(Ubuntu/Debian)使用 sudo dpkg -i 安装,或通过 Snap Store 安装 sudo snap install another-redis-desktop-manager

如何升级到新版本?旧配置会丢失吗?

ARDM 启动后会自动检测新版本并在右下角弹出更新提示,点击「立即更新」即可自动下载并安装新版本。您也可以手动前往下载中心下载最新安装包覆盖安装。

所有连接配置、偏好设置均存储在用户目录下的独立配置文件中(位置见文档),覆盖安装不会影响配置数据。建议在升级前使用「导出连接」功能备份一份配置,以防意外。

连接与使用

连接 Redis 时提示「AUTH failed」或「NOAUTH」怎么办?

这通常是因为密码错误或 Redis 启用了 ACL 用户管理。请按以下步骤排查:

1. 确认密码输入正确,注意密码前后不要有空格。
2. 若 Redis 6+ 启用了 ACL,请在 ARDM 的「用户名」字段填写对应的 ACL 用户名(默认用户为 default)。
3. 检查 Redis 配置 requirepass 或 ACL 规则,确保您的账号有相应权限。
4. 若使用云数据库(如阿里云),请确认使用了云控制台提供的「账号」与「密码」,而非实例 ID。

如何通过 SSH 隧道访问内网 Redis?

新建连接时,展开「高级」选项,勾选「使用 SSH 隧道」,然后填写 SSH 相关配置:

1. SSH Host:跳板机公网 IP 或域名
2. SSH Port:通常为 22
3. SSH User:跳板机登录用户名
4. 认证方式:密码或私钥(推荐使用私钥,更安全)
5. 私钥文件:选择本地 ~/.ssh/id_rsaid_ed25519

填写完成后,ARDM 会先建立 SSH 隧道,再通过隧道连接 Redis。请确保跳板机已配置免密登录或正确提供密码。

支持 Redis Cluster 集群连接吗?

完全支持。新建连接时,将「连接类型」选择为「Cluster」,然后填写集群中任意一个节点的地址即可。ARDM 会自动通过 CLUSTER NODES 命令发现全部节点,并构建完整的集群拓扑视图,包括主节点、从节点、Slot 分布等。

查看键时,ARDM 会自动通过 CLUSTER KEYSLOT 计算键所在的 Slot,并路由命令到对应节点执行,无需手动切换节点。对于跨 Slot 的批量操作,ARDM 会自动按 Slot 分组执行并合并结果。

连接云数据库 Redis 版(阿里云/腾讯云/AWS)需要注意什么?

主流云厂商的托管 Redis 通常要求 SSL 加密连接。请按以下步骤配置:

1. 在云控制台开启 SSL/TLS 加密访问(部分云默认开启)。
2. 下载云厂商提供的 CA 证书文件(.pem 或 .crt 格式)。
3. 在 ARDM 新建连接对话框中展开「高级」,勾选「使用 SSL/TLS」。
4. 选择「单向认证」,上传 CA 证书文件。
5. 若云厂商要求双向认证,还需上传客户端证书与私钥。

云数据库的连接地址通常为域名而非 IP,端口也可能不是默认的 6379,请以云控制台显示的「连接地址」与「端口号」为准。

键列表加载很慢,怎么办?

当单个数据库中键数量超过百万级时,列表加载可能变慢。这是因为 Redis 的 KEYS 命令会阻塞服务,ARDM 默认使用 SCAN 命令增量扫描,但仍可能较慢。建议优化方案:

1. 使用搜索框的模糊匹配功能,只查看特定模式的键(如 user:*),避免全量加载。
2. 在设置中将「每页加载键数」调整为较小的值(如 100)。
3. 为高频访问的键设置合理的命名空间前缀,便于通过模式过滤。
4. 若必须查看全部键,建议在低峰期操作,避免影响生产服务。

如何查看与修改键的 TTL(过期时间)?

键列表中每个键右侧都会显示当前的 TTL(如「3600s」「1h 0m」「永不过期」)。要修改 TTL,右键点击该键,选择「设置 TTL」,在弹出的对话框中输入新的过期时间,支持秒、分钟、小时、天等单位的自然语言输入。

对于批量设置,勾选多个键后使用工具栏的「批量设置 TTL」按钮。要移除键的过期时间使其永久有效,右键选择「Persist」或按 Ctrl + Shift + R

功能与高级用法

支持 Lua 脚本调试吗?

支持。ARDM 内置了完整的 Lua 脚本编辑器,提供语法高亮、自动缩进、括号匹配等专业 IDE 级别的编辑体验。在主界面顶部点击「Lua 脚本」按钮即可打开编辑器。

编辑器支持配置 KEYS 与 ARGV 参数模拟真实调用场景,点击「执行」即可运行脚本并在结果面板查看返回值。若脚本存在语法错误,错误信息会精确定位到行号;若执行过程中抛出异常,完整的错误堆栈会显示在结果面板中。历史脚本会本地保存,便于复用。

如何查看 Redis 慢查询日志?

ARDM 提供了慢查询日志面板,可视化展示 SLOWLOG 内容。在主界面顶部点击「慢查询」按钮,即可查看最近的慢查询记录,包括命令、执行时长、客户端信息、执行时间等。您可以按执行时长排序,快速定位性能瓶颈。

注意:慢查询日志需要 Redis 服务端配置 slowlog-log-slower-than 参数(默认 10ms)。若日志为空,请检查 Redis 配置是否开启了慢查询记录。

支持数据导入导出吗?支持哪些格式?

支持。右键点击数据库或选中的键,选择「导出」,即可将数据导出为 JSON、CSV 等格式。导出范围支持单个键、多个键、按模式匹配的键或整个数据库。导出的 JSON 文件保留了键的类型信息,便于在其他工具中还原。

导入数据时,选择「导入」功能,支持 JSON 格式(ARDM 自有格式或通用格式)。导入过程会自动识别键类型并执行对应的写入命令,对于已存在的键会询问是覆盖还是跳过。

界面字体太小,可以调整吗?

可以。前往「设置 → 显示」,可以调整界面缩放比例(80% ~ 150%)。也可以使用快捷键 Ctrl + = 放大、Ctrl + - 缩小、Ctrl + 0 重置。设置会自动保存,下次启动时保持。

对于 4K 高分屏用户,ARDM 会自动检测屏幕分辨率并设置合适的缩放比例。若自动检测不准确,可在设置中手动指定。

支持哪些语言界面?

ARDM 目前支持简体中文、繁体中文、英语三种完整界面语言,并正在社区贡献下持续增加日文、韩文等。前往「设置 → 通用 → 语言」即可切换,切换后立即生效无需重启。界面语言与系统语言独立,您可以在中文系统上使用英文界面,反之亦然。

如果您愿意贡献新的语言翻译,请通过 hello@goanother.cn 与我们联系,或直接在 GitHub 提交翻译文件 Pull Request。

安全与隐私

我的连接密码会上传到服务器吗?

不会。ARDM 是一款纯本地桌面应用,所有连接配置、密码、私钥等敏感信息均存储在您本地的用户目录下,并经过加密处理。ARDM 不会将任何配置数据上传到任何服务器,也不会收集任何用户隐私信息。

应用唯一的网络请求是:检查新版本更新(仅查询版本号,不传输任何用户数据)以及您主动发起的 Redis 连接。您可以在设置中关闭自动更新检查,完全离线使用。

开源代码安全吗?如何审计?

ARDM 的全部源代码基于 MIT 协议在 GitHub 公开,任何人均可审查、审计、复现。项目已收到全球安全研究员的多次审计,未发现任何后门或恶意代码。

每次发布的安装包都会附带 SHA256 校验值,您可以在下载后自行校验文件完整性。如果您在审计过程中发现任何安全问题,请通过 hello@goanother.cn 私密反馈,我们会在第一时间响应。

误删了生产数据怎么办?

Redis 是内存数据库,删除操作即时生效,无法像关系型数据库那样通过事务回滚。若误删生产数据,可尝试以下恢复手段:

1. 若 Redis 配置了 AOF 持久化,可从 AOF 文件中恢复(需停止 Redis 服务,编辑 AOF 文件移除删除命令后重启)。
2. 若开启了 RDB 快照,可从最近的 dump.rdb 文件恢复。
3. 若部署在云数据库,部分云厂商提供「数据恢复」功能,可回滚到指定时间点。

预防措施:建议在生产环境为 ARDM 配置只读账号(通过 ACL 限制 DEL、FLUSHDB 等危险命令),并在执行批量删除前先用「导出」功能备份数据。ARDM 也提供了「危险操作二次确认」功能,建议保持开启。

💬 没找到您的问题?

若以上内容未能解决您的问题,欢迎通过以下渠道获取帮助:在 GitHub Issues 提交问题(推荐,响应最快);发送邮件至 hello@goanother.cn;或查阅完整的使用文档。我们的社区非常活跃,通常 24 小时内即可获得回复。