PostgresApp 安装与配置完全指南

PostgresApp 安装与配置完全指南

PostgresApp PostgresApp是一个开源的PostgreSQL应用程序，用于在macOS上运行PostgreSQL数据库。 - 功能：PostgreSQL应用程序；macOS；PostgreSQL数据库。 - 特点：易于使用；轻量级；支持多种编程语言；高性能。 项目地址: https://gitcode.com/gh_mirrors/po/PostgresApp

PostgresApp 是一个专为 macOS 设计的 PostgreSQL 数据库管理工具，它让 PostgreSQL 的安装和管理变得异常简单。本文将详细介绍 PostgresApp 的安装、配置和使用方法，帮助开发者快速搭建本地 PostgreSQL 开发环境。

一、PostgresApp 安装步骤

安装 PostgresApp 非常简单，只需以下几个步骤：

1. 下载 PostgresApp 应用程序
2. 将其拖拽到 macOS 的"应用程序"文件夹中
3. 双击启动应用程序

虽然 PostgresApp 可以从其他位置启动，但建议将其放在应用程序文件夹中以确保所有功能正常工作。

二、命令行工具配置

为了能够在终端中直接使用 PostgreSQL 的命令行工具（如 psql），需要将 PostgresApp 的二进制目录添加到系统 PATH 中：

sudo mkdir -p /etc/paths.d && echo /Applications/Postgres.app/Contents/Versions/latest/bin | sudo tee /etc/paths.d/postgresapp

执行此命令后，重新打开终端窗口即可使用 PostgreSQL 命令行工具。

三、初始化 PostgreSQL 服务器

PostgresApp 默认配置了最新支持的 PostgreSQL 版本服务器：

1. 启动 PostgresApp 后，点击"Initialize"按钮初始化服务器
2. 系统会自动创建一个与当前用户名同名的数据库

PostgreSQL 服务器（集群）可以包含多个数据库。您可以通过以下方式创建更多数据库：

• 使用 createdb 命令行工具
• 执行 CREATE DATABASE SQL 命令

PostgresApp 支持在 Mac 上运行多个 PostgreSQL 服务器实例，这对于需要同时使用不同 PostgreSQL 版本的情况特别有用。要添加新集群，只需点击侧边栏中的"+"图标。

四、安全配置：设置密码保护

默认情况下，PostgreSQL 允许本地应用无需密码连接（"trust"认证）。为提高安全性，建议启用"scram-sha-256"认证：

1. 停止服务器
2. 修改认证方法：
   • 点击"Server Settings…"按钮
   • 找到 HBA 文件并点击"Show"
   • 在文本编辑器中打开文件
   • 将 trust 替换为 scram-sha-256
3. 为每个用户设置密码：
   • 点击"Server Settings…"按钮
   • 点击"Change Password…"按钮
   • 设置新密码（不要使用电脑登录密码）
4. 重新启动服务器

注意：对于 PostgreSQL 14 之前的版本，请使用 md5 替代 scram-sha-256。

设置密码后，数据库将不再显示在 PostgresApp 界面中。

五、配置网络访问权限

默认情况下，PostgreSQL 只允许本地连接。如需允许网络中的其他计算机访问：

1. 停止服务器
2. 确保已配置密码（见上一节）
3. 修改监听地址：
   • 点击"Server Settings…"按钮
   • 找到配置文件并点击"Show"
   • 在文本编辑器中打开文件
   • 找到 listen_addresses 设置，删除前面的 #，并将值从 'localhost' 改为 '*'
4. 更新 HBA 文件：
   • 在 HBA 文件末尾添加：host all all 0.0.0.0/0 scram-sha-256
5. 重新启动服务器

六、PostgreSQL 扩展管理

PostgresApp 包含许多有用的扩展，使用前需要在每个数据库中单独安装：

CREATE EXTENSION 扩展名;

PostgresApp 包含的常用扩展包括：

• PostGIS（地理信息系统）
• pgRouting（路径规划）
• pgvector（向量搜索）
• PL/Python（Python 存储过程）
• PL/JS（JavaScript 存储过程）
• PL Debugger（调试工具）
• 以及大多数 contrib 扩展

要查看所有可用扩展，可以执行 SQL 查询：

SELECT * FROM pg_available_extensions;

七、高级主题：构建自定义扩展

对于高级用户，可以构建自定义 PostgreSQL 扩展：

1. 确保 $PATH 配置正确且 pg_config 可用
2. 使用标准构建命令：make && make install
3. 首次构建时，macOS 会提示"Terminal 尝试修改应用程序"，可在系统设置/安全中调整

注意事项：

• 安装自定义扩展会破坏 PostgresApp 的代码签名
• 自定义扩展在更新 PostgresApp 时会被移除，需重新构建
• 建议在构建自定义扩展前先启动 PostgresApp

八、重要目录说明

• 二进制文件：/Applications/Postgres.app/Contents/Versions/latest/bin
• 头文件：/Applications/Postgres.app/Contents/Versions/latest/include
• 库文件：/Applications/Postgres.app/Contents/Versions/latest/lib
• 默认数据目录：~/Library/Application Support/Postgres/var-XX（XX 是 PostgreSQL 主版本号）

九、卸载 PostgresApp

如需卸载 PostgresApp：

1. 退出 PostgresApp（通过菜单栏图标）并将其拖到废纸篓
2. （可选）删除数据目录（默认位置：~/Library/Application Support/Postgres）
3. （可选）删除偏好设置：defaults delete com.postgresapp.Postgres2
4. （可选）移除命令行工具的 PATH 配置：sudo rm /etc/paths.d/postgresapp

通过本文的详细指南，您应该能够轻松地在 macOS 上安装、配置和管理 PostgreSQL 数据库环境。PostgresApp 极大地简化了 PostgreSQL 的使用流程，让开发者可以更专注于应用开发而非环境配置。

PostgresApp PostgresApp是一个开源的PostgreSQL应用程序，用于在macOS上运行PostgreSQL数据库。 - 功能：PostgreSQL应用程序；macOS；PostgreSQL数据库。 - 特点：易于使用；轻量级；支持多种编程语言；高性能。 项目地址: https://gitcode.com/gh_mirrors/po/PostgresApp