postgresqlhepgadmin4

### 关于 PostgreSQL 和 pgAdmin 4 的安装与使用指南

#### 安装 PostgreSQL 数据库服务器

为了确保兼容性和稳定性，在 Docker 中部署 PostgreSQL 应选择特定版本而非最新的默认标签。对于某些应用环境来说，比如 SonarQube 配置需求，推荐使用的 PostgresSQL 版本为11[^2]。

sudo docker pull postgres:11

启动容器时可以设置持久化存储路径以及必要的端口映射：

sudo docker run --name some-postgres -e POSTGRES_PASSWORD=mysecretpassword -d -p 5432:5432 postgres:11

这里 `-e` 参数用于定义环境变量来设定初始密码；而 `-p` 则指定了主机到容器内部服务之间的端口转发关系。

#### 安装并运行 pgAdmin 4 Web UI

pgAdmin 是一款强大的图形界面工具，适用于管理和监控多个 PostgreSQL 实例。同样可以通过官方镜像快速搭建起基于浏览器访问的服务实例。

获取最新版的 pgAdmin 4 Docker 映像文件：

sudo docker pull dpage/pgadmin4

创建一个新的容器，并将其连接至已存在的 PostgreSQL 网络中以便两者能够相互通信：

sudo docker network create mynet
sudo docker run -p 80:80 \
    -e 'PGADMIN_DEFAULT_EMAIL=user@domain.com' \
    -e 'PGADMIN_DEFAULT_PASSWORD=admin' \
    --network=mynet \
    --name=pgadmin4 \
    -d dpage/pgadmin4

上述命令设置了管理员账户信息，默认邮箱地址和登录密码可以根据实际情况调整。通过 `--network` 参数让两个不同容器间实现网络层面的安全交互。

#### 使用 pgAdmin 连接远程或本地 PostgreSQL Server

打开网页浏览器输入 http://localhost 即可进入 pgAdmin 登录页面。首次登陆后建议修改默认账号凭证以增强安全性。之后点击左侧菜单栏中的 "Add New Server" 来新增目标数据库链接配置项，填写相应的 IP 地址/域名、端口号（通常是5432）、认证方式等必要参数完成注册过程即可开始操作管理任务了。