snappler/nginx-reverse-proxy

Nginx反向代理镜像（适用于Rails应用）

镜像概述

本镜像为适配AWS ECS环境的Nginx反向代理工具，核心用于为Rails应用提供反向代理服务，支持通过环境变量灵活调整代理参数，同时具备Websocket功能扩展能力。

核心功能

• 转发客户端请求至后端Rails服务的反向代理能力
• 环境变量自定义配置（请求超时、后端服务标识/端口、监听端口等）
• 可选启用Websocket支持，自动加载对应配置规则

使用场景

• AWS ECS环境中Rails应用的前端反向代理层部署
• 需要为Rails应用添加Websocket功能的场景
• 需动态调整代理参数（如超时时间、端口）的反向代理需求

配置说明

环境变量列表

Websocket启用方式

当设置WEBSOCKET_PATH变量时，镜像自动包含以下Websocket配置：

nginx
location WEBSOCKET_PATH {
  proxy_pass http://DOCKER_NAME:DOCKER_PORT/WEBSOCKET_PATH;
  proxy_http_version 1.1;
  proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
  proxy_set_header Host $http_host;
  proxy_set_header Upgrade "websocket";
  proxy_set_header Connection "Upgrade";
}

部署示例

Docker Run命令

bash
docker run -d \
  -p 80:80 \
  -e DOCKER_NAME=my-rails-service \
  -e DOCKER_PORT=3000 \
  -e WEBSOCKET_PATH=/cable \
  snappler/nginx-reverse-proxy

Docker Compose配置

yaml
version: '3.8'
services:
  reverse-proxy:
    image: snappler/nginx-reverse-proxy
    ports:
      - "80:80"
    environment:
      - REQUEST_TIMEOUT=120
      - DOCKER_NAME=rails-app
      - DOCKER_PORT=3000
      - WEBSOCKET_PATH=/cable
  rails-app:
    image: your-rails-app-image
    # Rails应用相关配置（如端口、卷挂载等）