aoggz/nginx-reverse-proxy

nginx-reverse-proxy

镜像概述

aoggz/nginx-reverse-proxy是一个基于nginx的反向代理容器，启动时会自动生成临时SSL证书，主要设计为ECS任务的sidecar容器，最初用于部署在ECS Fargate上的.NET Core API和Web服务。

核心功能

1. 提供反向代理能力，将外部请求转发至指定的目标服务地址
2. 启动过程中自动生成临时SSL证书，支持HTTPS访问
3. 支持作为sidecar容器与主服务协同运行，适配容器化部署场景

使用场景

1. ECS Fargate环境中.NET Core API或Web服务的反向代理与HTTPS支持
2. 需要临时SSL证书的轻量级服务转发场景
3. 容器化服务的快速HTTPS接入需求

配置说明

容器运行需设置以下环境变量：

• PROXY_ADDRESS：反向代理的目标地址
• DOMAIN：生成证书所用的域名
• COUNTRY：证书中的国家信息
• STATE：证书中的州/省信息
• LOCALITY：证书中的城市信息
• ORGANIZATION：证书中的组织名称
• ORGANIZATIONAL_UNIT：证书中的部门名称
• EMAIL_ADDRESS：证书中的联系***

部署示例

Docker Compose配置

yml
version: '2'
services:
  web:
    ...
    expose:
      - "80"
  reverse_proxy:
    image: docker.xuanyuan.run/aoggz/nginx-reverse-proxy:latest
    ports:
      - "443:443"
    environment:
      - PROXY_ADDRESS
      - DOMAIN
      - COUNTRY
      - STATE
      - LOCALITY
      - ORGANIZATION
      - ORGANIZATIONAL_UNIT
      - EMAIL_ADDRESS
    links:
      - web

ECS任务定义配置

json
[
  {
    "name": "web",
    "cpu": 8675309,
    "image": "ecr_repository_url_here:latest",
    "memory": 8675309,
    "essential": true,
    "portMappings": [
      {
        "containerPort": 80
      }
    ]
  },
  {
    "name": "reverse_proxy",
    "cpu": 8675309,
    "image": "aoggz/nginx-reverse-proxy:latest",
    "memory": 8675309,
    "essential": true,
    "portMappings": [
      {
        "containerPort": 443,
        "hostPort": 443
      }
    ],
    "environment": [
      {
        "name": "DOMAIN",
        "value": "your-super-awesome-doma.in"
      },
      {
        "name": "PROXY_ADDRESS",
        "value": "127.0.0.1"
      },
      {
        "name": "COUNTRY",
        "value": "US"
      },
      {
        "name": "STATE",
        "value": "PA"
      },
      {
        "name": "LOCALITY",
        "value": "Pittsburgh"
      },
      {
        "name": "ORGANIZATIONAL_UNIT",
        "value": "Testing enterprises, ltd."
      },
      {
        "name": "EMAIL_ADDRESS",
        "value": "***"
      }
    ]
  }
  ...
]