确保 Docker 已安装并处于运行状态且默认使用 Linux 容器模式绝大多数场景都适用。可以在 PowerShell 中用docker --version验证。在 PowerShell 中执行以下命令。这个命令同时设置了端口映射、密码和数据持久化避免重启后数据丢失。步骤1. 运行 PostgreSQL 容器先拉取镜像docker pull postgresdockerrun-d--namemy-postgres-p5432:5432-ePOSTGRES_PASSWORD123456-ePOSTGRES_USERuser-ePOSTGRES_DBmydb-vpostgres-data:/var/lib/postgresql postgres这里POSTGRES_USER设置成了userPOSTGRES_PASSWORD设置成了123456可以更改。-p 5432:5432把宿主机的 5432 端口映射到容器的 5432 端口这是 pgAdmin 能连上的前提。-e POSTGRES_PASSWORD必须设置否则容器无法正常初始化。请将 your_secure_password 替换成你自己的强密码。-e POSTGRES_USER / POSTGRES_DB可选用于自定义默认用户和数据库不设则用户默认为 postgres。-vpostgres-data:…使用命名卷持久化数据即使容器被删除数据卷中的内容依然保留。用docker ps确认容器状态为 Up再通过日志验证服务是否就绪docker logs my-postgres当看到 database system is ready to accept connections 时说明 PostgreSQL 已完全启动可以连接了。步骤2. 在容器内部用 psql 验证在动pgAdmin之前先在 Docker 容器内部做一次连接测试可以排除“是网络问题还是数据库本身有问题”。dockerexec-itmy-postgres psql-Uuser-d mydb-cSELECT version();这条命令会直接在容器内用 psql 连接你创建的 mydb 数据库并输出 PostgreSQL 版本信息。如果能看到版本号说明数据库本身完全正常后续 pgAdmin 连不上就纯粹是网络配置问题了。也可以进入交互式 psql 终端dockerexec-itmy-postgres psql-Uuser-dmydb进去后可以执行\l查看数据库列表\q退出步骤3. 运行pgAdmin拉取镜像docker pull dpage/pgadmin4运行 pgAdmin 容器dockerrun-d--namemy-pgadmin-p5050:80-ePGADMIN_DEFAULT_EMAILadminexample.com-ePGADMIN_DEFAULT_PASSWORDadmin123 dpage/pgadmin4-p 5050:80将容器内部的 80 端口映射到宿主机的 5050 端口。这是你浏览器要访问的端口。PGADMIN_DEFAULT_EMAIL / PGADMIN_DEFAULT_PASSWORD这是 pgAdmin 的登录邮箱和密码需要自己设定。如果不设置部分镜像会使用默认值如 pgadmin4pgadmin.org / admin但为了安全建议显式指定。打开网址http://localhost:5050/login登录刚才运行时的账户和密码成功进入 pgAdmin 界面后就可以连接你之前启动的 PostgreSQL 容器了。右键 Servers → Register → Server先填写名称在Connection标签页中填写验证建表与数据持久化打开 Query Tool把下面这段测试代码复制粘贴到右侧空白的 SQL 编辑器里并运行CREATE TABLEusers(idSERIAL PRIMARY KEY, name VARCHAR(100)NOT NULL, email VARCHAR(255)UNIQUE NOT NULL, created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP);INSERT INTOusers(name, email)VALUES(张三,zhangsanexample.com),(李四,lisiexample.com),(王五,wangwuexample.com);SELECT * FROMusers;docker验证建表结果docker exec -it my-postgres psql -U user -d mydb -c \dt持久化Persistence简单来说就是数据不会因为容器的删除或重启而丢失。在 Docker 的世界里容器本身是“用完即弃”的。如果不做特殊处理你把容器删了里面的数据也就跟着灰飞烟灭了。前面启动postgres时已经用了命名卷 postgres-data可以做个快速测试删除容器再重建数据应该还在。删除容器dockerrm-fmy-postgres重新启动一个容器dockerrun-d--namemy-postgres-p5432:5432-ePOSTGRES_PASSWORD123456-ePOSTGRES_USERuser-ePOSTGRES_DBmydb-vpostgres-data:/var/lib/postgresql postgres查表dockerexec-itmy-postgres psql-Uuser-dmydb-cSELECT * FROM users;
