如何在 Ubuntu 22.04 上安装 pgAdmin：一个 PostgreSQL 管理工具

简介

pgAdmin4 是一款易于使用的免费开源图形化 PostgreSQL 管理工具。它支持 PostgreSQL 9.6 及以上版本，并可在包括 Windows、macOS 和 Linux 在内的多种操作系统上运行。pgAdmin4 可以以两种模式运行：桌面用户使用的桌面模式，以及可通过 Web 浏览器从任何地方访问的服务器模式。

在本篇文章中，你将学习如何在 Ubuntu 22.04 上安装 pgAdmin4 服务器模式。你将以 systemd 服务的形式在后台运行 pgAdmin4，并通过 Web 浏览器访问。本教程还涵盖了如何通过官方 PostgreSQL 仓库在 Ubuntu 上安装 PostgreSQL，以及如何在 PostgreSQL 中设置数据库和用户。

接下来，我将一步一步教大家如何进行安装和部署！！

安装 PostgreSQL 服务器

在安装 pgAdmin4 之前，我们先通过官方 PostgreSQL 仓库安装 PostgreSQL 服务器。

首先，运行以下命令下载 PostgreSQL 仓库的 GPG 密钥，并将其导出到“/usr/share/keyrings/postgresql-key.gpg”。

curl https://www.postgresql.org/media/keys/ACCC4CF8.asc | gpg --dearmor | sudo tee /usr/share/keyrings/postgresql-key.gpg >/dev/null

使用以下命令将 PostgreSQL 仓库添加到你的 Ubuntu 系统。

sudo sh -c 'echo "deb [signed-by=/usr/share/keyrings/postgresql-key.gpg arch=amd64] http://apt.postgresql.org/pub/repos/apt $(lsb_release -cs)-pgdg main" > /etc/apt/sources.list.d/pgdg.list'

现在运行以下 ‘apt’ 命令来更新你的 Ubuntu 软件包索引并安装 PostgreSQL 服务器。输入 ‘Y’ 以确认安装。

sudo apt update && sudo apt install postgresql postgresql-contrib

安装完成后，使用以下命令检查 ‘postgresql’ 服务状态。你会看到 PostgreSQL 已启用并正在运行，状态为 ‘exited’。

sudo systemctl is-enabled postgresql
sudo systemctl status postgresql

设置 PostgreSQL 数据库和用户

安装 PostgreSQL 后，你需要在 PostgreSQL 服务器中创建一个新用户和数据库。在本例中，你将使用 ‘psql’ 或 PostgreSQL shell 来创建新的 PostgreSQL 数据库和用户。

使用以下 ‘psql’ 命令登录到 PostgreSQL 服务器。

sudo -u postgres psql

运行以下查询以创建新用户 ‘alice’，密码为 ‘alicepassword’，并验证 PostgreSQL 服务器上的用户列表。你可以使用自己的信息更改用户名和密码。

CREATE ROLE alice WITH SUPERUSER CREATEDB CREATEROLE LOGIN ENCRYPTED PASSWORD 'alicepassword';
\\du

你可以在下面看到用户 ‘alice’ 已在 PostgreSQL 中创建。

现在运行以下查询以创建一个新的数据库 ‘alice’，并将该数据库的权限授予用户 ‘alice’。

CREATE DATABASE alice;
GRANT ALL PRIVILEGES ON DATABASE alice TO alice;

使用以下查询检查 PostgreSQL 上的数据库列表。

\\l

你会看到已创建新的数据库 ‘alice’。

安装 pgAdmin4

现在你已经安装并配置了 PostgreSQL 服务器，可以安装 ‘pgAdmin4-web’ 服务器模式，该模式可以通过官方 pgAdmin4 仓库安装。

使用以下命令下载 pgAdmin4 仓库的 GPG 密钥。

curl -fsSL https://www.pgadmin.org/static/packages_pgadmin_org.pub | sudo gpg --dearmor -o /usr/share/keyrings/pgadmin4.gpg

现在使用以下命令将 pgAdmin4 仓库添加到 Ubuntu 系统。

sudo echo "deb [arch=amd64 signed-by=/usr/share/keyrings/pgadmin4.gpg] https://ftp.postgresql.org/pub/pgadmin/pgadmin4/apt/$(lsb_release -cs) pgadmin4 main"\
| sudo tee /etc/apt/sources.list.d/pgadmin4.list

接下来，运行以下 ‘apt’ 命令来更新你的 Ubuntu 软件包索引并安装 ‘pgadmin4-web’ 软件包。输入 ‘Y’ 以确认安装。

sudo apt update && sudo apt install pgadmin4-web

安装完成后，执行 ‘setup-web.sh’ 脚本来配置 pgAdmin4 的安装。

/usr/pgadmin4/bin/setup-web.sh

现在系统将要求你进行以下 pgAdmin4 配置：

• 输入你的电子邮件地址和密码，用于 pgAdmin4 身份验证
• 输入 ‘y’ 以将 Apache 配置为反向代理
• 输入 ‘y’ 以重启 Apache Web 服务器并应用更改

访问 pgAdmin4

打开你的 Web 浏览器并访问 http://your_server_ip/pgadmin4。如果安装成功，你将看到 pgAdmin4 登录页面。

使用你的电子邮件地址和密码登录到 pgAdmin4 仪表板。

如果你使用了正确的电子邮件地址和密码，你将看到如下所示的 pgAdmin4 仪表板：

登录到 pgAdmin4 后，你需要连接到 PostgreSQL 服务器。单击仪表板中的“添加新服务器”菜单。

• 在“常规”选项卡中输入你的连接名称
• 在“连接”选项卡中输入你的 PostgreSQL 服务器详细信息
• 选中“保存密码”选项
• 单击“保存”

连接到 PostgreSQL 服务器后，你将看到如下页面：

结论

你已完成在 Ubuntu 22.04 服务器上安装 pgAdmin4 服务器模式。你已经通过官方 PostgreSQL 仓库安装并配置了 PostgreSQL 服务器，并安装了以 Apache 作为反向代理的 pgAdmin4。你还学习了如何从 pgAdmin4 仪表板连接到 PostgreSQL 服务器。

相关链接
我的博客：https://blog.ivwv.site