poma/docker-gen

poma/docker-gen 镜像说明

镜像概述

poma/docker-gen是基于https://github.com/jwilder/docker-gen的衍生镜像，内置nginx模板文件，支持通过nginx_*环境变量配置nginx，默认使用与Let's Encrypt companion一致的Docker socket路径（/var/run/docker.sock），且会自动拉取上游仓库变更并重建镜像。

核心功能

1. 内置nginx.tmpl模板文件，无需额外挂载；
2. 支持nginx_*环境变量配置：容器自身的变量应用于全局nginx配置，其他容器的变量应用于对应虚拟主机配置（目前仅支持小写变量）；
3. 默认Docker socket路径与Let's Encrypt companion兼容；
4. 自动同步上游仓库变更，保持功能与上游一致。

使用场景

适用于多容器服务的反向代理场景，尤其是需要自动生成nginx配置并结合Let's Encrypt实现HTTPS证书自动管理的场景。

配置说明

通过设置nginx_*开头的环境变量配置nginx：

• 示例：nginx_client_max_body_size=30M；
• 镜像自身容器的变量：全局nginx配置；
• 其他服务容器的变量：对应虚拟主机配置。

部署示例（docker-compose）

yaml
version: '2.1'

services:
  nginx:
    image: nginx:alpine
    container_name: nginx
    restart: always
    ports:
      - 80:80
      - 443:443
    volumes:
      - conf:/etc/nginx/conf.d
      - vhost:/etc/nginx/vhost.d
      - html:/usr/share/nginx/html
      - certs:/etc/nginx/certs

  dockergen:
    image: poma/docker-gen
    container_name: dockergen
    restart: always
    command: -notify-sighup nginx -watch /etc/docker-gen/templates/nginx.tmpl /etc/nginx/conf.d/default.conf
    environment:
      nginx_client_max_body_size: 42M
    volumes_from:
      - nginx
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock:ro

  letsencrypt:
    image: jrcs/letsencrypt-nginx-proxy-companion
    container_name: letsencrypt
    restart: always
    environment:
      NGINX_DOCKER_GEN_CONTAINER: dockergen
    volumes_from:
      - nginx
      - dockergen

  app:
    image: app
    environment:
      VIRTUAL_HOST: example.com
      LETSENCRYPT_HOST: example.com
      nginx_client_max_body_size: 1337M

volumes:
  conf:
  vhost:
  html:
  certs: