acme.sh免费https证书
date
Sep 12, 2020
URL
slug
acme.sh-https
status
Published
tags
https
证书
acme.sh
summary
acme.sh免费https证书
type
Post
安装acme.sh
或者
最好使用第二个命令，原因：wget 命令用来从指定的URL下载文件。wget非常稳定，它在带宽很窄的情况下和不稳定网络中有很强的适应性，如果是由于网络的原因下载失败，wget会不断的尝试，直到整个文件下载完毕。如果是服务器打断下载过程，它会再次联到服务器上从停止的地方继续下载。这对从那些限定了链接时间的服务器上下载大文件非常有用。
添加环境变量：
/etc/profile中添加alias acme.sh=~/.acme.sh/acme.sh，保存后执行source /etc/profile加载配置。生成证书
http
d参数后为需要生成https证书的域名，-webroot参数为网站跟目录， 然后自动完成验证.
apache服务器
nginx服务器
无web服务器,根据域名生成
dns
无需服务器
然后, acme.sh 会生成相应的解析记录显示出来, 你只需要在你的域名管理面板中添加这条 txt 记录即可.
等待解析完成之后, 重新生成证书:
dns 方式的真正强大之处在于可以使用域名解析商提供的api 自动添加 txt 记录完成验证.
acme.sh 目前支持 cloudflare, dnspod, cloudxns, godaddy 以及 ovh 等数十种解析商的自动集成.
以 dnspod 为例, 你需要先登录到 dnspod 账号, 生成你的 api id 和 api key, 都是免费的. 然后:
证书就会自动生成了. 这里给出的 api id 和 api key 会被自动记录下来, 将来你在使用dnspod api 的时候, 就不需要再次指定了. 直接生成就好了:
copy/安装证书
默认生成的证书都放在安装目录下:
~/.acme.sh/,请不要直接使用此目录下的文件, 例如: 不要直接让 nginx/apache 的配置文件使用这下面的文件. 这里面的文件都是内部使用, 而且目录结构可能会变化.正确的使用方法是使用
--install-cert 命令,并指定目标位置, 然后证书文件会被copy到相应的位置, 例如:Apache example:
Nginx example:
(一个小提醒, 这里用的是
service nginx force-reload, 不是 service nginx reload, 据测试, reload 并不会重新加载证书, 所以用的 force-reload)Nginx 的配置
ssl_certificate 使用 /etc/nginx/ssl/fullchain.cer ，而非 /etc/nginx/ssl/<domain>.cer ，否则 SSL Labs 的测试会报 Chain issues Incomplete 错误。-install-cert命令可以携带很多参数, 来指定目标文件. 并且可以指定 reloadcmd, 当证书更新以后, reloadcmd会被自动调用,让服务器生效.
Nginx配置
续期证书
目前证书在 60 天以后会自动更新, 你无需任何操作. 今后有可能会缩短这个时间, 不过都是自动的, 你不用关心.
更新acme.sh
目前由于 acme 协议和 letsencrypt CA 都在频繁的更新, 因此 acme.sh 也经常更新以保持同步.
升级 acme.sh 到最新版 :
如果你不想手动升级, 可以开启自动升级:
之后, acme.sh 就会自动保持更新了.
你也可以随时关闭自动更新:
错误
如果出错, 请添加 debug log：
或者：
请参考： https://github.com/Neilpang/acme.sh/wiki/How-to-debug-acme.sh
更高级的用法请参看其他 wiki 页面.
https://github.com/Neilpang/acme.sh/wiki
参考文档: