PostGIS Docker容器中shp2pgsql命令缺失问题排查

问题根源 #

你使用的官方postgis/postgis:13-3.4镜像默认未预装shp2pgsql工具——这个工具属于PostGIS的辅助工具集，并非核心镜像的必装组件，所以/usr/bin目录下找不到该命令。

解决方案 #

以下是三种可行的解决方式：

• 临时解决：进入容器直接安装工具

  1. 进入运行中的PostGIS容器：

     docker exec -it <你的容器ID/名称> bash
     

  2. 更新系统源并安装工具包：

     apt update && apt install -y postgis-gui
     

     （针对PostgreSQL 13版本，也可安装postgresql-13-postgis-3-utils包，效果一致）
  3. 安装完成后，即可在容器内执行你的shp2pgsql命令。

• 长期方案：自定义构建带工具的镜像
  如果需要反复使用带shp2pgsql的镜像，可编写Dockerfile构建自定义镜像：

  FROM postgis/postgis:13-3.4
  RUN apt update && \
      apt install -y postgis-gui && \
      rm -rf /var/lib/apt/lists/* # 清理缓存减小镜像体积
  

  执行构建命令：

  docker build -t my-postgis:13-3.4 .
  

  后续用这个自定义镜像启动容器，就自带shp2pgsql工具。

• 替代方案：宿主机安装工具直接连接容器数据库
  不在容器内操作，直接在宿主机安装shp2pgsql：

  1. 宿主机安装PostGIS工具包（以Ubuntu为例）：

     apt install -y postgis
     

  2. 直接通过宿主机连接容器内的PostgreSQL，执行导入：

     shp2pgsql -D -I -s 26918 /tmp/nyc_census_blocks_2000.shp nyc_census_blocks_2000 | psql -h localhost -U <数据库用户名> -d <目标数据库名>
     

  注意：需确保容器的PostgreSQL端口（默认5432）已映射到宿主机。

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