bbtsoftwareag/nginx-proxy-unrestricted-requestsize

nginx-proxy-unrestricted-requestsize 镜像文档

!License MIT

镜像概述

nginx-proxy-unrestricted-requestsize是基于https://hub.docker.com/r/jwilder/nginx-proxy%E6%B4%BE%E7%94%9F%E7%9A%84Docker%E9%95%9C%E5%83%8F%EF%BC%8C%E4%B8%BB%E8%A6%81%E7%89%B9%E7%82%B9%E6%98%AF%E8%A7%A3%E9%99%A4%E4%BA%86Nginx%E9%BB%98%E8%AE%A4%E7%9A%84%E5%AE%A2%E6%88%B7%E7%AB%AF%E8%AF%B7%E6%B1%82%E4%BD%93%E5%A4%A7%E5%B0%8F%E9%99%90%E5%88%B6%EF%BC%8C%E5%85%81%E8%AE%B8%E5%A4%84%E7%90%86%E4%BB%BB%E6%84%8F%E5%A4%A7%E5%B0%8F%E7%9A%84HTTP%E8%AF%B7%E6%B1%82%E3%80%82

核心功能与特性

• 继承jwilder/nginx-proxy全部功能：包括自动反向代理配置、基于容器环境变量的虚拟主机设置等
• 解除请求体大小限制：通过配置client_max_body_size 0;，完全取消Nginx对客户端请求体大小的限制
• 保持与上游镜像兼容性：使用方法和配置方式与jwilder/nginx-proxy完全一致

使用场景

• 需要处理大文件上传的Web应用
• 接收大型JSON/XML payload的API服务
• 任何需要处理超过默认Nginx请求体大小限制（通常为1MB）的场景

使用方法

基本使用

该镜像的使用方法与https://hub.docker.com/r/jwilder/nginx-proxy%E5%AE%8C%E5%85%A8%E4%B8%80%E8%87%B4%EF%BC%8C%E4%BB%85%E5%9C%A8%E8%AF%B7%E6%B1%82%E4%BD%93%E5%A4%A7%E5%B0%8F%E9%99%90%E5%88%B6%E6%96%B9%E9%9D%A2%E6%9C%89%E6%89%80%E4%B8%8D%E5%90%8C%E3%80%82

启动代理容器

sh
docker run -d -p 80:80 -v /var/run/docker.sock:/tmp/docker.sock:ro bbtsoftwareag/nginx-proxy-unrestricted-requestsize

启动后端服务容器

为后端服务容器设置VIRTUAL_HOST环境变量，代理会自动发现并配置反向代理：

sh
docker run -d -e VIRTUAL_HOST=example.com mybackendimage

docker-compose示例

yaml
version: '3'

services:
  nginx-proxy:
    image: bbtsoftwareag/nginx-proxy-unrestricted-requestsize
    ports:
      - "80:80"
    volumes:
      - /var/run/docker.sock:/tmp/docker.sock:ro
    restart: always

  backend:
    image: mybackendimage
    environment:
      - VIRTUAL_HOST=example.com
    restart: always

注意事项

• 该镜像仅修改了Nginx的client_max_body_size配置，其他所有行为与jwilder/nginx-proxy保持一致
• 详细使用说明请参考https://hub.docker.com/r/jwilder/nginx-proxy