如何在Ubuntu上部署pgAdmin - 问答

如何在Ubuntu上部署pgAdmin

1. 准备工作：更新系统并安装依赖

在开始部署前，确保系统软件包为最新状态，并安装必要的依赖项：

sudo apt update && sudo apt upgrade -y
sudo apt install curl gnupg2 software-properties-common -y

2. 添加pgAdmin官方APT存储库

pgAdmin需通过其官方存储库安装，以确保获取最新版本：

# 导入pgAdmin的GPG公钥（用于验证软件包完整性）
curl -fsS https://www.pgadmin.org/static/packages_pgadmin_org.pub | sudo gpg --dearmor -o /usr/share/keyrings/packages-pgadmin-org.gpg

# 创建存储库配置文件（自动适配Ubuntu版本，如22.04、24.04）
sudo sh -c 'echo "deb [signed-by=/usr/share/keyrings/packages-pgadmin-org.gpg] https://ftp.postgresql.org/pub/pgadmin/pgadmin4/apt/$(lsb_release -cs) pgadmin4 main" > /etc/apt/sources.list.d/pgadmin4.list'

# 更新软件包列表以包含pgAdmin存储库
sudo apt update

3. 安装pgAdmin4

通过APT包管理器安装pgAdmin4（支持Web模式，适合远程访问）：

sudo apt install pgadmin4 -y

4. 配置pgAdmin Web界面

安装完成后，需通过脚本创建管理员账号并配置Web服务：

# 运行配置脚本，按提示输入邮箱（用于登录）和密码（需牢记）
sudo /usr/pgadmin4/bin/setup-web.sh

脚本执行后，会自动重启Apache服务（Ubuntu默认Web服务器），无需手动操作。

5. 访问pgAdmin Web界面

在浏览器中输入以下地址（将IP-Address-of-Your-System替换为服务器IP或localhost，若为本地测试）：

http://IP-Address-of-Your-System/pgadmin4

使用步骤4中设置的邮箱和密码登录，即可进入pgAdmin管理界面。

6. （可选）配置PostgreSQL远程访问（若需跨服务器连接）

若需从其他计算机连接PostgreSQL数据库，需修改PostgreSQL配置文件：

# 编辑PostgreSQL主配置文件，允许监听所有IP地址
sudo nano /etc/postgresql/<version>/main/postgresql.conf  # 将<version>替换为PostgreSQL版本（如15）
# 找到"listen_addresses = 'localhost'"，修改为：
listen_addresses = '*'

# 编辑客户端认证文件，允许远程连接（需设置密码）
sudo nano /etc/postgresql/<version>/main/pg_hba.conf
# 在文件末尾添加：
host all all 0.0.0.0/0 md5

# 重启PostgreSQL服务使配置生效
sudo systemctl restart postgresql

7. （可选）通过pgAdmin连接PostgreSQL数据库

登录pgAdmin后，右键点击左侧Servers节点，选择Create → Server…，填写以下信息：

General标签：输入服务器名称（如MyPostgreSQL）；
Connection标签：
- 主机名：localhost（本地数据库）或服务器IP（远程数据库）；
- 端口：5432（PostgreSQL默认端口）；
- 用户名：postgres（默认超级用户）；
- 密码：PostgreSQL用户的密码（若未设置，可通过sudo -u postgres psql -c "ALTER USER postgres WITH PASSWORD 'your_password';"修改）。
  点击Save，即可连接并管理PostgreSQL数据库。

常见问题排查

无法访问Web界面：检查防火墙是否允许HTTP端口（默认80）或HTTPS端口（默认443），如使用ufw可运行sudo ufw allow 80/tcp；
登录失败：确认步骤4中设置的邮箱和密码正确，或尝试重置密码（需重新运行setup-web.sh）；
PostgreSQL连接拒绝：确保PostgreSQL服务已启动（sudo systemctl status postgresql），且配置文件修改正确。

0 赞

0 踩