juank/postgis

juank/postgis

https://github.com/submarcos/docker-postgis/workflows/Docker%20PostGIS%20CI/badge.svg](https://github.com/submarcos/docker-postgis/actions)

juank/postgis镜像提供了运行已安装PostGIS扩展的Postgres的标签。该镜像基于官方https://registry.hub.docker.com/_/postgres/%E9%95%9C%E5%83%8F%EF%BC%8C%E6%8F%90%E4%BE%9B%E9%80%82%E7%94%A8%E4%BA%8EPostGIS 3.4.x的debian和alpine变体，兼容PostgreSQL 12、13、14、15和16版本。此外，还提供基于最新两个Postgres版本（15、16）构建的镜像版本，其中PostGIS及其依赖项从各自的master分支构建。

此镜像确保父postgres镜像创建的默认数据库将安装以下扩展：

除非在启动容器时传递-e POSTGRES_DB，否则此数据库将以管理员用户命名（postgres或通过-e POSTGRES_USER指定的用户）。如果希望使用旧的模板数据库机制启用PostGIS，镜像还提供名为template_postgis的PostGIS启用模板数据库。

版本（2024-02-17）

支持的架构：amd64（也称为X86-64）

新用户推荐版本：postgis/postgis:16-3.4

Debian 基础版（推荐）

• 此Docker-PostGIS版本采用谨慎的发布周期以保证高稳定性。
  • "谨慎"意味着它并不总是包含最新版本的geos、proj、gdal和sfcgal包。
• 我们使用Debian仓库中的PostGIS、geos、proj、gdal和sfcgal包。
  • 在Debian Bullseye仓库中，版本为：geos=3.9、gdal=3.2、proj=7.2、sfcgal=1.3.9。
• 此版本易于扩展，且经过长期完善。

Alpine 基础版

• 基础操作系统 = Alpine Linux：设计为小巧、简单且安全；基于musl libc
• alpine:3.17；geos=3.11；gdal=3.5；proj=9.1
• PostGIS从源代码编译；较难扩展
• 尚不支持SFCGAL；（postgis_sfcgal无法正常工作）

测试镜像

• 我们提供alpha、beta、发布候选版（rc）和开发版（标识为~master）。
• *-master镜像的模板需手动更新，有时可能会延迟几周。
• ~master版本的SFCGAL版本为1.5或更高。cgal版本锁定在https://github.com/CGAL/cgal/tree/5.6.x-branch%E3%80%82

使用方法

要运行一个能够提供PostGIS启用数据库的基本容器，可按以下方式启动容器：

bash
docker run --name some-postgis -e POSTGRES_PASSWORD=mysecretpassword -d postgis/postgis

有关如何启动和控制Postgres容器的更多详细说明，请参见postgres镜像的文档https://registry.hub.docker.com/_/postgres/%E3%80%82

启动数据库容器后，可直接在运行的容器上连接数据库：

bash
docker exec -ti some-postgis psql -U postgres

或者启动新容器作为客户端。此时可使用用户定义网络链接两个容器：

bash
docker network create some-network

# 服务器容器
docker run --name some-postgis --network some-network -e POSTGRES_PASSWORD=mysecretpassword -d postgis/postgis

# 客户端容器
docker run -it --rm --network some-network postgis/postgis psql -h some-postgis -U postgres

有关连接不同容器的更多详细信息和替代方法，请查看https://registry.hub.docker.com/_/postgres/%E6%96%87%E6%A1%A3%E5%92%8CDocker%E7%BD%91%E7%BB%9C%E6%96%87%E6%A1%A3%E3%80%82

有关创建和使用空间启用数据库的更多选项，请参见PostGIS文档。

支持的环境变量

由于docker-postgis仓库是官方Docker PostgreSQL仓库的扩展，因此所有在官方仓库支持的环境变量在此也受支持：

• POSTGRES_PASSWORD
• POSTGRES_USER
• POSTGRES_DB
• POSTGRES_INITDB_ARGS
• POSTGRES_INITDB_WALDIR
• POSTGRES_HOST_AUTH_METHOD
• PGDATA

了解更多：https://github.com/docker-library/docs/blob/master/postgres/README.md

警告：只有当您使用空数据目录启动容器时，Docker特定变量才会生效； 容器启动时任何预先存在的数据库都将保持不变。

需要注意的是，Docker镜像的环境变量与libpq — C库的环境变量（PGDATABASE、PGUSER、PGPASSWORD）不同。

故障排除提示

故障排除通常具有挑战性。重要的是要知道docker-postgis仓库是官方Docker PostgreSQL仓库的扩展。因此，如果遇到任何问题，建议测试是否可以使用https://hub.docker.com/_/postgres%E9%87%8D%E7%8E%B0%E9%97%AE%E9%A2%98%E3%80%82%E5%A6%82%E6%9E%9C%E5%8F%AF%E4%BB%A5%EF%BC%8C%E5%BB%BA%E8%AE%AE%E5%9F%BA%E4%BA%8E%E6%AD%A4%E6%90%9C%E7%B4%A2%E8%A7%A3%E5%86%B3%E6%96%B9%E6%A1%88%E3%80%82%E6%8E%A8%E8%8D%90%E4%BB%A5%E4%B8%8B%E7%BD%91%E7%AB%99%EF%BC%9A

• 上游docker postgres仓库：https://github.com/docker-library/postgres
  • 搜索开放或已关闭的问题！
• Docker社区论坛：[***]
• Docker社区Slack：[***]
• Stack Overflow：[***]

如果问题与PostGIS相关：

• Stack Overflow：docker + postgis [***]
• Postgis问题跟踪器：[***]

如果您没有postgres docker使用经验，建议阅读此博客文章：

• [***]

安全性

必须注意，在云环境中，使用默认设置时，这些镜像易受***，如果端口开放，极有可能被加密货币挖矿程序感染（https://github.com/docker-library/postgres/issues/770#issuecomment-704460980%EF%BC%89%E3%80%82

• 注意，未绑定到主机的端口（即-p 5432:5432而非-p 127.0.0.1:5432:5432）将可从外部访问。即使您配置UFW阻止此特定端口，Docker也会管理自己的iptables规则（阅读更多）。

建议

• 可添加使用SSL的选项（https://github.com/docker-library/postgres/issues/989#issuecomment-***%EF%BC%89
  • -c ssl=on -c ssl_cert_file=/var/lib/postgresql/server.crt -c ssl_key_file=/var/lib/postgresql/server.key
• 或使用SSH隧道并指定-p 127.0.0.1:5432:5432

安全扫描信息

• 还请扫描基础postgres docker镜像： 扫描基础postgres Docker镜像以查找潜在安全问题也很重要。如果您的安全扫描器报告镜像中存在漏洞（称为CVE），您可能想知道原因。为更好地理解，请阅读Docker Library常见问题，特别是标题为https://github.com/docker-library/faq#why-does-my-security-scanner-show-that-an-image-has-cves%E7%9A%84%E9%83%A8%E5%88%86%E3%80%82 有关postgres docker镜像的更多特定问题，可使用以下链接搜索：

  • https://github.com/search?q=repo%3Adocker-library%2Fpostgres+trivy&type=issues
  • https://github.com/search?q=repo%3Adocker-library%2Fpostgres+CVE&type=issues

• 优化安全扫描： 建议专注于扫描和修复可解决的问题。 使用以下命令仅扫描可修复的问题：

  • trivy image --ignore-unfixed postgis/postgis:16-3.4-alpine
  • trivy image --ignore-unfixed postgres:16-alpine 更多详情可阅读此文章：[***]

更新限制

遗憾的是，我们无法控制Debian和Alpine发行版或上游postgres镜像的更新。 因此，可能存在一些我们无法立即修复的问题。 好在postgis/postgis镜像每周一重新生成，以确保包含最新的更改和改进，因此这些镜像始终保持最新。

欢迎建议

我们始终欢迎增强安全性的建议。如有任何想法，请告诉我们。

已知问题/错误

当因PostGIS更新遇到OperationalError: could not access file "$libdir/postgis-X.X错误时，运行：

bash
docker exec some-postgis update-postgis.sh

这将更新到最新的PostGIS版本。更新是幂等的，多次运行不会有问题，您将收到类似以下的通知：

Updating PostGIS extensions template_postgis to X.X.X
NOTICE:  version "X.X.X" of extension "postgis" is already installed
NOTICE:  version "X.X.X" of extension "postgis_raster" is already installed
NOTICE:  version "X.X.X" of extension "postgis_topology" is already installed
NOTICE:  version "X.X.X" of extension "postgis_tiger_geocoder" is already installed
ALTER EXTENSION
Updating PostGIS extensions docker to X.X.X
NOTICE:  version "X.X.X" of extension "postgis" is already installed
NOTICE:  version "X.X.X" of extension "postgis_raster" is already installed
NOTICE:  version "X.X.X" of extension "postgis_topology" is already installed
NOTICE:  version "X.X.X" of extension "postgis_tiger_geocoder" is already installed
ALTER EXTENSION

贡献指南

此Docker-PostGIS项目是PostGIS组的一部分，并遵循更灵活的贡献规则。

• 请在开始前花时间查看当前的问题、讨论和拉取请求。
• 如果您有重大更改的想法，恳请先就此发起讨论。
• 修改模板后，请运行./update.sh脚本。

行为准则

参见：[***]