taccaci/geoapi

地理空间网络服务Docker镜像文档

镜像概述

本Docker镜像专注于提供开箱即用的地理空间网络服务能力，集成了主流地理空间工具链与服务组件，旨在简化地理信息系统（GIS）应用的部署流程。镜像遵循开放地理空间联盟（OGC）标准，支持多种地理数据格式与服务协议，可作为地理空间应用的核心服务节点，满足地图服务、空间分析、数据可视化等场景需求。

核心功能与特性

标准协议支持

• 兼容OGC标准协议：Web地图服务（WMS）、Web要素服务（WFS）、Web覆盖服务（WCS）
• 支持地理空间数据交换格式：GeoJSON、KML、Shapefile、GeoTIFF等
• 集成Tile Map Service（TMS）协议，支持地图瓦片渲染与分发

数据处理能力

• 内置空间数据查询引擎，支持空间关系判断（包含、相交、邻近等）
• 提供基础空间分析功能：缓冲区分析、叠加分析、距离计算
• 支持多源数据接入：PostGIS数据库、空间数据库连接（SDI）、本地文件数据源

服务与接口

• 提供RESTful API接口，支持HTTP/HTTPS协议访问
• 内置地图渲染引擎，支持自定义地图样式（基于Mapbox Style规范）
• 实时日志与监控接口，便于服务状态追踪与问题排查

扩展性与可靠性

• 模块化架构设计，支持插件扩展（如自定义分析算法、数据转换器）
• 多实例部署支持，可通过负载均衡实现高可用
• 低资源占用，适配单机开发、云服务器及容器编排平台（K8s）

使用场景与适用范围

• GIS应用开发：作为后端服务支撑地图展示、空间查询功能
• 地图服务部署：快速搭建符合OGC标准的地图瓦片与矢量数据服务
• 空间数据分析平台：为环境监测、城市规划等场景提供空间计算能力
• 位置服务（LBS）后端：支持基于地理位置的用户请求处理与响应
• 资源管理系统：用于自然资源、交通路网等空间数据的管理与可视化

使用方法与配置说明

基本使用

通过以下命令快速启动基础地理空间服务：

bash
docker run -d -p 8080:8080 --name geospatial-service geospatial-web-services:latest

服务启动后，可通过 http://localhost:8080 访问服务主页，默认提供API文档与测试界面。

环境变量配置

镜像支持通过环境变量自定义服务参数，常用配置如下：

示例：指定数据源与端口启动

bash
docker run -d \
  -p 9000:9000 \
  -e SERVICE_PORT=9000 \
  -e DATA_SOURCE_URL="postgresql://gisuser:gispass@postgres:5432/geodb" \
  -e LOG_LEVEL=DEBUG \
  --name geospatial-service \
  geospatial-web-services:latest

持久化存储

为避免容器重启导致数据丢失，建议挂载数据卷持久化存储配置与地理数据：

bash
docker run -d \
  -p 8080:8080 \
  -v ./config:/app/config \  # 挂载配置文件目录
  -v ./data:/app/data \      # 挂载地理数据目录
  -v ./plugins:/app/plugins  # 挂载自定义插件目录
  --name geospatial-service \
  geospatial-web-services:latest

Docker Compose示例

使用docker-compose实现服务与依赖组件（如PostGIS数据库）的联动部署：

yaml
version: '3.8'
services:
  geospatial-service:
    image: geospatial-web-services:latest
    ports:
      - "8080:8080"
    environment:
      - SERVICE_PORT=8080
      - DATA_SOURCE_URL="postgresql://gisuser:gispass@postgres:5432/geodb"
      - LOG_LEVEL=INFO
    volumes:
      - ./data:/app/data
    depends_on:
      - postgres

  postgres:
    image: postgis/postgis:15-3.3
    environment:
      - POSTGRES_USER=gisuser
      - POSTGRES_PASSWORD=gispass
      - POSTGRES_DB=geodb
    volumes:
      - postgres_data:/var/lib/postgresql/data

volumes:
  postgres_data:

扩展配置

• 自定义地图样式：将Mapbox Style JSON文件放入 /app/config/styles 目录，服务自动加载
• 安全认证：通过挂载 /app/config/auth.yaml 配置API密钥或OAuth2认证（需启用 ENABLE_AUTH=true 环境变量）
• 插件扩展：将自定义Java/Python插件打包为JAR/Wheel文件放入 /app/plugins 目录，重启服务即可加载

注意事项

• 首次启动时，服务会初始化内置示例数据，可能需要30秒-2分钟（取决于硬件性能）
• 处理大型地理数据（如GB级GeoTIFF）时，建议增加容器内存限制（--memory=4g）
• 生产环境中需配置HTTPS（通过反向代理如Nginx实现），并限制 CORS_ALLOWED_ORIGINS 为可信域名