ijoijo/nginx-auto

Nginx auto

这是什么？

这是一个Nginx web服务器的Docker镜像，具备以下特性：

• 基于Docker环境变量的全自动配置
• 提供A+级SSL评级的SSL参数
• 支持HTTP/2协议

Docker仓库地址：https://hub.docker.com/r/ijoijo/nginx-auto/

该镜像可与Let's Encrypt配合使用，实现SSL证书的自动创建和续期。相关的Let's Encrypt Docker镜像地址：https://hub.docker.com/r/ijoijo/letsencrypt/

如何使用该镜像？

HTTP仅模式（无SSL）

宿主机静态内容

bash
$ docker run -v /some/content:/usr/share/nginx/html:ro -e "NGINX_SERVERNAMES=test.example.com" -p 8080:80 -d ijoijo/nginx-auto

替换以下内容：

• /some/content 为宿主机上的正确路径
• test.example.com 为你的服务器名称
• 8080 为所需端口（如80）

镜像内静态内容

创建Dockerfile，内容如下：

FROM docker.xuanyuan.run/ijoijo/nginx-auto
COPY static-html-directory /usr/share/nginx/html

构建镜像：

bash
$ docker build -t nginx-with-content .

启动容器：

bash
$ docker run -e "NGINX_SERVERNAMES=test.example.com" -p 8080:80 -d nginx-with-content

替换以下内容：

• test.example.com 为你的服务器名称
• 8080 为所需端口（如80）

HTTPS模式（带Let's Encrypt，支持HTTP/2）

前置条件

• 需安装并运行docker-compose
• 服务器需可通过互联网访问80端口，且已在公共DNS注册

宿主机静态内容

创建docker-compose.yml文件，内容如下：

version: '2'

services:
  letsencrypt:
    image: docker.xuanyuan.run/ijoijo/letsencrypt
    restart: always
    volumes:
      - acme-webroot:/var/acme-webroot
      - letsencrypt-conf:/etc/letsencrypt
    environment:
      - LETSENCRYPT_HOSTNAMES=test.example.com
      - LETSENCRYPT_EMAIL=john@doe.com

  nginx:
    image: docker.xuanyuan.run/ijoijo/nginx-auto
    restart: always
    ports:
      - 80:80
      - 443:443
    volumes:
      - letsencrypt-conf:/etc/letsencrypt:ro
      - acme-webroot:/var/acme-webroot:ro
      - dhparam:/etc/nginx/dhparam
      - wwwlogsvolume:/var/log/nginx
      - /some/content:/usr/share/nginx/html:ro
    environment:
      - NGINX_SERVERNAMES=test.example.com

volumes:
  wwwlogsvolume: {}
  acme-webroot: {}
  letsencrypt-conf: {}
  dhparam: {}

替换以下内容：

• john@doe.com 为你的***
• test.example.com 为公共DNS上的服务器名称（需同时替换LETSENCRYPT_HOSTNAMES和NGINX_SERVERNAMES变量）
• /some/content 为宿主机上的正确路径

启动容器：

bash
$ docker-compose up -d

镜像内静态内容

创建Dockerfile，内容如下：

FROM docker.xuanyuan.run/ijoijo/nginx-auto
COPY static-html-directory /usr/share/nginx/html

构建镜像：

bash
$ docker build -t nginx-with-content .

创建docker-compose.yml文件，内容如下：

version: '2'

services:
  letsencrypt:
    image: docker.xuanyuan.run/ijoijo/letsencrypt
    restart: always
    volumes:
      - acme-webroot:/var/acme-webroot
      - letsencrypt-conf:/etc/letsencrypt
    environment:
      - LETSENCRYPT_HOSTNAMES=test.example.com
      - LETSENCRYPT_EMAIL=john@doe.com

  nginx:
    image: docker.xuanyuan.run/nginx-with-content
    restart: always
    ports:
      - 80:80
      - 443:443
    volumes:
      - letsencrypt-conf:/etc/letsencrypt:ro
      - acme-webroot:/var/acme-webroot:ro
      - dhparam:/etc/nginx/dhparam
      - wwwlogsvolume:/var/log/nginx
    environment:
      - NGINX_SERVERNAMES=test.example.com

volumes:
  wwwlogsvolume: {}
  acme-webroot: {}
  letsencrypt-conf: {}
  dhparam: {}

替换以下内容：

• john@doe.com 为你的***
• test.example.com 为公共DNS上的服务器名称（需同时替换LETSENCRYPT_HOSTNAMES和NGINX_SERVERNAMES变量）

启动容器：

bash
$ docker-compose up -d

贡献

欢迎并鼓励任何建议和贡献。

许可证

• 本Docker镜像代码基于MIT许可证授权
• Nginx基于http://nginx.org/LICENSE%E6%8E%88%E6%9D%83