如何给自己的网站域名生成永久的免费证书,acme.sh开源项目了解一下
现在很多地方都有免费证书,但是基本上都有期限,
比如:
阿里云免费证书就是固定1年,然后失效,
虽然重新生成步骤简单,但也不是一个成熟程序员该做的事
git:
https://github.com/acmesh-official/acme.sh
https://github.com/acmesh-official/acme.sh/wiki/%E8%AF%B4%E6%98%8E
acme.sh 实现了 acme 协议, 可以从 Let's Encrypt、ZoreSSL、buypass、sslcom 生成免费的证书。
进入步骤:
1.安装 acme.sh
以下三种任选一种即可,把 [email protected] 修改成自己的邮箱。
安装过程不会污染任何功能和文件,所有的修改都限制在安装目录中:
~/.acme.sh/
a.通过 https://get.acme.sh 安装
curl https://get.acme.sh | sh -s [email protected]
或者
wget -O - https://get.acme.sh | sh -s [email protected]
b.通过 GitHub 安装
curl https://raw.githubusercontent.com/acmesh-official/acme.sh/master/acme.sh | sh -s -- --install-online -m [email protected]
或者
wget -O - https://raw.githubusercontent.com/acmesh-official/acme.sh/master/acme.sh | sh -s -- --install-online -m [email protected]
c.通过 git clone 安装
# 使用加速通道
git clone https://github.com.cnpmjs.org/acmesh-official/acme.sh.git
cd acme.sh
./acme.sh --install -m [email protected]
安装过程进行了以下几步:
(1)acme.sh 安装到 home 目录下
~/.acme.sh/
(2)创建一个 bash 的 alias
alias acme.sh=~/.acme.sh/acme.sh
(3)创建 cronjob,每天 0:00 自动检测所有证书,如果快过期了,会自动更新证书。
2.生成证书
以下两种任选一种即可,把 mydomain.com 更换成自己的域名。
如何生成泛域名证书,请参阅 使用 acme.sh 生成免费的泛域名证书
(1)http 方式
指定域名,并指定网站根目录。 acme.sh 会全自动生成验证文件,并放到网站的根目录,自动完成验证。最后会删除验证文件,整个过程没有任何副作用。
acme.sh --issue -d mydomain.com -d www.mydomain.com --webroot /home/wwwroot/mydomain.com/
如果使用 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 不会自动修改配置文件,需要手动修改配置文件,否则无法访问 https
如果还没有运行任何 web 服务,80 端口是空闲的,那么 acme.sh 还能假装自己是一个 webserver,临时监听 80 端口,完成验证:
acme.sh --issue -d mydomain.com --standalone
(2)DNS 方式
好处:
不需要任何服务器, 不需要任何公网 IP, 只需要 DNS 的解析记录即可完成验证。
坏处:
如果不同时配置 Automatic DNS API 则 acme.sh 将无法自动更新证书。
acme.sh --issue --dns -d mydomain.com \
--yes-I-know-dns-manual-mode-enough-go-ahead-please
acme.sh 会生成相应的解析记录,到域名解析中添加 TXT 记录,解析成功后,重新生成证书。
acme.sh --renew -d mydomain.com \
--yes-I-know-dns-manual-mode-enough-go-ahead-please
DNS 方式的真正强大之处在于可以使用域名解析商提供的 api 自动添加 TXT 记录完成验证。
acme.sh 目前支持几十种域名服务商:
https://github.com/acmesh-official/acme.sh/wiki/dnsapi
以 dnspod 为例, 需要先登录到 dnspod 账号, 生成 api id 和 api key
export DP_Id="1234"
export DP_Key="qwertyuiopasdfghjkl"
acme.sh --issue --dns dns_dp -d mydomain.com -d www.mydomain.com
acme.sh 会自动生成证书,并且会记录 api id 和 api key 以后再使用 dnspod api 时就不需要再指定了。
3.复制/安装 证书
注意!默认生成的证书都放在安装目录下:
~/.acme.sh/,不要直接使用此目录下的文件,这里面的文件都是内部使用, 而且目录结构可能会变化。
正确的使用方法是使用 --install-cert 命令,指定目标位置,证书文件会被复制到相应的位置。
Apache
acme.sh --install-cert -d example.com \
--cert-file /path/to/certfile/in/apache/cert.pem \
--key-file /path/to/keyfile/in/apache/key.pem \
--fullchain-file /path/to/fullchain/certfile/apache/fullchain.pem \
--reloadcmd "service apache2 force-reload"
Nginx
acme.sh --install-cert -d example.com \
--key-file /path/to/keyfile/in/nginx/key.pem \
--fullchain-file /path/to/fullchain/nginx/cert.pem \
--reloadcmd "service nginx force-reload"
4.更新证书
证书在 60 天以后会自动更新,无需任何操作。
5.更新 acme.sh
升级 acme.sh 到最新版
acme.sh --upgrade
如果不想手动升级,也可以开启自动升级
acme.sh --upgrade --auto-upgrade
关闭自动更新
acme.sh --upgrade --auto-upgrade 0
6.出错怎么办
在命令后添加 --debug 或 --debug 2 比如:
acme.sh --issue -d mydomain.com --nginx --debug
或
acme.sh --issue -d mydomain.com --nginx --debug 2
或者查阅日志
~/.acme.sh/acme.sh.log
完
相关文章