eightyoptions/geoserver

镜像概述

该镜像为kartoza/geoserver的快速分支版本，主要修改是默认启用了geoserver.xframe.shouldSetPolicy配置项（设置为true）。GeoServer是一款开源的地理信息服务器，用于发布、共享和管理地理空间数据。本镜像在保留kartoza/geoserver原有功能的基础上，增强了在iframe中嵌入服务的安全性。

核心功能与特性

• 继承基础功能：完整继承kartoza/geoserver的所有核心功能，包括地理数据发布、WMS/WFS/WCS服务支持、图层管理等
• X-Frame-Options策略支持：默认配置geoserver.xframe.shouldSetPolicy:true，允许设置X-Frame-Options响应头，增强在iframe中嵌入服务的安全性
• 兼容性：与kartoza/geoserver保持版本兼容，可无缝替换使用

使用场景

• 需要在网页中通过iframe嵌入GeoServer地图服务的场景
• 对Web应用安全性有要求，需限制GeoServer服务被嵌入的来源的场景
• 基于kartoza/geoserver进行二次开发或部署，需要启用X-Frame-Options策略的场景

使用方法

基本使用（docker run）

bash
docker run -d -p 8080:8080 --name geoserver-xframe kartoza/geoserver-xframe

验证配置

启动容器后，通过访问GeoServer服务并检查响应头验证配置是否生效：

bash
curl -I http://localhost:8080/geoserver

在响应头中应包含X-Frame-Options字段。

环境变量配置

本镜像继承kartoza/geoserver的所有环境变量，常用配置包括：

• GEOSERVER_ADMIN_USER：管理员用户名（默认：admin）
• GEOSERVER_ADMIN_PASSWORD：管理员密码（默认：geoserver）
• GEOSERVER_DATA_DIR：数据目录（默认：/opt/geoserver/data_dir）

如需修改geoserver.xframe.shouldSetPolicy配置，可通过挂载GeoServer配置文件实现：

bash
docker run -d -p 8080:8080 -v /local/path/to/geoserver.xml:/opt/geoserver/data_dir/geoserver.xml --name geoserver-xframe kartoza/geoserver-xframe

在geoserver.xml中调整xframe.shouldSetPolicy属性值。

Docker Compose示例

yaml
version: '3'
services:
  geoserver:
    image: kartoza/geoserver-xframe
    ports:
      - "8080:8080"
    environment:
      - GEOSERVER_ADMIN_USER=admin
      - GEOSERVER_ADMIN_PASSWORD=securepassword
    volumes:
      - geoserver_data:/opt/geoserver/data_dir
volumes:
  geoserver_data: