cron配合acme.sh脚本自动申请自动续期证书

发布时间 2023-11-21 16:04:52作者: 学不会xuebuhui

准备工作

  • 已经解析过的域名,通过ping检查是否对应到ip
  • 防火墙端口是否开启

1. 安装

安装 acme.sh
bash

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

或者
bash

wget -O -  https://get.acme.sh | sh

执行上面的命令,它会:

从 GitHub 上下载 sh 脚本并执行
把文件解压到用户的 ~/.acme.sh目录下
给命令行设置一个acme.sh的 alias 别名
查看alias方法
image

最后注册一个 cron 定时任务来自动更新证书。
安装完成后要自行重启命令行,或者重新加载一下.bashrc文件(source ~/.bashrc)
image

2. 签发 SSL 证书

签发 SSL 证书需要证明这个域名是属于你的,即域名所有权,一般有两种方式验证:http 和 dns 验证。

通过 acme.sh 可以签发单域名、多域名、泛域名证书,还可以签发 ECC 证书。为了简单起见,这里以单域名证书为例,后面再拓展一下好了。

下面任意一种方式只要安装成功了就行!

注意:这一步只是生成了证书,并没有进行配置,因此访问网站当然上不了 https。

3. HTTP 验证 (重要,推荐)

这种方式 acme.sh 会自动在你的网站根目录下放置一个文件,来验证你的域名所有权,验证之后就签发证书,最后会自动删除验证文件。
前提是要绑定的域名已经绑定到了所在服务器上,且可以通过公网进行访问!

3.1.1 Webroot mode (网站根目录,即运行http服务的端口的目录)

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

acme.sh  --issue  -d example.com  -w /home/wwwroot/example.com

只需要指定域名, 并指定域名所在的网站根目录. acme.sh 会全自动的生成验证文件, 并放到网站的根目录, 然后自动完成验证. 最后会聪明的删除验证文件. 整个过程没有任何副作用.

3.1.2 Apache / Nginx mode

如果用的是 Apache 或者 Nginx 服务器,可以自动寻找根目录,并且生成检测文件。
bash

acme.sh  --issue  -d example.com  --apache  # Apache

acme.sh  --issue  -d example.com  --nginx   # Nginx

如果找不到配置文件的话可以自行配置。
bash

acme.sh  --issue  -d example.com  --nginx /etc/nginx/nginx.conf  # 指定nginx的conf

acme.sh  --issue  -d example.com  --nginx /etc/nginx/conf.d/example.com.conf  # 指定网站的conf

3.1.3 Standalone mode (推荐)

如果你还没有运行任何 web 服务, 80 端口是空闲的, 那么 acme.sh 还能假装自己是一个webserver, 临时听在80 端口, 完成验证,这种方式下,acme.sh 会自己建立一个服务器来完成签发。主要适合的是没有建立服务器的情况,不过其实有服务器的话只要暂时关闭,不造成端口冲突就能使用。
bash

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

如果用了反代之类的不是 80 端口,则可以手动指定。
bash

acme.sh  --issue  -d example.com  --standalone --httpport 88

当然它还支持 tls 模式,不是 443 端口的话也可以自行指定。
bash

acme.sh  --issue  -d example.com  --alpn
acme.sh  --issue  -d example.com  --alpn --tlsport 8443  # 自行指定tls端口

4. dns验证

dns验证需要验证txt记录,适用于申请通配符证书
dns有验证有两种途径,一种是手动解析域名,然后生成一个解析记录,给域名配置上一个txt记录就可以验证了,具体操作也可以参考上面提到的wiki,笔者曾尝试使用这种方法,不知道是姿势不对还是别的什么原因,没有任何返回任何值

dns验证的另一种途径是通过域名解析商提供的api来自动添加txt记录完成验证,目前支持dnspod、aliyun等数种域名解析商
通配符域名证书申请教程

实例分析:

  1. trojan 脚本一键申请ssl证书 ( https://github.com/acmesh-official/acme.sh/archive/master.tar.gz

    image
    https://github.com/acmesh-official/acme.sh
    image
    未完后续看情况补充

更新证书

证书的有效期为 90 天,acme.sh 会 60 天更新(Renew)一次。

在安装 acme.sh 的时候就自动配置了一条 cron 任务了,会每天检查证书的情况。当然可以到 crontab 里看一下。

bash

# crontab -l

43 0 * * * "/root/.acme.sh"/acme.sh --cron --home "/root/.acme.sh" > /dev/null

也可以试着用上面这条命令执行看一下相关的配置是否正确。

强制更新可以这样。

bash

acme.sh --renew -d example.com --force

acme.sh --renew -d example.com --force --ecc  # 如果用的是ECC证书

停止更新证书

查看证书列表
bash

acme.sh --list

停止 Renew

bash

acme.sh --remove -d example.com [--ecc]

之后手动把目录下的证书移除就行。

更新

实例:申请泛域名证书(通配符证书)
注意:通配符证书*.example.com不包括example.com