Nginx 💖 with Auto SSL

描述(Desc)

这是一个可以自动申请（并自动更新）免费ssl证书的nginx镜像。证书申请和更新使用的是开源工具acme.sh。

你可以设置证书服务商：zerossl, letsencrypt，buypass，ssl等等，或是地址，如Letsencrypt测试地址：https://acme-staging-v02.api.letsencrypt.org/directory

This is a Nginx image with auto ssl，use acme.sh， you can set default-ca,like: zerossl, letsencrypt，buypass，ssl …

当然，你也可以把它当普通的nginx镜像使用。当入参DOMAINS为空（-e DOMAINS=“” 或不填），不会启动证书acme（证书获取程序）。

Openresty镜像github地址

https://github.com/xiaojun207/docker-openresty

Nginx镜像github地址

https://github.com/xiaojun207/docker-nginx

快速启动(Quick Start)

docker pull xiaojun207/nginx:latest

使用例子，如下(eg.)：

docker run -d -p 80:80 -p 443:443 -v "/data/web":/data/web \

-v "/data/mynginx/nginx/ssl":/etc/nginx/ssl \

-v "/data/mynginx/nginx/conf.d":/etc/nginx/conf.d \

-v "/data/mynginx/acme_cert":/acme_cert \

-e SslDomains="example.com;www.example.com;test.example.com;test2.example.com" \

-e SslServer="zerossl" \

-e mail="youmail@example.com" \

--name nginx xiaojun207/nginx:latest

注意：

1、建议把路径/etc/nginx/ssl、/acme_cert中的内容都持久化到宿主机保存，避免容器删除后，启动后会自动再次获取（频繁申请证书会被服务商限制）。

2、不要改变nginx.conf的路径，否则证书生成会失败。

3、测试部署时，建议使用letsencrypt的测试地址（即参数，-e SslServer=“https://acme-staging-v02.api.letsencrypt.org/directory”）。

使用说明

默认情况下, 使用的是服务器验证方式(非dns方式)，所以请确保，需要申请证书的域名http端口可以正常访问（本nginx启动的http端口）。

参数说明

参数是否必填说明

SslDomains 必填需要获取参数ssl的域名列表。多个域名间以英文分号分隔(即：; )。如果为空或不填，这就是个普通的nginx镜像，哈哈。

mail 必填你的邮箱，用于获取ssl时配置，有的证书服务商有网页管理端，可以根据邮箱查看相关的证书。如果为空可能会导致注册到证书服务商失败，因此如果参数为空会使用默认邮箱。

SslServer 否证书服务商（名字或地址），默认：zerossl，你还可以使用：letsencrypt，buypass，ssl等等，或者letsencrypt的测试地址：https://acme-staging-v02.api.letsencrypt.org/directory

dns 否域名是否采用dns验证，可选参数为：空格，dns_ali，dns_aws，dns_cf，dns_dp，，。。。更多参数请查看：https://github.com/acmesh-official/acme.sh/wiki/dnsapi例如1： -e dns=" ", 空格时，请查看控制台日志中的dns记录，并手动为域名添加解析；例如2： -e dns=“dns_ali” -e Ali_Key=“sdfsdfsdfljlbjkljlkjsdfoiwje” -e Ali_Secret=“jlsdflanljkljlfdsaklkjflsa” 使用云厂商api，请添加对应的key、secret等"添加域名解析"授权参数

证书路径和nginx配置方法

容器启动，会创建一个默认证书，避免nginx启动失败。证书获取成功后，将会被安装到固定路径：/etc/nginx/ssl/

nginx配置方法如下：

server {

# 80端口必须可以正常访问，用来验证你的域名

listen 80;

server_name example.com;

# ...

}

server {

listen 443 ssl;

server_name example.com;

root /data/web/www;

ssl_stapling off;

ssl_certificate /etc/nginx/ssl/fullchain.pem; # 证书自动安装的路径

ssl_certificate_key /etc/nginx/ssl/key.pem; # 证书自动安装的路径

# ...

}