arm32v7/geonetwork Docker镜像文档

镜像概述与主要用途

注意：本镜像为geonetwork官方镜像的arm32v7架构专用构建版本。有关多架构镜像的更多信息，参见官方镜像文档中的“非amd64架构”说明及官方镜像FAQ中的“镜像源码变更后如何处理”。

GeoNetwork是一个自由开源（FOSS）的空间参考资源目录系统，用于管理空间数据资源。它提供强大的元数据编辑、高级搜索功能及交互式Web地图查看器，基于开放标准（如ISO/TC211、OGC）构建，适用于构建空间数据基础设施（SDI）。该项目最初为联合国粮农组织（FAO）、世界粮食计划署（WFP）和环境规划署（UNEP）开发，目前已在全球范围内广泛应用。

核心功能与特性

• 元数据管理：支持空间数据元数据的创建、编辑、审核和发布，兼容ISO 19115、FGDC等标准。
• 高级搜索：提供基于关键词、空间范围、元数据属性的多条件搜索，支持空间索引。
• 交互式Web地图：集成地图查看器，可预览空间数据资源并进行空间查询。
• 开放标准兼容：遵循ISO/TC211、OGC等国际标准，支持WMS、WFS等服务集成。
• 多架构支持：兼容amd64、arm32v7、arm64v8、ppc64le等多种硬件架构。
• 可扩展数据存储：支持H2（默认，适用于演示）、PostgreSQL/PostGIS、MySQL等数据库。

使用场景与适用范围

• 空间数据基础设施（SDI）：作为核心目录服务，用于政府、区域或全球SDI的构建。
• 环境与自然资源管理：如联合国机构、环保组织用于管理环境监测数据。
• 科研机构：共享地理空间研究数据，促进跨机构协作。
• 企业级地理信息系统（GIS）：整合内部空间数据资源，提供统一检索入口。
• 教育与非营利组织：用于教学、研究或公益项目的空间数据管理。

支持的标签与架构

标签及对应Dockerfile链接

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

支持的架构

• amd64：amd64/geonetwork
• arm32v7：arm32v7/geonetwork（本镜像）
• arm64v8：arm64v8/geonetwork
• ppc64le：ppc64le/geonetwork

快速参考

• 维护者：GeoNetwork opensource
• 获取帮助：Docker社区Slack、Server Fault、Unix & Linux、Stack Overflow
• 问题反馈：GitHub Issues
• 镜像元数据：repo-info仓库的geonetwork目录（包含传输大小、历史记录等）
• 镜像更新：official-images仓库的geonetwork标签、官方镜像配置文件

使用方法与配置说明

基本要求

• Docker Engine 19.03+
• 对于GeoNetwork 4+，需搭配指定版本的Elasticsearch（见下文说明）

默认凭据

初始安装后，默认管理员账号：

• 用户名：admin
• 密码：admin
  建议安装后立即修改默认密码。

快速启动示例

GeoNetwork 4.4及以上版本（需Elasticsearch）

# 拉取Elasticsearch和GeoNetwork镜像
docker pull elasticsearch:7.17.15
docker pull arm32v7/geonetwork:4

# 创建网络
docker network create gn-network

# 启动Elasticsearch（单节点模式）
docker run -d --name my-es-host --network gn-network -e "discovery.type=single-node" elasticsearch:7.17.15

# 启动GeoNetwork，配置Elasticsearch连接
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 \
  arm32v7/geonetwork:4

GeoNetwork 4.2及以下版本（需Elasticsearch）

# 拉取镜像
docker pull elasticsearch:7.17.15
docker pull arm32v7/geonetwork:4.2

# 创建网络
docker network create gn-network

# 启动Elasticsearch
docker run -d --name my-es-host --network gn-network -e "discovery.type=single-node" elasticsearch:7.17.15

# 启动GeoNetwork（环境变量配置Elasticsearch）
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 \
  arm32v7/geonetwork:4.2

Elasticsearch版本说明：需根据GeoNetwork版本选择兼容的Elasticsearch。可参考GeoNetwork官方文档或对应版本的pom.xml中es.version属性。

端口映射

GeoNetwork默认监听容器内8080端口，需通过-p参数映射到主机端口：

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

启动后可通过 http://localhost:8080/geonetwork 访问（Linux环境）。

Elasticsearch配置

4.4.0及以上版本（Java属性配置）

通过GN_CONFIG_PROPERTIES环境变量传递Java属性，配置Elasticsearch连接：

示例（Docker Compose片段）：

services:
  geonetwork:
    image: arm32v7/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及以下版本（环境变量配置）

通过环境变量直接配置Elasticsearch：

数据库配置

默认使用H2数据库（仅适用于演示，不建议生产环境）。支持PostgreSQL/PostGIS、MySQL等，需通过以下环境变量配置：

数据持久化配置

GeoNetwork的数据目录（存储配置、上传文件等）和H2数据库文件默认位于容器内，需挂载到主机目录以持久化数据。

GeoNetwork 4.4及以上版本

通过GN_CONFIG_PROPERTIES配置数据目录，GEONETWORK_DB_NAME配置H2数据库路径：

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-data:/catalogue-data \  # 主机目录挂载
  arm32v7/geonetwork:4

GeoNetwork 4.2及以下版本

通过环境变量DATA_DIR和GEONETWORK_DB_NAME配置：

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-data:/catalogue-data \
  arm32v7/geonetwork:4.2

Docker Compose完整配置示例

以下配置包含GeoNetwork、PostgreSQL/PostGIS、Elasticsearch和Kibana，适用于生产环境：

# 访问地址：http://localhost:8080/geonetwork
# 默认账号：admin/admin

volumes:
  geonetwork:  # GeoNetwork数据卷
  esdata:      # Elasticsearch数据卷
  pgdata:      # PostgreSQL数据卷
  pglog:       # PostgreSQL日志卷

services:
  geonetwork:
    image: arm32v7/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

      # JVM参数配置
      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

      # GeoNetwork配置（Java属性）
      GN_CONFIG_PROPERTIES: >-
        -Dgeonetwork.dir=/catalogue-data
        -Dgeonetwork.formatter.dir=/catalogue-data/data/formatter
        -Dgeonetwork.schema.dir=/opt/geonetwork/WEB-INF/data/config/schema_plugins
        -Dgeonetwork.indexConfig.dir=/opt/geonetwork/WEB-INF/data/config/index
        -Dgeonetwork.schemapublication.dir=/opt/geonetwork/WEB-INF/data/resources/schemapublication
        -Dgeonetwork.htmlcache.dir=/opt/geonetwork/WEB-INF/data/resources/htmlcache
        -Des.host=elasticsearch
        -Des.protocol=http
        -Des.port=9200
        -Des.url=[***]
        -Des.username=
        -Des.password=
        -Dgeonetwork.ESFeaturesProxy.targetUri=[***]{_}
        -Dgeonetwork.HttpDashboardProxy.targetUri=[***]

      # PostgreSQL数据库配置
      GEONETWORK_DB_TYPE: postgres-postgis
      GEONETWORK_DB_HOST: database
      GEONETWORK_DB_PORT: 5432
      GEONETWORK_DB_NAME: geonetwork
      GEONETWORK_DB_USERNAME: geonetwork
      GEONETWORK_DB_PASSWORD: geonetwork

  database:
    image: postgis/postgis:16-3.4
    environment:
      POSTGRES_USER: geonetwork
      POSTGRES_PASSWORD: geonetwork
      POSTGRES_DB: geonetwork
    command: [postgres, -c, log_statement=all, -c, logging_collector=true, -c, log_file_mode=0644, -c, log_directory=/var/log/postgresql, -c, log_filename=postgresql.log]
    healthcheck:
      test: [CMD-SHELL, pg_isready -U postgres]
      interval: 5s
      timeout: 5s
      retries: 5
    volumes:
      - pgdata:/var/lib/postgresql/data
      - pglog:/var/log/postgresql

  elasticsearch:
    image: elasticsearch:7.17.15
    ports:
      - 9200:9200
    ulimits:
      memlock:
        soft: -1
        hard: -1
      nofile:
        soft: 65536
        hard: 65536
    healthcheck:
      test: curl -s http://localhost:9200 >/dev/null || exit 1
      interval: 10s
      timeout: 2s
      retries: 10
      start_period: 2m
    environment:
      ES_JAVA_OPTS: -Xms1G -Xmx1G
      discovery.type: single-node
    volumes:
      - esdata:/usr/share/elasticsearch/data

  kibana:
    image