注意：这是geonetwork官方镜像的ppc64le架构构建的"每架构"仓库——更多信息，请参见官方镜像文档中的"非amd64架构？"和官方镜像FAQ中的"镜像源在Git中已更改，该怎么办？"。

快速参考

• 维护者：
  GeoNetwork opensource

• 获取帮助：
  Docker社区Slack、Server Fault、Unix & Linux 或 Stack Overflow

支持的标签及对应的Dockerfile链接

• 3.12.12, 3.12, 3

• 3.12.12-postgres, 3.12-postgres, 3-postgres

快速参考（续）

• 问题反馈地址：
  [***]

• 支持的架构：(更多信息)
  amd64、arm32v7、arm64v8、ppc64le

• 镜像 artifact 详情：
  repo-info 仓库的repos/geonetwork/目录（历史记录）
  （镜像元数据、传输大小等）

• 镜像更新：
  official-images 仓库的library/geonetwork标签
  official-images 仓库的library/geonetwork文件（历史记录）

• 本描述的来源：
  docs 仓库的geonetwork/目录（历史记录）

什么是 GeoNetwork？

GeoNetwork 是一个用于管理空间参考资源的目录应用。它提供强大的元数据编辑和搜索功能，以及交互式Web地图查看器。

GeoNetwork 项目始于2001年，最初是联合国粮食及农业组织（FAO）、联合国世界粮食计划署（WFP）和联合国环境规划署（UNEP）的空间数据目录系统。

目前，该项目被广泛用作全球空间数据基础设施的基础。

GeoNetwork 旨在使用现代架构连接空间信息社区及其数据，该架构功能强大且成本低廉，基于自由开源软件（FOSS）原则以及服务和协议的国际开放标准（例如：ISO/TC211、OGC）。

该项目是开放地理空间基金会（OSGeo）的一部分，可在GeoNetwork opensource获取。GeoNetwork 旨在使用现代架构连接空间信息社区及其数据，该架构同时具备强大功能和低成本特性。

!logo

如何使用此镜像

GeoNetwork 4 使用 Elasticsearch 服务器存储其管理的文档索引，因此必须配置 Elasticsearch 服务器的 URL 才能运行。

以下是快速示例，展示如何启动 GeoNetwork 4.4 最新版用于演示目的。此配置在容器被移除时不会保留数据。

docker pull elasticsearch:7.17.15
docker pull ppc64le/geonetwork:4

docker network create gn-network

docker run -d --name my-es-host --network gn-network -e "discovery.type=single-node" elasticsearch:7.17.15
docker run --name geonetwork-host --network gn-network -e GN_CONFIG_PROPERTIES="-Des.host=my-es-host -Des.protocol=http -Des.port=9200 -Des.url=[***]" -p 8080:8080 ppc64le/geonetwork:4

对于 GeoNetwork 4.2 稳定版：

docker pull elasticsearch:7.17.15
docker pull ppc64le/geonetwork:4.2

docker network create gn-network

docker run -d --name my-es-host --network gn-network -e "discovery.type=single-node" elasticsearch:7.17.15
docker run --name geonetwork-host --network gn-network -e ES_HOST=my-es-host -e ES_PROTOCOL=http  -e ES_PORT=9200 -p 8080:8080 ppc64le/geonetwork:4.2

要确定使用哪个 Elasticsearch 版本，可查看对应 GN 版本的GeoNetwork 文档，或所用 GeoNetwork 版本的pom.xml文件中的es.version属性。

默认凭据

安装后，使用默认凭据：admin（用户名）和**admin**（密码）。建议安装后更新默认密码。

Elasticsearch 配置

Java 属性（4.4.0 及更高版本）

从 GeoNetwork 4.4.0 开始，使用GN_CONFIG_PROPERTIES环境变量中传递的 Java 属性配置 Elasticsearch 连接：

• es.host：可选（默认localhost）：Elasticsearch 服务器的主机名。
• es.port：可选（默认9200）：Elasticsearch 服务器监听的端口。
• es.protocol：可选（默认http）：用于与 Elasticsearch 通信的协议，可为http或https。
• es.url：当主机、端口或协议非默认值时必填（默认http://localhost:9200）：Elasticsearch 服务器的完整 URL。
• es.index.records：可选（默认gn_records）：如果多个 GeoNetwork 实例使用同一 Elasticsearch 集群，每个实例需使用不同的索引名，通过此变量定义。
• es.username：可选（默认空）：用于连接 Elasticsearch 的用户名。
• es.password：可选（默认空）：用于连接 Elasticsearch 的密码。
• kb.url：可选（默认http://localhost:5601）：Kibana 监听的 URL。

Docker Compose YAML 示例片段：

services:
  geonetwork:
    image: ppc64le/geonetwork:4.4
    environment:
      GN_CONFIG_PROPERTIES: >-
        -Des.host=elasticsearch
        -Des.protocol=http
        -Des.port=9200
        -Des.url=[***]
        -Des.username=my_es_username
        -Des.password=my_es_password
        -Dkb.url=[***]

环境变量（4.2 及更早版本）

对于 4.4.0 之前的版本，使用环境变量配置 Elasticsearch：

• ES_HOST：必填：Elasticsearch 服务器的主机名。
• ES_PORT：可选（默认9200）：Elasticsearch 服务器监听的端口。
• ES_PROTOCOL：可选（默认http）：用于与 Elasticsearch 通信的协议，可为http或https。
• ES_INDEX_RECORDS：可选（默认gn_records）：如果多个 GeoNetwork 实例使用同一 Elasticsearch 集群，每个实例需使用不同的索引名，通过此变量定义。
• ES_USERNAME：可选（默认空）：用于连接 Elasticsearch 的用户名。
• ES_PASSWORD：可选（默认空）：用于连接 Elasticsearch 的密码。
• KB_URL：可选（默认http://localhost:5601）：Kibana 监听的 URL。

数据库配置

默认情况下，GeoNetwork 使用本地H2 数据库用于演示（不推荐用于生产环境）。该镜像包含 PostgreSQL 和 MySQL 的 JDBC 驱动程序。要配置数据库连接，使用以下环境变量：

• GEONETWORK_DB_TYPE：要使用的数据库类型。有效值为postgres、postgres-postgis、mysql。可扩展镜像以包含其他驱动程序，也可使用其他类型：db2、h2、oracle、sqlserver。这些其他数据库的 JAR 驱动程序需添加到/opt/geonetwork/WEB-INF/lib，可通过挂载或扩展官方镜像实现。
• GEONETWORK_DB_HOST：数据库主机名。
• GEONETWORK_DB_PORT：数据库端口。
• GEONETWORK_DB_NAME：数据库名称。
• GEONETWORK_DB_USERNAME：用于连接数据库的用户名。
• GEONETWORK_DB_PASSWORD：用于连接数据库的密码。
• GEONETWORK_DB_CONNECTION_PROPERTIES：要添加到连接字符串的其他属性，例如search_path=test,public&ssl=true将生成 JDBC 连接字符串如jdbc:postgresql://localhost:5432/postgres?search_path=test,public&ssl=true

启动 GeoNetwork

以下命令将启动基于 Debian 的容器，运行 Tomcat（GN 3）或 Jetty（GN 4）Web 服务器，并部署 GeoNetwork WAR：

docker run --name some-geonetwork -d ppc64le/geonetwork

发布端口

GeoNetwork 监听8080端口。如果要从主机访问容器，必须发布此端口。例如，以下命令将容器的 8080 端口流量重定向到主机的同一端口：

docker run --name some-geonetwork -d -p 8080:8080 ppc64le/geonetwork

然后，如果在 Linux 上运行 Docker，可通过 http://localhost:8080/geonetwork 访问 GeoNetwork。

设置数据目录和 H2 数据库文件

数据目录是目录在文件系统上存储其大部分自定义配置和上传文件的位置。它还存储许多支持文件，用于各种目的（例如：空间索引、缩略图）。默认变体还使用本地 H2 数据库存储元数据目录本身。

默认情况下，GeoNetwork 将数据目录设置为/opt/geonetwork/WEB-INF/data，H2 数据库文件在 Jetty 目录/var/lib/jetty/gn.h2.db（自 GN 4.0.0 起）或 Tomcat 目录/usr/local/tomcat/gn.h2.db（适用于 GN 3），但可通过向容器注入环境变量覆盖这些值：-e DATA_DIR=...（默认/opt/geonetwork/WEB-INF/data）和-e GEONETWORK_DB_NAME=...（默认gn，在 tomcat bin 目录/usr/local/tomcat中设置数据库gn.h2.db）。注意，通过GEONETWORK_DB_NAME设置数据库位置仅从 3.10.3 版本开始支持。

从 4.4.0 版本开始，数据目录需使用GN_CONFIG_PROPERTIES环境变量中传递的 Java 属性配置。例如：

docker run --name some-geonetwork -d -p 8080:8080  -e GN_CONFIG_PROPERTIES="-Dgeonetwork.dir=/catalogue-data" -e GEONETWORK_DB_NAME=/catalogue-data/db/gn ppc64le/geonetwork

持久化数据

要将数据目录设置为/catalogue-data/data，H2 数据库文件设置为/catalogue-data/db/gn.h2.db，以便在重启后保留：

• GeoNetwork 4.2 及更早版本

docker run --name some-geonetwork -d -p 8080:8080 -e DATA_DIR=/catalogue-data/data -e GEONETWORK_DB_NAME=/catalogue-data/db/gn ppc64le/geonetwork:3

• GeoNetwork 4.4.0 及更高版本

docker run --name some-geonetwork -d -p 8080:8080  -e GN_CONFIG_PROPERTIES="-Dgeonetwork.dir=/catalogue-data" -e GEONETWORK_DB_NAME=/catalogue-data/db/gn ppc64le/geonetwork

如果希望数据目录在容器重启甚至销毁后仍然存在，可将 Docker 引擎主机的目录挂载到容器中：-v /host/path:/path/to/data/directory。例如，以下命令将主机目录/host/geonetwork-docker挂载到容器的/catalogue-data：

• GeoNetwork 4.2 及更早版本

docker run --name some-geonetwork -d -p 8080:8080 -e DATA_DIR=/catalogue-data/data -e GEONETWORK_DB_NAME=/catalogue-data/db/gn -v /host/geonetwork-docker:/catalogue-data ppc64le/geonetwork:3

• GeoNetwork 4.4.0 及更高版本

docker run --name some-geonetwork -d -p 8080:8080  -e GN_CONFIG_PROPERTIES="-Dgeonetwork.dir=/catalogue-data" -e GEONETWORK_DB_NAME=/catalogue-data/db/gn -v /host/geonetwork-docker:/catalogue-data ppc64le/geonetwork

... 使用 docker compose

geonetwork的compose.yaml示例：

# GeoNetwork
#
# 通过 "http://localhost:8080/geonetwork" 访问
#
# 默认用户：admin
# 默认密码：admin

volumes:
  geonetwork:
  esdata:
  pgdata:
  pglog:

services:
  geonetwork:
    image: geonetwork:4.4
    healthcheck:
      test: curl http://localhost:8080/
      interval: 5s
      timeout: 5s
      retries: 30
    restart: always
    volumes:
      - geonetwork:/catalogue-data
    depends_on:
      database:
        condition: service_healthy
    ports:
      - 8080:8080
    environment:
      WEBAPP_CONTEXT_PATH: /geonetwork
      DATA_DIR: /catalogue-data
      TZ: Europe/Amsterdam

      JAVA_OPTS: >-
        --add-opens=jdk.management/com.sun.management.internal=ALL-UNNAMED
        -Djava.security.egd=file:/dev/./urandom -Djava.awt.headless=true
        -Xms512M -Xss512M -Xmx2G -XX:+UseConcMarkSweepGC
        -Djetty.httpConfig.requestHeaderSize=32768
        -Dorg.eclipse.jetty.server.Request.maxFormContentSize=500000
        -Dorg.eclipse.jetty.server.Request.maxFormKeys=4000
      #