GeoNode Nginx基础镜像文档

镜像概述

GeoNode Nginx基础镜像是专为GeoNode地理空间数据管理平台设计的Web服务器镜像，基于Nginx构建并集成了适配GeoNode应用架构的预配置环境。该镜像旨在简化GeoNode部署流程，提供稳定、高效的Web服务支持，满足地理空间数据传输与访问需求。

核心功能与特性

• GeoNode适配配置：内置针对GeoNode的Nginx配置文件，优化请求路由、静态资源处理及反向代理规则，无需手动调整即可对接GeoNode应用服务。
• 地理空间数据优化：针对地理空间数据（如地图瓦片、矢量数据）传输进行网络性能优化，支持大文件传输配置。
• 组件兼容性：与GeoNode核心组件（如Django应用、GeoServer）无缝集成，确保请求正确分发至对应服务。
• 安全基线配置：包含基础安全设置，如HTTPS支持、请求限流、跨域资源共享（CORS）配置模板。
• 轻量级架构：基于***Nginx精简镜像构建，减少镜像体积，提升部署效率。

使用场景与适用范围

• GeoNode开发环境：作为本地开发环境的Web服务器，快速搭建GeoNode开发实例。
• 测试环境部署：在CI/CD流程或测试环境中提供标准化的Web服务层，确保测试一致性。
• 生产环境应用：作为生产环境的前端Web服务器，处理用户请求、反向代理GeoNode应用服务及静态资源分发。

使用方法与配置说明

基本使用（docker run）

通过以下命令启动镜像，默认配置下对接本地GeoNode应用服务（假设GeoNode应用运行在localhost:8000）：

bash
docker run -d \
  --name geonode-nginx \
  -p 80:80 \
  --link geonode-app:geonode-app \  # 链接GeoNode应用容器
  geonode/nginx-base:latest

环境变量配置

支持通过环境变量调整核心配置，常用变量如下：

示例（调整应用服务地址及最大请求体大小）：

bash
docker run -d \
  --name geonode-nginx \
  -p 80:80 \
  -e GEONODE_APP_HOST=192.168.1.100 \
  -e GEONODE_APP_PORT=8080 \
  -e NGINX_MAX_BODY_SIZE=500M \
  geonode/nginx-base:latest

挂载自定义配置文件

如需覆盖默认Nginx配置，可通过挂载本地配置文件实现（推荐用于生产环境）：

bash
docker run -d \
  --name geonode-nginx \
  -p 80:80 \
  -v /path/to/custom/nginx.conf:/etc/nginx/nginx.conf:ro \  # 挂载主配置
  -v /path/to/geonode-site.conf:/etc/nginx/conf.d/geonode.conf:ro \  # 挂载GeoNode站点配置
  geonode/nginx-base:latest

Docker Compose配置示例

在GeoNode多容器部署场景中，可通过docker-compose.yml集成该镜像：

yaml
version: '3'

services:
  nginx:
    image: geonode/nginx-base:latest
    ports:
      - "80:80"
      - "443:443"  # 若启用HTTPS
    environment:
      - GEONODE_APP_HOST=geonode
      - GEONODE_APP_PORT=8000
      - ENABLE_HTTPS=true
    volumes:
      - ./ssl:/etc/nginx/ssl:ro  # 挂载SSL证书（启用HTTPS时）
    depends_on:
      - geonode  # 依赖GeoNode应用服务容器
    restart: unless-stopped

  geonode:
    image: geonode/geonode:latest
    # GeoNode应用服务配置...

自定义SSL配置（HTTPS启用）

1. 准备SSL证书文件（server.crt和server.key），放置于本地目录（如./ssl）。
2. 启动容器时挂载证书目录并设置ENABLE_HTTPS=true：

bash
docker run -d \
  --name geonode-nginx \
  -p 443:443 \
  -e ENABLE_HTTPS=true \
  -e GEONODE_APP_HOST=geonode-app \
  -v ./ssl:/etc/nginx/ssl:ro \
  geonode/nginx-base:latest

注意事项

• 生产环境中建议挂载自定义配置文件，根据实际需求调整安全策略（如防火墙规则、访问控制列表）。
• 地理空间数据传输需确保NGINX_MAX_BODY_SIZE配置值大于预期上传文件大小。
• 与GeoNode版本兼容性：请使用与GeoNode版本匹配的镜像标签（如geonode/nginx-base:4.0对应GeoNode 4.0版本）。