citizenlabdotco/cl2-devops-nginx-prerender-proxy

cl2-devops-nginx-prerender-proxy 镜像文档

镜像概述和主要用途

该Docker镜像运行在Swarm集群环境中，主要用于提供来自citizenlab/front的index.html文件，并能针对爬虫和机器人请求重定向至prerender服务。通过环境变量配置prerender服务地址及前端文件路径，实现动态请求分发。

核心功能和特性

• 代理分发能力：作为Nginx代理，可区分普通用户与爬虫/机器人请求
• prerender重定向：自动将爬虫和机器人请求重定向至prerender服务
• 静态文件服务：提供citizenlab/front构建后的静态文件（如index.html）
• 环境变量配置：通过环境变量灵活设置prerender服务地址和前端文件路径

使用场景和适用范围

• 部署在Swarm集群环境中的前端应用
• 需要对搜索引擎爬虫提供预渲染内容的SEO优化场景
• 基于citizenlab/front构建的前端项目，需区分普通用户与爬虫请求处理

使用方法和配置说明

环境变量

Docker Run 示例

bash
docker run -d \
  -p 80:80 \
  -e PRERENDER_ADDRESS="http://prerender:3000" \
  -e FRONT_FILES_PATH="/usr/share/nginx/html" \
  --name nginx-prerender-proxy \
  cl2-devops-nginx-prerender-proxy

Docker Compose 配置示例

yaml
version: '3'
services:
  nginx-prerender-proxy:
    image: cl2-devops-nginx-prerender-proxy
    ports:
      - "80:80"
    environment:
      - PRERENDER_ADDRESS=http://prerender:3000
      - FRONT_FILES_PATH=/usr/share/nginx/html
    deploy:
      replicas: 3
      placement:
        constraints: [node.role == worker]

Swarm集群部署说明

在Swarm集群中部署时，需确保prerender服务与该代理服务在同一网络中，以便通过环境变量配置的地址正常通信。前端文件可通过数据卷挂载或镜像内置方式提供。