cyberpearuk/nginx-proxy

Nginx Proxy Docker镜像

镜像概述

本镜像为基于jwilder/nginx-proxy扩展的Nginx代理Docker镜像，提供增强的代理功能，包括可配置的Docker Gen禁用选项和灵活的代理缓存规则，适用于需要精细化控制Nginx代理行为的场景。

核心功能与特性

Docker Gen控制

• 支持通过环境变量禁用Docker Gen：设置DISABLE_DOCKER_GEN环境变量为true即可禁用Docker Gen。

代理缓存

启用方式

为特定容器启用代理缓存，需为该容器添加环境变量PROXY_CACHE并设置为true。

缓存排除规则

代理缓存默认排除以下请求类型：

• 未设置缓存Cookie的请求
• 包含HTTP Authorization头的请求
• 包含SetCookie头的请求
• 非GET或HEAD方法的请求
• 包含GitLab会话Cookie、Java会话Cookie（JSESSIONID）或Nexus会话Cookie（NXSESSIONID）的请求
• 包含Pragma头或"Cache-Control: no-cache"头的请求

使用场景

适用于需要Nginx反向代理功能，并需根据实际需求灵活控制Docker Gen服务或配置代理缓存策略的应用场景，如多容器服务代理、需要缓存优化的静态资源服务等。

使用方法与配置说明

禁用Docker Gen

在启动容器时设置环境变量DISABLE_DOCKER_GEN=true：

bash
docker run -e DISABLE_DOCKER_GEN=true [其他参数] blackpeardigital/nginx-proxy

启用代理缓存

为目标容器添加环境变量PROXY_CACHE=true，示例docker-compose配置：

yaml
version: '3'
services:
  proxy:
    image: blackpeardigital/nginx-proxy
    ports:
      - "80:80"
    volumes:
      - /var/run/docker.sock:/tmp/docker.sock:ro
  webapp:
    image: your-webapp-image
    environment:
      - VIRTUAL_HOST=yourdomain.com
      - PROXY_CACHE=true  # 启用该容器的代理缓存

维护者

本仓库由Black Pear Digital维护。