# Docker 部署 pgAdmin4 完整命令（银河麒麟通用，含持久化、自启动） ## 一、一键单条 docker run（推荐，快速部署） ### 1. 先拉取镜像 ```bash docker pull dpage/pgadmin4:latest ``` ### 2. 启动容器（带持久卷、开机自启） ```bash docker run -d \ --name pgadmin4 \ --restart unless-stopped \ -p 5050:80 \ -e PGADMIN_DEFAULT_EMAIL=admin@local.com \ -e PGADMIN_DEFAULT_PASSWORD=Pg@123456 \ -e PGADMIN_DISABLE_POSTFIX=true \ -v pgadmin-data:/var/lib/pgadmin \ dpage/pgadmin4:latest ``` ### 参数说明 1. `-d` 后台运行 2. `--name pgadmin4` 容器名 3. `--restart unless-stopped` 服务器重启自动拉起 4. `-p 5050:80` 宿主机5050访问pgadmin网页 5. `PGADMIN_DEFAULT_EMAIL` 登录用户名（必须邮箱格式） 6. `PGADMIN_DEFAULT_PASSWORD` 登录密码（自定义强密码） 7. `PGADMIN_DISABLE_POSTFIX=true` 关闭内置邮件服务，减少资源占用 8. `-v pgadmin-data:/var/lib/pgadmin` 命名卷持久化：保存连接配置、布局，删容器不丢配置 ### 3. 宿主机目录挂载（替代命名卷，适合麒麟固定路径） ```bash # 先创建存储目录 mkdir -p /data/pgadmin4 && chmod 777 /data/pgadmin4 docker run -d \ --name pgadmin4 \ --restart unless-stopped \ -p 5050:80 \ -e PGADMIN_DEFAULT_EMAIL=admin@local.com \ -e PGADMIN_DEFAULT_PASSWORD=Pg@123456 \ -e PGADMIN_DISABLE_POSTFIX=true \ -v /data/pgadmin4:/var/lib/pgadmin \ dpage/pgadmin4:latest ``` ## 二、docker-compose 方式（生产/长期维护推荐） ### 1. 创建部署目录 ```bash mkdir -p /opt/pgadmin && cd /opt/pgadmin ``` ### 2. 编写 docker-compose.yml ```yaml version: "3.8" services: pgadmin: image: dpage/pgadmin4:latest container_name: pgadmin4 restart: unless-stopped ports: - "5050:80" environment: PGADMIN_DEFAULT_EMAIL: admin@local.com PGADMIN_DEFAULT_PASSWORD: Pg@123456 PGADMIN_DISABLE_POSTFIX: "true" volumes: - pgadmin-data:/var/lib/pgadmin volumes: pgadmin-data: ``` ### 3. 启动/停止/重启 ```bash # 后台启动 docker compose up -d # 停止 docker compose down # 重启 docker compose restart ``` ## 三、银河麒麟防火墙放行端口 ```bash # firewalld 系统 firewall-cmd --add-port=5050/tcp --permanent firewall-cmd --reload # 若用ufw ufw allow 5050/tcp ``` ## 四、常用管理命令 ```bash # 查看运行状态 docker ps | grep pgadmin4 # 查看日志（排查启动失败） docker logs -f pgadmin4 # 进入容器内部 docker exec -it pgadmin4 /bin/bash # 删除容器（配置卷保留） docker rm -f pgadmin4 # 彻底删除容器+持久数据卷 docker rm -f pgadmin4 && docker volume rm pgadmin-data ``` ## 五、访问方式 浏览器打开：`http://服务器IP:5050` 登录账号：`admin@local.com` 密码：`Pg@123456` ## 六、麒麟ARM飞腾/鲲鹏适配说明 官方 `dpage/pgadmin4` 镜像支持amd64/arm64多架构，银河麒麟ARM服务器直接拉取即可，无需额外修改； 如拉取慢，可替换国内镜像源加速拉取。 ## 七、配套PostgreSQL容器互通（同网络） 如果PG也在Docker内，给pgadmin和postgres加入同一网桥网络，连接地址填postgres容器名即可，无需暴露5432到宿主机： ```bash # 创建共享网络 docker network create pg-net # 启动postgres时加 --network pg-net # pgadmin run 命令增加 --network pg-net ```