Postgres Prefs 技术文档

1. 安装指南

1.1 下载与安装

1. 访问 GitHub Releases 页面，下载最新版本的 .dmg 文件。
2. 下载完成后，双击 .dmg 文件以打开它。
3. 在打开的窗口中，双击 PostgreSQL.prefPane 文件，或者将其拖动到系统偏好设置中进行安装。
4. 安装时，系统会询问您是否仅为当前用户安装，还是为所有用户安装。选择“当前用户”即可（两种选项均可）。

1.2 安装截图

2. 项目的使用说明

2.1 概述

Postgres Prefs 是一个 macOS 系统偏好设置面板，用于控制 PostgreSQL 数据库服务器。它具有以下功能：

• 兼容所有 PostgreSQL 安装，包括 Homebrew 和一键安装程序。
• 通过点击按钮即可启动和停止 PostgreSQL 服务器，无需使用复杂的命令。
• 设置 PostgreSQL 在计算机启动或用户登录时自动启动。
• 通过图形界面轻松更改 PostgreSQL 设置。
• 在同一窗口中控制多个 PostgreSQL 服务器。

2.2 主要界面

2.3 更改设置

2.4 日志查看

3. 项目API使用文档

3.1 启动与停止服务器

• 启动服务器：点击 Start PostgreSQL 按钮，服务器将开始运行。
• 停止服务器：点击 Stop PostgreSQL 按钮，服务器将停止运行。

3.2 自动启动设置

• 启动时自动启动：在设置界面中，勾选“启动时自动启动”选项，PostgreSQL 将在计算机启动时自动启动。
• 登录时自动启动：勾选“登录时自动启动”选项，PostgreSQL 将在用户登录时自动启动。

3.3 查看日志

• 查看日志：点击 View Log 按钮，系统将打开 macOS 的 Console 应用程序，显示服务器的默认日志。

4. 项目安装方式

4.1 通过 .dmg 文件安装

• 下载 .dmg 文件并双击打开，然后按照安装指南进行操作。

4.2 通过 Homebrew 安装

• 使用 Homebrew 安装 PostgreSQL 的命令如下：

  brew install postgresql@15
  

4.3 通过一键安装程序

• 访问 PostgreSQL 官方下载页面，下载并运行由 EDB 提供的一键安装程序。

5. 常见问题解答

5.1 这个工具能做什么，不能做什么？

• 能做：启动和停止 PostgreSQL 服务器，显示运行状态，并安排在启动/登录时自动启动。
• 不能做：安装 PostgreSQL，创建数据库集群，创建数据库或运行 SQL。

5.2 我可以在同一台机器上运行多个 PostgreSQL 实例吗？

• 可以。每个实例必须有自己的数据目录和端口。可以通过设置弹出窗口指定不同的端口，但需要运行 initdb 命令来创建新的数据库集群。

5.3 PostgreSQL 无法启动。

• 如果点击 Start PostgreSQL 后，服务器状态显示为 Retrying...，请点击 View Log 按钮查看日志，日志中会显示问题的具体原因。

5.4 我设置了启动时自动启动，但 PostgreSQL 仍然没有自动启动。

• 首先，确保可以通过手动点击 Start PostgreSQL 按钮启动服务器。如果手动启动正常，请在 GitHub 上提交问题，我们将进行调查。

5.5 这个工具会影响我现有的安装吗？

• 不会。Postgres Prefs 会创建自己的配置文件来启动/停止服务器，与现有安装分开。

6. 版本历史

版本	日期	备注
v2.7	28-Mar 2022	修复了检测 EnterpriseDB v13 或更高版本时的问题，改进了密码提示弹窗等。
v2.6	28-Feb 2020	支持无需密码启动/停止 PostgreSQL。
v2.5	12-Feb 2020	修复了 Catalina 上的启动/停止错误，支持暗黑模式等。
v2.4.3	20-Jan 2020	修复了 macOS Catalina 的 64 位构建问题。
v2.4.2	8-Feb 2016	修复了用户默认 shell 为 fish 时的错误，改进了服务器状态图标。
v2.4.1	10-Nov 2015	修复了因用户名无效而无法启动服务器的问题。
v2.4	30-Aug 2015	自动检测系统上所有运行的 PostgreSQL 进程，修复了停止 Postgresapp 服务器后留下“幽灵”进程的问题。
v2.3	28-Aug 2015	提高了速度和安全性，替换了外部 shell 脚本，支持所有用户的登录启动。
v2.2.1	22-Aug 2015	自动检测运行的 Postgresapp.com 服务器。
v2.2	9-Aug 2015	无需输入密码即可查看所有服务器的状态。
v2.1	30-Jul 2015	自动检测已运行的服务器，支持复制服务器功能。
v2.0	22-Jul 2015	支持从单个窗口控制多个服务器，支持计算机启动时自动启动。

7. 联系方式

• 作者：Macca Tech
• 网站：Macca Tech

8. 许可证

• 项目采用开源许可证，具体信息请参考项目仓库中的 LICENSE 文件。

9. 相关链接

• 项目仓库：GitHub
• PostgreSQL 官方网站：PostgreSQL