使用 acme.sh 获取网站SSL证书并配置https访问,核心说明

2019年5月17日 0条评论 1,653次阅读 0人点赞

如果想知道如何将http 80端口自动重定向到 https 443端口,请看这里 https://www.bgegao.com/2019/05/1329.html
——–
如果用着用着证书过期了,可以重新生成一次,然后重新启动HTTP服务器

acme.sh  --issue -f -d mydomain.com -d www.mydomain.com  --webroot  /www/wwwroot/mydomain.com

注意:如果网站目录设置了密码访问,需要先取消密码,要不然更新不会成功
———
acme.sh 实现了 acme 协议, 可以从 letsencrypt 生成免费的证书.（https://github.com/Neilpang/acme.sh/wiki/%E8%AF%B4%E6%98%8E）

主要步骤:

安装 acme.sh
生成证书
copy 证书到 nginx/apache 或者其他服务
更新证书
更新 acme.sh
出错怎么办, 如何调试
下面详细介绍.

1. 安装 acme.sh
安装很简单, 一个命令:

curl  https://get.acme.sh | sh

普通用户和 root 用户都可以安装使用. 安装过程进行了以下几步:

把 acme.sh 安装到你的 home 目录下:

~/.acme.sh/

并创建一个 bash 的 alias, 方便你的使用:

alias acme.sh=~/.acme.sh/acme.sh

2). 自动为你创建 cronjob, 每天 0:00 点自动检测所有的证书, 如果快过期了, 需要更新, 则会自动更新证书.

更高级的安装选项请参考: https://github.com/Neilpang/acme.sh/wiki/How-to-install

安装过程不会污染已有的系统任何功能和文件, 所有的修改都限制在安装目录中: ~/.acme.sh/

2. 生成证书
acme.sh 实现了 acme 协议支持的所有验证协议. 一般有两种方式验证: http 和 dns 验证.

1. http 方式需要在你的网站根目录下放置一个文件, 来验证你的域名所有权,完成验证. 然后就可以生成证书了.

acme.sh  --issue  -d mydomain.com -d www.mydomain.com  --webroot  /home/wwwroot/mydomain.com/

只需要指定域名, 并指定域名所在的网站根目录. acme.sh 会全自动的生成验证文件, 并放到网站的根目录, 然后自动完成验证. 最后会聪明的删除验证文件. 整个过程没有任何副作用.
生成证书部份到这里就可以了,下面的其它生成方法可以不看

如果你用的 apache服务器, acme.sh 还可以智能的从 apache的配置中自动完成验证, 你不需要指定网站根目录:

acme.sh --issue  -d mydomain.com   --apache

如果你用的 nginx服务器, 或者反代, acme.sh 还可以智能的从 nginx的配置中自动完成验证, 你不需要指定网站根目录:

acme.sh --issue  -d mydomain.com   --nginx

注意, 无论是 apache 还是 nginx 模式, acme.sh在完成验证之后, 会恢复到之前的状态, 都不会私自更改你本身的配置. 好处是你不用担心配置被搞坏, 也有一个缺点, 你需要自己配置 ssl 的配置, 否则只能成功生成证书, 你的网站还是无法访问https. 但是为了安全, 你还是自己手动改配置吧.

如果你还没有运行任何 web 服务, 80 端口是空闲的, 那么 acme.sh 还能假装自己是一个webserver, 临时听在80 端口, 完成验证:

acme.sh  --issue -d mydomain.com   --standalone

更高级的用法请参考: https://github.com/Neilpang/acme.sh/wiki/How-to-issue-a-cert

2. dns 方式, 在域名上添加一条 txt 解析记录, 验证域名所有权.
dns方式其实是acme.sh通过调用各个域名服务商的api添加TXT记录验证所有权这样的流程，所以需要考虑的是如何让acme.sh添加记录后及时生效，默认acme.sh会等待120秒后开始验证，但是很多DNS解析有120秒往往无法完成，所以此处建议使用dnspod（https://www.dnspod.cn）

dns 方式的真正强大之处在于可以使用域名解析商提供的 api 自动添加 txt 记录完成验证.

acme.sh 目前支持 cloudflare, dnspod, cloudxns, godaddy 以及 ovh 等数十种解析商的自动集成.

以 dnspod 为例, 你需要先登录到 dnspod 账号, 生成你的 api id 和 api key, 都是免费的. 然后:

export DP_Id="你创建的api token的id"

export DP_Key="你创建的api token的token"

acme.sh   --issue   --dns dns_dp   -d 你的域名  -d www.你的域名

如果你想为你的每个二级域名创建证书这里可以用到泛域名证书，将最后一行代码改为

acme.sh --issue --dns dns_dp -d *.你的域名 -d 你的域名

这样你所有的二级域名和域名本身都获取了证书，如果证书获取成功，会在屏幕上打印出证书存放路径

在配置Nginx 的配置 ssl_certificate 时使用 fullchain.cer(这个地方就是web服务器配置的地方了,重要)

server {
        listen       443 ssl;
        server_name  localhost;

        location / {
            #代理到那个服务器 这里http://hz  指的是上面upstream 中的 hz
             proxy_pass http://hz;
             index index.html index.htm;
         }

        ssl_certificate      /root/.acme.sh/*.hz1202.com/fullchain.cer;
        ssl_certificate_key  /root/.acme.sh/*.hz1202.com/*.hz1202.com.key;

        ssl_session_cache    shared:SSL:1m;
        ssl_session_timeout  5m;

        ssl_ciphers  HIGH:!aNULL:!MD5;
        ssl_prefer_server_ciphers  on;
    }

4. 更新证书
目前证书在 60 天以后会自动更新, 你无需任何操作. 今后有可能会缩短这个时间, 不过都是自动的, 你不用关心.

5. 更新 acme.sh
目前由于 acme 协议和 letsencrypt CA 都在频繁的更新, 因此 acme.sh 也经常更新以保持同步.

升级 acme.sh 到最新版 :

acme.sh --upgrade

如果你不想手动升级, 可以开启自动升级:

acme.sh  --upgrade  --auto-upgrade

之后, acme.sh 就会自动保持更新了.

你也可以随时关闭自动更新:

acme.sh --upgrade  --auto-upgrade  0

6. 出错怎么办：
如果出错, 请添加 debug log：

acme.sh  --issue  .....  --debug

或者：

acme.sh  --issue  .....  --debug  2

请参考： https://github.com/Neilpang/acme.sh/wiki/How-to-debug-acme.sh

最后, 本文并非完全的使用说明, 还有很多高级的功能, 更高级的用法请参看其他 wiki 页面.

https://github.com/Neilpang/acme.sh/wiki

本文部份转载自：https://github.com/Neilpang/acme.sh/wiki/%E8%AF%B4%E6%98%8E
由比格高提供整合

在配置Nginx 的配置 ssl_certificate 时使用 fullchain.cer(这个地方就是web服务器配置的地方了,重要)

发表评论