最详细安装 PostgreSQL方法及常见问题解决

音娱家

目录

• 一、在 Windows 系统上安装 PostgreSQL
• 1. 下载 PostgreSQL 安装包
• 2. 安装 PostgreSQL
• 3. 验证 PostgreSQL 安装
• 4. 配置 PostgreSQL 启动项
• 二、在 Linux 系统上安装 PostgreSQL
• 1. 安装 PostgreSQL
• 2. 配置 PostgreSQL
• 3. 设置 PostgreSQL
• 4. 验证安装
• 三、在 macOS 系统上安装 PostgreSQL
• 3. 设置 PostgreSQL 超级用户密码
• 4. 验证安装
• 四、常见问题解决
• 1. 无法连接到 PostgreSQL 数据库
• 2. 无法通过 pgAdmin 连接

一、在 Windows 系统上安装 PostgreSQL

1. 下载 PostgreSQL 安装包

• 访问 PostgreSQL 官网下载页面：https://www.postgresql.org/download/windows/
• 选择 “Windows” 版本，点击下载并进入 EnterpriseDB 的安装页面。
• 下载最新版的安装包（.exe 文件）。

2. 安装 PostgreSQL

• 双击下载的安装包（.exe 文件）。
• 在弹出的安装向导中，点击 Next 继续。
• 选择安装目录（默认安装路径为 C:\Program Files\PostgreSQL\xx，可以更改，但建议使用默认路径）。
• 选择安装的组件，默认情况下所有组件都会被勾选（包括 PostgreSQL Server、pgAdmin、Command Line Tools、StackBuilder）。一般保留默认设置即可，点击 Next。
• 设置数据库集群的 数据目录。这个目录会存放所有数据库的数据文件。你可以选择默认路径或自定义路径，点击 Next。
• 设置超级用户密码（即 postgres 用户的密码）。请记住这个密码，后面需要用到。
• 选择数据库端口（默认是 5432），一般不需要修改，点击 Next。
• 选择语言设置，通常选择 English 即可，点击 Next。
• 点击 Next，然后 Install 开始安装 PostgreSQL。
• 安装完成后，点击 Finish 完成安装。

3. 验证 PostgreSQL 安装

• 在安装完成后，可以通过 pgAdmin（PostgreSQL 提供的图形界面工具）来连接数据库。
• 启动 pgAdmin，输入安装时设置的密码，连接到本地数据库。
• 你可以通过 SQL 查询工具 执行以下命令来验证数据库是否正常运行：

SELECT version();

4. 配置 PostgreSQL 启动项

如果你希望 PostgreSQL 在 Windows 启动时自动启动，可以通过以下步骤配置：

• 打开 服务管理器（按 Win + R，输入 services.msc）。
• 找到 PostgreSQL 服务（通常命名为 postgresql-x64-xx）。
• 右键点击，选择 属性。在 启动类型 中选择 自动，然后点击 应用 和 确定。

二、在 Linux 系统上安装 PostgreSQL

1. 安装 PostgreSQL

对于 Ubuntu/Debian 系统：

更新系统：

sudo apt update

安装 PostgreSQL：

sudo apt install postgresql postgresql-contrib

对于 CentOS/RHEL 系统： 更新系统：

sudo yum update

安装 PostgreSQL：

sudo yum install postgresql-server postgresql-contrib

初始化数据库：

sudo postgresql-setup initdb

启动 PostgreSQL 服务：

sudo systemctl start postgresql

设置 PostgreSQL 在开机时自动启动：

sudo systemctl enable postgresql

2. 配置 PostgreSQL

PostgreSQL 默认使用 peer 认证方式来允许操作系统用户登录。如果要使用密码认证，你需要修改 PostgreSQL 的配置文件：

sudo nano /var/lib/pgsql/data/pg_hba.conf

找到如下行：

local   all             postgres                                peer

将 peer 改为 md5，然后保存并退出。重启 PostgreSQL 服务以应用配置：

sudo systemctl restart postgresql

3. 设置 PostgreSQL

超级用户密码 切换到 PostgreSQL 用户：

sudo -i -u postgres

进入 PostgreSQL 命令行界面：

psql

设置 postgres 用户密码：

ALTER USER postgres WITH PASSWORD 'yourpassword';

退出 PostgreSQL 命令行：

\q

4. 验证安装

你可以使用以下命令来验证 PostgreSQL 是否安装成功并正常工作：

psql -U postgres -h localhost -d postgres

三、在 macOS 系统上安装 PostgreSQL

1. 使用 Homebrew 安装 PostgreSQL 如果还没有安装 Homebrew，请先安装：

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

安装 PostgreSQL：

brew install postgresql

2. 启动 PostgreSQL 启动 PostgreSQL：

brew services start postgresql

设置 PostgreSQL 在开机时自动启动：

brew services start postgresql

3. 设置 PostgreSQL 超级用户密码

切换到 PostgreSQL 用户：

psql postgres

设置 postgres 用户密码：

ALTER USER postgres WITH PASSWORD 'yourpassword';

退出 PostgreSQL 命令行：

\q

4. 验证安装

你可以通过以下命令验证 PostgreSQL 是否安装成功并正常工作：

psql -U postgres -h localhost -d postgres

四、常见问题解决

1. 无法连接到 PostgreSQL 数据库

确认 PostgreSQL 服务是否正在运行：

sudo systemctl status postgresql

确保防火墙没有阻止 PostgreSQL 默认端口（5432）。

2. 无法通过 pgAdmin 连接

确保 pg_hba.conf 配置文件中已经设置为 md5 认证。检查 PostgreSQL 配置文件 postgresql.conf 中的 listen_addresses 是否设置为 '*'，即允许所有 IP 连接。