2.3 在 macOS 上安装 PostgreSQL

最新推荐文章于 2025-06-10 11:25:34 发布

Python老吕

最新推荐文章于 2025-06-10 11:25:34 发布

阅读量1.7k

点赞数 21

CC 4.0 BY-SA版权

分类专栏：《跟老吕学PostgreSQL》文章标签： postgresql PostgreSQL安装教程

本文链接：https://blog.csdn.net/molangmolang/article/details/142308799

《跟老吕学PostgreSQL》专栏收录该内容

58 篇文章

订阅专栏

2.3 在 macOS 上安装 PostgreSQL

- - 2.3 在 macOS 上安装 PostgreSQL

2.3 在 macOS 上安装 PostgreSQL

2.3.1 系统要求与环境准备

2.3.1.1 macOS 版本要求

PostgreSQL 通常支持最新的 macOS 版本以及之前的几个版本。在安装 PostgreSQL 之前，请确保你的 macOS 版本满足以下要求：

macOS Big Sur (11) 或更高版本：PostgreSQL 的最新版本通常与最新的 macOS 版本兼容。
macOS Catalina (10.15) 或 macOS Mojave (10.14)：对于这些早期版本的 macOS，你可能需要下载与这些系统兼容的 PostgreSQL 版本。

在安装之前，查看 PostgreSQL 官方网站上的具体版本要求，以确保你下载的版本与你的 macOS 版本兼容。

2.3.1.2 推荐的系统配置

为了确保 PostgreSQL 在 macOS 上运行顺畅，以下是一些推荐的系统配置：

处理器：至少需要一个双核处理器。对于更复杂的数据库操作或更大的数据集，建议使用更高性能的处理器。
内存：至少需要 4GB RAM。对于大型数据库或多用户环境，建议使用 8GB 或更多的内存。
硬盘空间：至少需要 10GB 的可用硬盘空间来安装 PostgreSQL 及其数据文件。建议使用 SSD 以获得更好的性能。
网络连接：如果你计划远程访问数据库，需要一个稳定的网络连接。
软件依赖：确保你的系统上安装了最新版本的 Xcode Command Line Tools，因为某些 PostgreSQL 功能可能需要编译工具。

在安装 PostgreSQL 之前，建议更新你的 macOS 系统到最新版本，并检查上述推荐的系统配置，以确保 PostgreSQL 能够顺利安装和运行。

2.3.2 安装方法概览

2.3.2.1 通过 Homebrew 安装

Homebrew 是 macOS 上最流行的包管理器之一，它提供了一个简单的方式来安装 PostgreSQL。

安装 Homebrew（如果尚未安装）：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

使用 Homebrew 安装 PostgreSQL：
```
brew install postgresql
```
启动 PostgreSQL 服务：
```
brew services start postgresql
```
验证安装：
安装完成后，你可以使用 psql 命令行工具来验证安装是否成功。

2.3.2.2 通过 Postgres.app 安装

Postgres.app 是一个为 macOS 用户打包的 PostgreSQL 应用程序，它提供了一个简单的图形界面来管理 PostgreSQL 服务。

下载 Postgres.app：
访问 Postgres.app 官网下载最新版本的应用程序。
安装并启动应用程序：
下载并打开应用程序，它将自动安装 PostgreSQL 并启动服务。
使用应用程序：
Postgres.app 会在你的菜单栏中提供一个图标，你可以点击它来管理数据库服务、查看日志和连接到数据库。

2.3.2.3 通过 dmg 安装包安装

除了 Homebrew 和 Postgres.app，你还可以通过下载 dmg 安装包来安装 PostgreSQL。

下载 dmg 安装包：
访问 PostgreSQL 官方网站下载适用于 macOS 的 dmg 安装包。
打开 dmg 文件：
打开下载的 dmg 文件，然后将 PostgreSQL 应用程序拖动到“应用程序”文件夹中。
安装和启动：
打开应用程序，根据提示完成安装。安装完成后，应用程序可能会自动启动 PostgreSQL 服务。
配置和验证：
根据需要配置 PostgreSQL，然后使用 psql 或其他客户端工具验证安装是否成功。

每种安装方法都有其优点，Homebrew 提供了最简单的命令行安装方式，Postgres.app 提供了图形界面和便捷的管理工具，而 dmg 安装包则提供了更多的自定义选项。选择哪种方法取决于你的个人偏好和需求。

2.3.3 使用 Homebrew 安装 PostgreSQL

2.3.3.1 安装 Homebrew

Homebrew 是 macOS 的包管理器，如果你的系统尚未安装 Homebrew，可以通过以下命令安装：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

安装完成后，你可能需要将 Homebrew 添加到你的 PATH 环境变量中，这通常在安装过程中自动完成。

2.3.3.2 搜索可用的 PostgreSQL 版本

在安装 PostgreSQL 之前，你可以搜索 Homebrew 上可用的 PostgreSQL 版本：

brew search postgresql

这将列出所有与 PostgreSQL 相关的公式，包括不同版本的 PostgreSQL。

2.3.3.3 安装 PostgreSQL

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

brew install postgresql

Homebrew 将自动下载并安装最新版本的 PostgreSQL。安装过程中，Homebrew 还会安装所有必要的依赖。

2.3.3.4 启动 PostgreSQL 服务

安装完成后，你可以启动 PostgreSQL 服务：

brew services start postgresql

这个命令将 PostgreSQL 设置为后台服务，并在系统启动时自动启动。

2.3.3.5 验证安装

验证 PostgreSQL 是否成功安装并运行，可以通过连接到数据库来测试：

打开终端。
连接到 PostgreSQL：
```
psql -U postgres
```
这将尝试以默认的 postgres 用户连接到 PostgreSQL。
运行测试查询：
在 psql 提示符下，输入以下命令：
```
SELECT version();
```
这将返回 PostgreSQL 的版本信息。
退出 psql：
```
\q
```
这将退出 psql 命令行界面。

如果以上步骤均成功完成，说明你已成功安装并配置了 PostgreSQL。如果遇到任何问题，可以检查 Homebrew 的安装日志或 PostgreSQL 的文档以获取帮助。

2.3.4 使用 Postgres.app 安装 PostgreSQL

2.3.4.1 下载 Postgres.app

Postgres.app 是一个为 macOS 用户打包的 PostgreSQL 应用程序，它提供了一个简单的图形界面来管理 PostgreSQL 服务。

访问 Postgres.app 官网：打开浏览器，访问 Postgres.app 官网。
下载应用程序：在官网上下载最新版本的 Postgres.app。

2.3.4.2 初始化数据库

下载并打开 Postgres.app 后，应用程序将引导你完成数据库的初始化过程。

打开 Postgres.app：双击下载的 Postgres.app 文件，启动应用程序。
初始化数据库：首次启动时，Postgres.app 会自动初始化数据库。这个过程可能需要一些时间。
设置密码：初始化过程中，系统会提示你为 postgres 超级用户设置密码。

2.3.4.3 配置 Postgres.app

初始化完成后，你可以配置 Postgres.app 以满足你的需求。

访问偏好设置：在 Postgres.app 菜单栏中，点击 “Postgres” -> “Preferences”。
配置连接：在偏好设置中，你可以配置数据库的连接设置，如端口号和SSL模式。
设置自动启动：在偏好设置中，你可以选择在系统启动时自动启动 PostgreSQL 服务。
管理数据库：Postgres.app 提供了一个简单的界面来管理数据库，你可以创建、删除和维护数据库。

安装和配置完成后，Postgres.app 将在你的菜单栏中显示一个图标，你可以点击它来快速访问数据库服务的状态和控制选项。通过这个应用程序，你可以轻松地启动、停止、重启 PostgreSQL 服务，以及查看日志和执行其他管理任务。

Postgres.app 是 macOS 用户安装和使用 PostgreSQL 的一个非常便捷的方式，特别是对于那些希望避免命令行操作的用户。

2.3.5 使用 dmg 安装包安装 PostgreSQL

2.3.5.1 下载 dmg 安装包

访问 PostgreSQL 官方网站：打开浏览器，访问 PostgreSQL 官方网站。
下载 dmg 安装包：在下载页面中，找到适用于 macOS 的 dmg 安装包并下载。

2.3.5.2 创建必要的用户和组

在安装 PostgreSQL 之前，建议创建一个专门的用户和组来运行数据库服务，以提高系统安全性。

打开终端。

创建一个新的组（如果还没有）：

sudo dscl . -create /Groups/_postgres
sudo dscl . -create /Groups/_postgres gid 1000

创建一个新的用户：

sudo dscl . -create /Users/postgres
sudo dscl . -create /Users/postgres PrimaryGroupID 1000
sudo dscl . -create /Users/postgres UserShell /bin/bash
sudo dscl . -create /Users/postgres NFSHomeDirectory /usr/local/pgsql
sudo dscl . -create /Users/postgres RealName "PostgreSQL Server"
sudo dscl . -create /Users/postgres UniqueID 1001
sudo dscl . -create /Users/postgres _passwd "password"
sudo dscl . -append /Groups/_postgres GroupMembership postgres

替换 password 为一个强密码。

2.3.5.3 安装 PostgreSQL

打开下载的 dmg 文件：挂载 dmg 文件，然后将 PostgreSQL 应用程序拖动到“应用程序”文件夹中。
打开应用程序：从“应用程序”文件夹中找到 PostgreSQL 应用程序并打开。

2.3.5.4 配置数据库环境

初始化数据库：在终端中，使用以下命令初始化数据库：
```
sudo -u postgres -H initdb
```
这将初始化 PostgreSQL 数据库。
配置环境变量：在你的 shell 配置文件（如 .bash_profile 或 .zshrc）中设置环境变量：
```
export PGDATA="/usr/local/pgsql/data"
export PGUSER="postgres"
export PGHOST="localhost"
export PGPORT="5432"
export PATH="/usr/local/pgsql/bin:$PATH"
```
这些环境变量将帮助系统找到 PostgreSQL 的数据目录和可执行文件。
启动 PostgreSQL：使用以下命令启动 PostgreSQL 服务：
```
sudo -u postgres -H postgres -D /usr/local/pgsql/data
```
验证安装：在终端中，尝试连接到数据库：
```
psql -U postgres
```
如果连接成功，你将看到 PostgreSQL 的命令行界面。

设置超级用户密码（如果需要）：

ALTER USER postgres PASSWORD '新密码';

通过使用 dmg 安装包，你可以更灵活地控制 PostgreSQL 的安装和配置。这种方法适合那些需要更多自定义选项的用户。

2.3.6 配置 PostgreSQL

2.3.6.1 配置环境变量

在 macOS 上配置 PostgreSQL 环境变量可以帮助系统和应用程序找到 PostgreSQL 的可执行文件和数据目录。

打开终端。
编辑 shell 配置文件，例如 ~/.bash_profile 或 ~/.zshrc（取决于你使用的 shell）：
```
nano ~/.bash_profile
```

添加 PostgreSQL 环境变量：

export PGDATA="/usr/local/pgsql/data"  # 数据目录路径
export PGUSER="postgres"              # 默认数据库用户
export PGHOST="localhost"            # 数据库主机名
export PGPORT="5432"                 # 数据库端口号
export PATH="/usr/local/pgsql/bin:$PATH"  # PostgreSQL 可执行文件路径

保存并关闭文件。
应用环境变量：
```
source ~/.bash_profile
```

确保替换路径为你的 PostgreSQL 安装路径，如果使用默认路径则无需更改。

2.3.6.2 配置数据库连接

配置数据库连接涉及到设置用户权限和连接参数。

创建数据库用户（如果需要）：

CREATE ROLE newuser WITH LOGIN PASSWORD 'password';

创建数据库：

CREATE DATABASE newdatabase OWNER newuser;

配置 pg_hba.conf 文件：
- 找到 pg_hba.conf 文件，通常位于数据目录中。
- 编辑文件以允许特定主机或网络的连接，例如：
```
host    all             all            127.0.0.1/32            md5
```
重启 PostgreSQL 服务 以应用更改：
```
brew services restart postgresql
```

2.3.6.3 配置远程访问

默认情况下，PostgreSQL 可能只允许本地连接。要配置远程访问，需要修改 pg_hba.conf 文件并可能需要调整防火墙设置。

编辑 pg_hba.conf 文件：
- 允许远程主机连接，例如：
```
host    all             all            192.168.1.0/24        md5
```
- 这行配置允许 192.168.1.0/24 子网中的所有主机使用 MD5 密码认证连接到数据库。
调整防火墙设置：
- 如果你的 macOS 系统有防火墙，确保允许 PostgreSQL 使用的端口（默认为 5432）。
重启 PostgreSQL 服务：
```
brew services restart postgresql
```
测试远程连接：
- 从远程主机使用 psql 或其他数据库客户端工具测试连接：
```
psql -h your_server_ip -U newuser -d newdatabase
```

通过这些配置，你可以确保 PostgreSQL 在 macOS 上正确运行，并且可以根据需要进行本地或远程连接。

2.3.7 基础管理与操作

2.3.7.1 连接到数据库

连接到 PostgreSQL 数据库通常使用 psql 命令行工具，这是 PostgreSQL 自带的一个功能强大的客户端。

打开终端。
使用 psql 连接数据库：
```
psql -U username -d databasename
```
替换 username 为你的数据库用户名，databasename 为你想要连接的数据库名称。如果连接本地数据库，可以使用默认端口（5432）。
输入密码：如果设置了密码，系统会提示你输入密码。
退出 psql：
在 psql 命令行中，你可以使用 \q 命令退出。

2.3.7.2 创建和管理数据库

使用 psql 或其他 SQL 客户端工具，你可以执行 SQL 命令来创建和管理数据库。

创建数据库：
```
CREATE DATABASE databasename;
```
替换 databasename 为你想要创建的数据库名称。
删除数据库：
```
DROP DATABASE databasename;
```
替换 databasename 为你想要删除的数据库名称。
查看所有数据库：
```
\l
```
在 psql 中，\l 命令列出所有数据库。

2.3.7.3 创建和管理用户

用户管理是数据库安全性的重要组成部分，你可以创建用户、设置权限和删除用户。

创建用户：
```
CREATE ROLE username WITH LOGIN PASSWORD 'password';
```
替换 username 为你想要创建的用户名称，password 为用户的密码。
删除用户：
```
DROP ROLE username;
```
替换 username 为你想要删除的用户名称。

授予用户权限：

GRANT CONNECT ON DATABASE databasename TO username;
GRANT USAGE ON SCHEMA schemaname TO username;
GRANT SELECT ON ALL TABLES IN SCHEMA schemaname TO username;

这些命令授予用户连接数据库、使用模式和选择所有表的权限。

查看用户列表：
```
\du
```
在 psql 中，\du 命令列出所有角色。

通过这些基础的管理与操作，你可以有效地管理 PostgreSQL 数据库的用户和数据库。记得在执行任何管理操作前，确保你有足够的权限，并在生产环境中进行操作时格外小心。

2.3.8 常见问题与解决方案

2.3.8.1 解决安装过程中的问题

在安装 PostgreSQL 过程中可能会遇到的问题及其解决方案：

依赖性问题：
- 确保所有必需的依赖性软件包都已安装。如果缺少依赖，安装程序通常会提供错误信息，指出需要哪些包。使用包管理器安装缺失的依赖。
权限问题：
- 如果在安装过程中遇到权限问题，确保你有足够的权限来安装软件、写入文件系统和配置服务。在 Linux 上，使用 sudo 命令来获取必要的权限。在 macOS 或 Windows 上，确保以管理员身份运行安装程序。
端口冲突：
- 如果 PostgreSQL 试图使用的端口已被其他服务占用，你可以在 postgresql.conf 文件中更改 port 设置，或者在安装时指定不同的端口。
磁盘空间不足：
- 确保系统上有足够的磁盘空间来安装 PostgreSQL 和存储数据。如果空间不足，清理磁盘或选择其他磁盘进行安装。

2.3.8.2 处理权限和安全问题

处理 PostgreSQL 安装后的权限和安全问题：

设置超级用户密码：
- 如果在安装过程中没有设置超级用户密码，可以通过 psql 命令行工具设置：
```
ALTER USER postgres PASSWORD '新密码';
```
配置 pg_hba.conf 文件：
- 编辑 pg_hba.conf 文件来控制客户端对数据库的访问权限。确保使用适当的认证方法，如 md5 或 scram-sha-256。
限制超级用户权限：
- 为日常操作创建非超级用户账户，并仅在必要时使用超级用户账户。
使用 SSL 连接：
- 在 postgresql.conf 文件中启用 SSL 来保护客户端和服务器之间的连接：
```
ssl = on
ssl_cert_file = 'server.crt'
ssl_key_file = 'server.key'
```
  确保客户端也配置为使用 SSL 连接。
定期更新和打补丁：
- 定期检查并应用 PostgreSQL 的安全更新和补丁，以确保数据库系统的安全性。
监控和审计：
- 启用日志记录，记录所有数据库活动。使用审计扩展（如 pgAudit）来增强审计能力。

通过这些步骤，你可以解决安装过程中的问题并提高 PostgreSQL 的安全性。如果遇到更复杂的问题，可以查阅 PostgreSQL 的官方文档，或在社区论坛和邮件列表中寻求帮助。

2.3.9 进阶配置

2.3.9.1 设置时区和语言

正确的时区和语言设置对于数据库中的时间戳和字符串比较等功能至关重要：

设置时区：
在 postgresql.conf 文件中，可以通过设置 timezone 参数来指定服务器的默认时区。例如，要设置为 UTC，可以使用：
```
timezone = 'UTC'
```
或者，如果你在中国，可以设置为：
```
timezone = 'Asia/Shanghai'
```
更改后需要重启 PostgreSQL 服务以使设置生效。
设置语言：
PostgreSQL 允许你为客户端连接设置语言。这通常在 postgresql.conf 文件中设置 lc_messages 参数来指定服务器的消息语言，例如：
```
lc_messages = 'en_US.UTF-8'
```
这将设置服务器的消息语言为美国英语。同样，更改后需要重启服务。

2.3.9.2 配置日志和审计

日志和审计对于监控数据库活动和确保安全性非常重要：

配置日志：
在 postgresql.conf 文件中，可以设置多个参数来控制日志记录。例如，设置 log_directory 来指定日志文件的位置：
```
log_directory = 'log'
```
并启用详细的查询日志：
```
log_statement = 'all'
```
还可以设置 log_duration 来记录每个语句的执行时间。
使用审计扩展：
PostgreSQL 支持多个审计扩展，如 pgAudit，它可以提供更详细的审计日志。安装 pgAudit 扩展：
```
CREATE EXTENSION pgaudit;
```
配置 pgAudit 以记录所有用户的活动或特定用户和操作的详细日志。
旋转日志文件：
对于大型安装，可能需要配置日志文件的自动旋转。这可以通过配置系统级的日志旋转工具，如 logrotate，来实现。
监控和分析日志：
定期检查和分析日志文件，以识别潜在的性能问题或安全威胁。可以使用日志管理工具来帮助自动化这一过程。

通过这些进阶配置，你可以确保 PostgreSQL 的时区和语言设置正确，并且能够详细记录和监控数据库的活动。这些配置对于维护数据库的性能和安全性至关重要。

2.3.10 卸载 PostgreSQL

2.3.10.1 通过 Homebrew 卸载

如果你通过 Homebrew 安装了 PostgreSQL，可以使用以下步骤来卸载：

停止 PostgreSQL 服务：
```
brew services stop postgresql
```
卸载 PostgreSQL 包：
```
brew uninstall postgresql
```
移除 Homebrew 的 PostgreSQL 链接：
```
brew unlink postgresql
```
清理残留文件（可选）：
如果你想要删除所有与 PostgreSQL 相关的配置文件和数据，可以手动删除它们。通常这些文件位于 /usr/local/var/postgres 或你自定义的数据目录。

2.3.10.2 通过 Postgres.app 卸载

卸载通过 Postgres.app 安装的 PostgreSQL：

关闭 Postgres.app：
在菜单栏中找到 Postgres.app 的图标，点击它，然后选择“Quit Postgres”。
删除应用程序：
找到 Postgres.app，然后拖动它到废纸篓，或者使用 Finder 删除它。
删除数据目录（可选）：
默认情况下，Postgres.app 的数据目录位于 ~/Library/Application Support/Postgres。如果你想要删除所有数据，可以手动删除这个目录。
在“偏好设置”中删除（可选）：
打开“系统偏好设置”，找到 Postgres.app，然后点击“卸载”。

2.3.10.3 手动卸载

如果你通过 dmg 安装包或其他方式手动安装了 PostgreSQL，可以按照以下步骤手动卸载：

停止 PostgreSQL 服务：
如果服务正在运行，你需要先停止它。你可以使用 pg_ctl 命令或通过系统服务管理器来停止服务。
删除 PostgreSQL 应用程序：
找到 PostgreSQL 应用程序和相关文件，并将它们删除。通常这些文件位于 /Applications、/usr/local/pgsql 或你自定义的安装目录。
删除数据目录：
删除 PostgreSQL 数据目录，通常位于 /usr/local/pgsql/data 或你自定义的数据目录。
清理配置文件：
删除 PostgreSQL 的配置文件，如 postgresql.conf 和 pg_hba.conf，它们通常位于数据目录中。
清理环境变量：
如果你在 .bash_profile、.zshrc 或其他 shell 配置文件中设置了 PostgreSQL 相关的环境变量，记得清理这些设置。
重启系统：
在删除文件后，重启系统以确保所有更改生效。