milhomem/nginx

开箱即用的支持环境变量的Nginx镜像

基于官方Nginx镜像，通过envsubst工具使用环境变量动态生成配置文件，避免因修改配置而频繁构建镜像。本镜像旨在提供灵活的Nginx配置方案，同时支持静态文件服务和PHP FastCGI后端代理。

支持的标签及对应Dockerfile链接

• https://github.com/milhomem/nginx/blob/master/alpine/base/Dockerfile
• https://github.com/milhomem/nginx/blob/master/alpine/php/Dockerfile
• https://github.com/milhomem/nginx/blob/e66e777ad9d4b648b480d7fc11a2903dd893f0d6/alpine/php/Dockerfile

什么是Nginx？

***.org/wiki/Nginx

!https://raw.githubusercontent.com/docker-library/docs/01c***b2fe592c1f93a13b4e289ada0e3a1/nginx/logo.png

Nginx是一款高性能的HTTP和反向代理服务器，也是一个IMAP/POP3/SMTP代理服务器。

如何使用本镜像

基础来源

基于官方https://hub.docker.com/_/nginx 构建。

修改配置

通过环境变量修改Nginx配置：

console
docker run --rm --name some-nginx -p 8080:80 -e NGINX_HOST=192.168.99.100.xip.io docker.xuanyuan.run/milhomem/nginx

访问 http://192.168.99.100.xip.io:8080 即可测试。

另一个示例（挂载静态文件目录）：

console
docker run --rm --name some-nginx -p 8080:80 -v /local/src:/var/www -e STATIC_FILES_ROOT=/var/www/public docker.xuanyuan.run/milhomem/nginx

查看应用后的配置：

console
docker exec some-nginx cat /etc/nginx/conf.d/default.conf

可用环境变量

根据使用的标签不同，可用环境变量可能有所差异，当前支持的变量包括：

• CLIENT_MAX_BODY_SIZE：客户端最大请求体大小
• NGINX_PORT：Nginx监听端口
• NGINX_HOST：Nginx主机名
• STATIC_FILES_ROOT：静态文件根目录
• FASTCGI_FILES_ROOT：FastCGI文件根目录
• FASTCGI_HOST：FastCGI后端主机
• FASTCGI_PORT：FastCGI后端端口
• FASTCGI_CONNECT_TIMEOUT：FastCGI连接超时时间
• FASTCGI_SEND_TIMEOUT：FastCGI发送超时时间
• FASTCGI_READ_TIMEOUT：FastCGI读取超时时间
• PHP_VALUE：PHP配置参数（如date.timezone=GMT\nmax_execution_time=30）

如需更多环境变量支持，可提交issue或参考下方复杂配置方法。

复杂配置

配置文件夹 /etc/nginx/conf.d/ 中的所有 .template 文件会通过环境变量替换生成最终配置，并包含在Nginx配置中。支持以下模板类型：

• .conf.template：生成后位于 http 指令下，可定义多个 server 块
• .rules.template：生成后位于主 server 模板下
• .fastcgi_params.template：生成后包含在 fastcgi 代理配置中

示例：通过Dockerfile添加自定义规则和静态文件

dockerfile
FROM docker.xuanyuan.run/milhomem/nginx

ADD config/templates/*.rules.template /etc/nginx/conf.d/

ADD src .

自定义模板仍可使用环境变量，保持配置灵活性。

在Nginx配置中使用环境变量

Nginx原生不支持大多数配置块中的环境变量，但可通过 envsubst 在启动前动态生成配置。以下是docker-compose.yml示例：

示例1：PHP FastCGI后端代理

yaml
version: '3'

services:
  nginx:
    image: docker.xuanyuan.run/milhomem/nginx:php
    ports:
     - "8080:80"
    environment:
       FASTCGI_HOST: "hello_world_app"
       FASTCGI_FILES_ROOT: "/app"
       
  hello_world_app:
    image: docker.xuanyuan.run/php:7.3-fpm
    command: |
          sh -c "
          mkdir /app;
          echo '<?php phpinfo(); ?>' > /app/index.php;
          php-fpm
          "

示例2：完整配置示例

yaml
version: '3'

services:
  web:
    image: docker.xuanyuan.run/milhomem/nginx:php
    ports:
     - "8080:8081"
    environment:
       NGINX_HOST: "localhost"
       NGINX_PORT: "8081"
       FASTCGI_FILES_ROOT: "/var/www"
       FASTCGI_HOST: "fcgi"
       PHP_VALUE: "date.timezone=GMT\nmax_execution_time=30"
       CLIENT_MAX_BODY_SIZE: "10m"
       FASTCGI_CONNECT_TIMEOUT: "5"
       FASTCGI_SEND_TIMEOUT: "5"
       FASTCGI_READ_TIMEOUT: "5"

  fcgi:
    image: docker.xuanyuan.run/php:7.3-fpm
    volumes:
      - "source_code:/var/www"
volumes:
  source_code:
    driver: local

镜像变体

milhomem/nginx:<version>-alpine-php

基于[***] FastCGI后端场景，通过FASTCGI_HOST链接后端服务并代理请求。

milhomem/nginx:latest

同样基于Alpine Linux，仅用于静态文件服务。需通过构建镜像添加文件或挂载卷到容器中提供静态资源。

贡献

如需更多常用功能或变体，可提交issue或PR。如有建议或想参与项目，可通过@milmeninos联系。