第 2 章:安装与配置 - PostgreSQL入门

deer332025-08-18技术文章24

第 2 章：安装与配置 - PostgreSQL入门

上一章我们和 PostgreSQL 打了个招呼，现在是时候邀请这位“大象”朋友到我们的电脑里做客了！

本章的目标是：成功安装并运行 PostgreSQL。

别担心，整个过程比你想象的要简单。我将为你介绍在主流操作系统上安装的方法，并且会隆重推荐一个“作弊神器”—— Docker，它能让你在 5 分钟内搞定一切！

2.1 在 Windows 上安装视窗

对于 Windows 用户，PostgreSQL 官方提供了一键安装包，非常友好。

下载安装包:

访问 EnterpriseDB (EDB) 的下载页面，这是官方推荐的第三方安装包。
选择最新版本的 PostgreSQL，然后根据你的系统选择 Windows x86-64。
点击下载，稍等片刻。

开始安装:

双击下载好的 .exe 文件，启动安装向导。
一路点击 Next，你可以自定义安装路径，但保持默认通常是最好的选择。
在选择组件 (Select Components) 页面，请确保勾选了以下四项：PostgreSQL Server: 数据库服务器本体。pgAdmin 4: 超级好用的图形化管理工具。Stack Builder: 用于安装扩展和驱动。Command Line Tools: 命令行工具，比如我们后面要用的 psql。
设置数据目录 (Data Directory)，同样，保持默认即可。

设置超级管理员密码:

这是最重要的一步！安装程序会要求你为默认的超级管理员用户 postgres 设置一个密码。

请务必设置一个你能记住的密码！ 后面我们连接数据库全靠它了。

端口设置:

默认端口是 5432，这是 PostgreSQL 的标准端口，不要修改，除非你明确知道有端口冲突。

完成安装:

一路 Next 到底，等待安装完成。最后，安装向导可能会询问你是否启动 Stack Builder，暂时取消勾选，点击 Finish 即可。

验证安装:

在开始菜单找到 pgAdmin 4 并启动它，如果能成功打开，说明你的数据库已经在后台运行了！

2.2 在 macOS 上安装苹果

对于 Mac 用户，我们强烈推荐使用 Homebrew 这个包管理器来安装，干净又省心。

安装 Homebrew (如果还没有的话):

打开“终端” (Terminal) 应用，粘贴并执行以下命令：

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

安装 PostgreSQL:

在终端里运行：

brew install postgresql

Homebrew 会自动帮你搞定一切。

启动 PostgreSQL 服务:

安装完成后，你可以使用以下命令来启动服务，并设置为开机自启：

brew services start postgresql

如果你只想手动启动，可以运行 pg_ctl -D /usr/local/var/postgres start。

验证安装:

在终端输入 psql postgres，如果能成功进入一个以 postgres=# 开头的命令行界面，那就说明你成功了！

2.3 在 Linux (Ubuntu) 上安装企鹅

Linux 世界里，安装 PostgreSQL 同样是一条命令的事。这里以最流行的 Ubuntu 为例：

更新包列表:

sudo apt update

安装 PostgreSQL:

sudo apt install postgresql postgresql-contrib

postgresql-contrib 包包含了一些非常有用的官方扩展。

验证安装:

安装完成后，PostgreSQL 服务会自动启动。默认情况下，它会创建一个名为 postgres 的 Linux 用户，你可以用它来登录数据库。

在终端输入：

sudo -u postgres psql

如果看到 psql 的欢迎信息，就大功告成了！

2.4 终极神器：使用 Docker 快速搭建 (强烈推荐)

好了，朋友们，前面的方法虽然不难，但或多或少都会在你的电脑上“留下痕跡”。

现在，我要介绍的是现代开发者最爱的方式——Docker。

为啥推荐 Docker？

快！一条命令，3 分钟内一个干净、纯粹的数据库就跑起来了。
干净！ 所有数据和程序都在一个隔离的“容器”里，想删除的时候，直接删掉容器就行，对你的电脑系统零污染。
一致！ 无论你用 Windows, Mac 还是 Linux，只要装了 Docker，体验完全一样！

怎么做？

安装 Docker Desktop:

访问 Docker 官网，下载并安装适合你操作系统的 Docker Desktop。过程很简单，一路点下去就行。

一行命令启动 PostgreSQL:

打开你的终端 (Windows 用户可以用 PowerShell 或 WSL)，然后运行这行神奇的命令：

docker run --name my-postgres -e POSTGRES_PASSWORD=mysecretpassword -p 5432:5432 -d postgres

我们来拆解一下这行命令：

docker run: 告诉 Docker，我们要启动一个新容器。

--name my-postgres: 给这个容器起个名字，叫 my-postgres。

-e POSTGRES_PASSWORD=mysecretpassword: 最关键的一步！ 设置数据库超级管理员 postgres 的密码为 mysecretpassword。你可以换成你自己的密码。

-p 5432:5432: 把我们电脑的 5432 端口映射到容器的 5432 端口。这样，我们就能通过本机的 5432 端口访问到容器里的数据库了。

-d: 表示在后台“分离模式”下运行。

postgres: 告诉 Docker 我们要使用哪个镜像，这里就是官方的 postgres 镜像。

第一次运行，Docker 会先去下载镜像，稍等片刻。当你在终端看到一长串字符（容器 ID）时，就代表成功启动了！

如何确认它在运行？

运行 docker ps，你应该能看到一个名为 my-postgres 的容器正在 Up 状态。

2.5 两个神秘的配置文件 (了解即可)

在你安装 PostgreSQL 的目录里，有两个非常重要的配置文件，现在我们只需要知道它们是干啥的就行，暂时不用动它。

postgresql.conf: 这是主配置文件，里面有几百个参数，控制着数据库的方方面面，比如内存分配、连接数、日志记录等等。以后做性能优化时，我们会和它打交道。
pg_hba.conf: 这个文件是用来控制“谁能从哪里用什么方式连接哪个数据库”的。HBA 的全称是 Host-Based Authentication。它像个保安，负责访问控制。