Openresty with Auto SSL

描述(Desc)

这是一个可以自动申请（并自动更新）免费ssl证书的Openresty镜像。证书申请和更新使用的是开源工具acme.sh。
你可以设置证书服务商：zerossl, letsencrypt，buypass，ssl等等，或是地址，如Letsencrypt测试地址：https://acme-staging-v02.api.letsencrypt.org/directory

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

当然，你也可以把它当普通的openresty镜像使用。当入参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/openresty:latest

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

 docker run -d -p 80:80 -p 443:443 -v "/data/web":/data/web \
      -v /data/openresty/nginx/conf/ssl:/usr/local/openresty/nginx/conf/ssl \
      -v /data/openresty/nginx/conf/conf.d:/usr/local/openresty/nginx/conf/conf.d \
      -v "/data/openresty/acme_cert":/acme_cert/ \
      -e SslDomains="example.com;www.example.com;test.example.com;test2.example.com" \
      -e SslServer="zerossl" \
      -e mail="my@example.com" \
      --name myopenresty xiaojun207/openresty:latest

注意：

• 1、建议把路径/usr/local/openresty/nginx/conf/ssl、/acme_cert/中的内容都持久化到宿主机保存，避免容器删除后，启动后会自动再次获取（频繁申请证书会被服务商限制）。
• 2、不要改变nginx.conf的路径，否则证书生成会失败。
• 3、测试部署时，建议使用letsencrypt的测试地址（即参数，-e SslServer=“https://acme-staging-v02.api.letsencrypt.org/directory”）。

使用说明

默认情况下, 使用的是服务器验证，所以请确保，被申请ssl的域名可以访问到openresty容器。

参数说明

证书路径和openresty配置方法

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

openresty配置方法如下：

    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 ssl/fullchain.pem; # ssl证书自动安装的路径：/usr/local/openresty/nginx/conf/ssl/
        ssl_certificate_key ssl/key.pem; # ssl证书自动安装的路径：/usr/local/openresty/nginx/conf/ssl/
    
        # ...
    }

证书更新

证书会定期检查是否快要过期，如果快要过期，会自动更新并安装证书，你可以高枕无忧了（理论上的，我的证书还没到期，哈哈）。