dockito/proxy

镜像概述

dockito/proxy是基于https://github.com/jwilder/nginx-proxy%E7%9A%84Docker%E9%95%9C%E5%83%8F%EF%BC%8C%E6%95%B4%E5%90%88nginx%E5%92%8Cdocker-gen%E5%B7%A5%E5%85%B7%EF%BC%8C%E5%AE%9E%E7%8E%B0Docker%E5%AE%B9%E5%99%A8%E7%9A%84%E8%87%AA%E5%8A%A8%E5%8F%8D%E5%90%91%E4%BB%A3%E7%90%86%E9%85%8D%E7%BD%AE%E3%80%82%E8%AF%A5%E9%95%9C%E5%83%8F%E6%96%B0%E5%A2%9EVIRTUAL_ALLOW%E6%94%AF%E6%8C%81%EF%BC%8C%E6%8F%90%E5%8D%87%E6%9C%80%E5%A4%A7%E4%B8%8A%E4%BC%A0%E9%99%90%E5%88%B6%E8%87%B31024m%EF%BC%8C%E9%80%82%E7%94%A8%E4%BA%8E%E5%A4%9A%E5%AE%B9%E5%99%A8%E4%BB%A3%E7%90%86%E7%AE%A1%E7%90%86%E5%9C%BA%E6%99%AF%E3%80%82

核心功能

• 自动生成nginx反向代理配置，容器启停时自动重载nginx
• 支持VIRTUAL_ALLOW参数（解决原项目#36问题）
• 最大上传限制提升至1024m
• 支持多端口、多主机、通配符主机配置
• 支持SSL（单主机、通配符、SNI证书）
• 支持基础认证与自定义Nginx配置
• 支持多Docker网络连接

使用场景

• 多Docker容器的Web服务反向代理
• 微服务架构的自动代理配置
• 多域名服务的快速搭建
• 需SSL加密的容器化应用

配置说明

基础使用

启动proxy容器：

bash
docker run -d -p 80:80 -v /var/run/docker.sock:/tmp/docker.sock:ro dockito/proxy

启动需代理的容器（指定虚拟主机）：

bash
docker run -e VIRTUAL_HOST=foo.bar.com ...

Docker Compose示例

yaml
version: '2'
services:
  nginx-proxy:
    image: dockito/proxy
    container_name: nginx-proxy
    ports:
      - "80:80"
    volumes:
      - /var/run/docker.sock:/tmp/docker.sock:ro

  whoami:
    image: jwilder/whoami
    container_name: whoami
    environment:
      - VIRTUAL_HOST=whoami.local

启动并测试：

bash
docker-compose up
curl -H "Host: whoami.local" localhost

多端口处理

默认使用80端口，可通过VIRTUAL_PORT指定端口：

bash
docker run -e VIRTUAL_HOST=foo.bar.com -e VIRTUAL_PORT=8080 ...

SSL支持

挂载证书目录（证书命名为{VIRTUAL_HOST}.crt和{VIRTUAL_HOST}.key）：

bash
docker run -d -p 80:80 -p 443:443 -v /path/to/certs:/etc/nginx/certs -v /var/run/docker.sock:/tmp/docker.sock:ro dockito/proxy

基础认证

挂载htpasswd目录（需提前创建htpasswd文件）：

bash
docker run -d -p 80:80 -p 443:443 \
  -v /path/to/htpasswd:/etc/nginx/htpasswd \
  -v /path/to/certs:/etc/nginx/certs \
  -v /var/run/docker.sock:/tmp/docker.sock:ro \
  dockito/proxy

自定义Nginx配置

• 全局配置：添加.conf文件到/etc/nginx/conf.d
• 单主机配置：添加文件到/etc/nginx/vhost.d/{VIRTUAL_HOST}
• 位置配置：添加文件到/etc/nginx/vhost.d/{VIRTUAL_HOST}_location