schickling/nginx-envtpl

nginx-envtpl

基于Nginx的镜像，集成https://github.com/andreasjansson/envtpl%E5%B7%A5%E5%85%B7%EF%BC%8C%E6%94%AF%E6%8C%81%E9%80%9A%E8%BF%87%E7%8E%AF%E5%A2%83%E5%8F%98%E9%87%8F%E5%8A%A8%E6%80%81%E7%94%9F%E6%88%90Nginx%E9%85%8D%E7%BD%AE%E6%96%87%E4%BB%B6%EF%BC%8C%E9%81%BF%E5%85%8D%E7%A1%AC%E7%BC%96%E7%A0%81%E9%85%8D%E7%BD%AE%EF%BC%8C%E6%8F%90%E5%8D%87%E9%83%A8%E7%BD%B2%E7%81%B5%E6%B4%BB%E6%80%A7%E3%80%82

核心功能

• 支持环境变量替换Nginx配置模板中的占位符
• 提供两种配置模板传递方式：挂载文件或通过环境变量传递
• 保留Nginx原生功能（如代理、缓存、日志输出等）

使用场景

• 容器化部署中，需根据不同环境（开发/测试/生产）动态调整Nginx参数的场景
• 快速搭建支持动态配置的Nginx代理服务
• 需要统一通过环境变量管理配置的场景

配置说明

方式1：挂载模板文件

将本地Nginx配置模板文件（如nginx.conf.tpl）挂载到容器内的/etc/nginx/nginx.conf.tpl路径，通过环境变量替换模板中的占位符。

方式2：通过环境变量传递模板

使用NGINX_CONFIG_TEMPLATE环境变量直接传递配置模板内容，无需挂载文件。

部署示例

Docker Run命令

sh
docker run -d -p 80:80 \
  -e NGINX_WORKER_RLIMIT_NOFILE=96000 \
  -e NGINX_WORKER_CONNECTIONS=10000 \
  -v ./nginx.conf.tpl:/etc/nginx/nginx.conf.tpl \
  schickling/nginx-envtpl

Docker Compose示例

yaml
proxy:
  image: schickling/nginx-envtpl
  environment:
    NGINX_WORKER_RLIMIT_NOFILE: 96000
    NGINX_WORKER_CONNECTIONS: ***
    NGINX_BACKLOG: ***
    NGINX_PROXY_ADDR: "[***]"
    NGINX_CONFIG_TEMPLATE: |
      worker_processes auto;
      worker_rlimit_nofile {{ NGINX_WORKER_RLIMIT_NOFILE }};
      error_log /dev/stdout info;

      events {
          worker_connections {{ NGINX_WORKER_CONNECTIONS }};
          use epoll;
          multi_accept on;
      }

      http {
          proxy_cache_path /tmp/nginx levels=1:2 keys_zone=my_zone:10m inactive=60m;
          access_log /dev/stdout;

          server {
              listen 80 backlog={{ NGINX_BACKLOG }};
              root /usr/share/nginx/html/;
              index index.html;
              server_name localhost;
              charset utf-8;

              location / {
                  proxy_pass {{ NGINX_PROXY_ADDR }};
                  proxy_cache my_zone;
                  proxy_cache_methods POST;
                  proxy_cache_key "$request_uri|$request_body";
                  proxy_cache_valid 5s;
                  proxy_cache_use_stale error timeout updating;
                  add_header X-Proxy-Cache $upstream_cache_status;
              }
          }
      }
  ports:
    - "80:80"