首页 > 数据库 > PostgreSQL > Mac OS安装PostgreSQL

Mac OS上安装PostgreSQL完整图文教程

2026-01-11 11:22:48 作者：yingjuxia.com

这篇文章主要介绍了Mac OS上安装PostgreSQL的完整图文教程,问文中通过代码详细介绍了如何设置密码、允许远程连接、常用命令、备份与恢复、卸载以及常见问题解决方法,需要的朋友可以参考下

macOS 上安装 PostgreSQL（完整图文教程）

适用于 macOS 12+（Monterey / Ventura / Sonoma / Sequoia），支持 Apple Silicon（M1/M2/M3） 和 Intel
推荐使用 Homebrew（最简单、最常用）

一、推荐方式：使用 Homebrew 安装（99% 用户选这个）

1. 安装 Homebrew（如果还没装）

打开 终端（Terminal），粘贴运行：

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

安装过程会提示输入密码并按回车。

2. 安装 PostgreSQL

brew install postgresql

自动安装最新稳定版（如 PostgreSQL 17），并包含：

psql 命令行工具
pg_dump、createdb 等
pgAdmin 可选（后面教你装）

3. 启动 PostgreSQL 服务

# 启动服务（当前会话）
brew services start postgresql

# 或手动启动（推荐）
pg_ctl -D /opt/homebrew/var/postgres start   # Apple Silicon
# pg_ctl -D /usr/local/var/postgres start    # Intel 旧版

4. 设置开机自启（可选）

brew services start postgresql

以后系统启动时自动运行 PostgreSQL。

5. 验证安装成功

psql --version
# 输出类似：psql (PostgreSQL) 17.0

# 进入数据库
psql postgres

在 psql 中运行：

SELECT version();
\l
\q

二、其他安装方式（了解即可）

方式	说明	推荐度
Postgres.app	拖拽式 GUI 应用，一键启动	★★★★
官方安装包	`.dmg` 安装，带 pgAdmin	★★★
Docker	容器化，隔离环境	★★★★

三、Postgres.app 方式（适合新手 / 想图形化启动）

下载：https://postgresapp.com
拖到 应用程序 文件夹
双击打开 → 自动初始化并启动
菜单栏有小象图标，可一键启停

默认数据目录：~/Library/Application Support/Postgres/var-17

四、图形化管理工具（推荐安装一个）

方式 1：安装 pgAdmin 4（官方 GUI）

brew install --cask pgadmin4

安装后从 Launchpad 打开，添加本地服务器：

Host: localhost
Port: 5432
User: 你的 mac 用户名（Homebrew 版默认）

方式 2：DBeaver（免费多数据库 GUI）

brew install --cask dbeaver-community

五、Homebrew 版 PostgreSQL 重要路径

路径	说明
`/opt/homebrew/var/postgres`	数据目录（M1/M2/M3）
`/usr/local/var/postgres`	数据目录（Intel 旧版）
`/opt/homebrew/bin/psql`	命令行工具
`/opt/homebrew/etc/postgresql@17`	配置文件

六、设置密码 & 创建用户（推荐）

Homebrew 安装的 PostgreSQL 默认无密码，通过本地 socket 认证。

设置postgres角色密码：

psql postgres

ALTER USER postgres WITH PASSWORD 'your_secure_password';
\q

创建应用专用用户和数据库

psql postgres

CREATE DATABASE myapp;
CREATE USER appuser WITH ENCRYPTED PASSWORD 'apppass123';
GRANT ALL PRIVILEGES ON DATABASE myapp TO appuser;
\q

测试连接：

psql -h localhost -U appuser -d myapp

七、允许远程连接（开发/测试用）

1. 修改监听地址

nano /opt/homebrew/var/postgres/postgresql.conf

找到并修改：

# listen_addresses = 'localhost'
listen_addresses = '*'

2. 修改认证方式

nano /opt/homebrew/var/postgres/pg_hba.conf

末尾添加：

# 允许局域网
host    all             all             192.168.1.0/24          md5

# 允许所有（仅测试！）
# host    all             all             0.0.0.0/0               md5

3. 重启服务

brew services restart postgresql

4. 开放 macOS 防火墙（系统设置 → 网络 → 防火墙）

或命令行：

sudo /usr/libexec/ApplicationFirewall/socketfilterfw --add /opt/homebrew/bin/postgres

八、常用命令总结（终端）

命令	说明
`brew services start postgresql`	启动服务
`brew services stop postgresql`	停止服务
`brew services restart postgresql`	重启
`psql postgres`	进入数据库
`pg_dump mydb > backup.sql`	备份
`psql mydb < backup.sql`	恢复
`createdb mydb`	创建数据库
`dropdb mydb`	删除数据库
`pg_ctl status`	查看状态

九、备份与恢复

# 备份
pg_dump -U postgres myapp > myapp_backup.sql

# 恢复
psql -U postgres myapp < myapp_backup.sql
# 或
createdb myapp_restore
psql -U postgres myapp_restore < myapp_backup.sql

十、卸载 PostgreSQL（彻底清理）

# 停止服务
brew services stop postgresql

# 卸载
brew uninstall postgresql

# 删除数据（谨慎！）
rm -rf /opt/homebrew/var/postgres
rm -rf /usr/local/var/postgres

# 删除配置文件
rm -rf /opt/homebrew/etc/postgresql@*

十一、常见问题（FAQ）

问题	解决方法
`psql: error: could not connect to server`	`brew services start postgresql`
`FATAL: role "postgres" does not exist`	重新初始化：`initdb /opt/homebrew/var/postgres`
`permission denied for database postgres`	检查数据目录权限：`chmod 700 /opt/homebrew/var/postgres`
想换端口	修改 `postgresql.conf` 中的 `port = 5433`

十二、学习资源

官方文档：https://www.postgresql.org/docs/
Postgres.app：https://postgresapp.com
Homebrew 公式：https://formulae.brew.sh/formula/postgresql

恭喜！你已成功在 macOS 上安装 PostgreSQL！

到此这篇关于Mac OS上安装PostgreSQL的文章就介绍到这了,更多相关Mac OS安装PostgreSQL内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！