如何在Docker容器外使用PostgreSQL服务执行psql、pg_dump操作？

启动PostgreSQL服务器容器后，希望直接在本地终端利用该容器执行pg_dump等数据库导出操作，无需通过docker exec进入容器。但本地终端执行psql时提示zsh: command not found: psql，询问能否通过端口映射实现该需求，以及具体操作方法。

操作尝试记录 #

• 拉取并运行最新PostgreSQL镜像

  docker run --name postgresqldb -e POSTGRES_PASSWORD=postgres -e POSTGRES_USER=postgres -e POSTGRES_HOST_AUTH_METHOD=password -p 5432:5432 -d postgres
  

• 尝试使用psql

  ➜ git:(development) ✗ psql
  zsh: command not found: psql
  

解决方案 #

方法一：不安装本地客户端，用Docker临时容器执行命令 #

端口映射仅实现本地与容器数据库的网络连通，本地没有psql/pg_dump工具的话无法直接调用。可以通过启动临时PostgreSQL容器，利用容器内的客户端工具连接已运行的数据库容器，操作完成后自动销毁临时容器：

• 执行psql连接数据库：

  docker run --rm -it postgres psql -h host.docker.internal -U postgres -d postgres
  

  输入密码postgres即可进入交互界面，其中--rm确保容器退出后自动删除，host.docker.internal是Docker内置的宿主机别名，用于容器访问宿主机映射的端口。

• 执行pg_dump导出数据库到本地：

  docker run --rm -v $(pwd):/backup postgres pg_dump -h host.docker.internal -U postgres -d postgres > ./backup/dump.sql
  

  -v $(pwd):/backup将本地当前目录挂载到临时容器的/backup目录，导出的dump.sql会直接保存在本地当前目录。

方法二：安装本地PostgreSQL客户端工具 #

如果希望直接在本地终端使用psql/pg_dump，只需安装客户端组件（无需完整服务器）：

• macOS（Homebrew）：

  brew install libpq
  echo 'export PATH="/usr/local/opt/libpq/bin:$PATH"' >> ~/.zshrc
  source ~/.zshrc
  

• Debian/Ubuntu：

  sudo apt update
  sudo apt install postgresql-client
  

• Windows（Chocolatey）：

  choco install postgresql-client
  

安装完成后，直接通过端口映射连接容器数据库：

psql -h localhost -U postgres -d postgres

输入密码postgres即可操作，导出命令示例：

pg_dump -h localhost -U postgres -d postgres > dump.sql

内容的提问来源于stack exchange，提问作者Thomas