本指南提供在 macOS 设备上安装 HarborDB 的逐步说明。

安装方法

Mac App Store（推荐）

安装 HarborDB 最简单的方法是通过官方 Mac App Store：

在您的 macOS 设备上打开 Mac App Store
在搜索栏中搜索 "HarborDB"
**点击"获取"**或价格按钮（$19.99）购买并下载
等待安装 - 应用程序将自动下载并安装
从您的应用程序文件夹、启动台或 Spotlight 启动 HarborDB

Mac App Store 安装的好处：

自动更新
经过验证的安全分发
易于安装和移除
支持家庭共享

直接下载（替代方案）

对于企业部署或测试目的，您可以直接下载 HarborDB：

访问我们的下载页面 harbordb.com/download
下载最新的 .dmg 文件
双击打开 .dmg 文件
将 HarborDB 拖到您的应用程序文件夹
复制后弹出磁盘映像

安全说明：直接下载时，请确保使用提供的校验和验证下载的真实性。

系统要求

安装前，请验证您的系统满足以下要求：

最低要求

macOS：12.0 (Monterey) 或更高版本
处理器：Intel Core i5（第 8 代）或 Apple Silicon (M1)
内存：8 GB RAM
存储空间：200 MB 可用空间
显示器：1280 × 800 分辨率

PostgreSQL 服务器要求

PostgreSQL：9.6 或更高版本（推荐 12+）
网络：与 PostgreSQL 服务器的 TCP/IP 连接
权限：用户必须具有连接和查询权限

首次启动

安装后，首次启动 HarborDB：

在您的应用程序文件夹中找到 HarborDB或使用 Spotlight（⌘ + 空格，输入"HarborDB"）
双击启动 - 您可能需要授予应用程序运行权限（仅限首次）
查看系统权限：
- 辅助功能：键盘快捷键和 UI 增强所需（可选）
- 网络：数据库连接所需
- 钥匙串：安全密码存储所需

Gatekeeper 警告（直接下载）

如果您直接下载了 HarborDB，可能会看到安全警告：

"因为无法验证开发者，所以无法打开"HarborDB"。

要解决此问题：

转到 系统偏好设置 → 安全性与隐私
点击 HarborDB 警告旁边的 "打开"
确认您要打开应用程序

安装后步骤

1. 验证安装

检查 HarborDB 是否出现在您的应用程序文件夹中
验证应用程序启动时没有错误
检查关于菜单（HarborDB → 关于 HarborDB）获取版本信息

2. 检查更新

Mac App Store：更新是自动的，但您可以在 App Store 的更新选项卡中手动检查
直接下载：在 HarborDB → 检查更新中检查更新

3. 配置偏好设置（可选）

调整主题（浅色/深色/系统）
配置默认连接设置
设置键盘快捷键

安装问题故障排除

"应用程序已损坏"错误

如果看到"HarborDB.app 已损坏，无法打开"：

# 打开终端并运行：
sudo xattr -cr /Applications/HarborDB.app

权限不足

如果 HarborDB 无法访问所需资源：

转到 系统偏好设置 → 安全性与隐私 → 隐私
授予必要权限（辅助功能、文件和文件夹等）
重启 HarborDB

安装失败

如果安装失败或应用程序无法启动：

重启您的 Mac 并重试
检查磁盘空间 - 确保至少有 500 MB 空闲空间
验证 macOS 版本 - 检查关于本机 → macOS 版本
联系支持如果问题持续存在

卸载

要从系统中移除 HarborDB：

Mac App Store 版本

打开 访达 → 应用程序
将 HarborDB.app 拖到废纸篓
清空废纸篓

直接下载版本

从 /Applications 中移除应用程序

移除偏好设置（可选）：

rm -rf ~/Library/Preferences/com.harbordb.HarborDB.plist
rm -rf ~/Library/Application\ Support/HarborDB

移除钥匙串条目（可选）- 打开钥匙串访问并搜索"HarborDB"

下一步

现在 HarborDB 已安装：

创建您的第一个连接 - 连接到 PostgreSQL 数据库
探索界面 - 了解 HarborDB 的功能
尝试示例查询 - 练习 SQL

需要帮助？查看我们的 FAQ 或联系支持。

安装