【运维开发】acme.sh安装|签发泛域名SSL证书,宝塔Nginx部署+自动续期

写在前面:本博客仅作记录学习之用,部分图片来自网络,如需引用请注明出处,同时如有侵犯您的权益,请联系删除!


前言

大陆服务器直接拉取GitHub安装acme.sh极易超时失败,本文使用Gitee国内镜像完整部署;通过腾讯云API自动解析验证申请*.域名泛域名证书,踩坑解决宝塔证书目录权限不足问题,配置定时任务实现90天证书自动续签,全程实操命令可直接复制。

Gitee国内镜像安装acme.sh

官方说明文档:https://github.com/acmesh-official/acme.sh/wiki/Install-in-China
国内服务器访问Github不稳定,直接使用Gitee镜像克隆安装。

在这里插入图片描述

克隆源码并安装

# 拉取Gitee国内镜像仓库,邮箱不改也可执行
git clone https://gitee.com/neilpang/acme.sh.git
cd acme.sh
./acme.sh --install -m my@example.com  

加载环境变量,验证安装

安装完成后无法直接识别acme.sh命令,重载环境变量:

# 刷新bash配置,查看版本验证是否安装成功
source ~/.bashrc
acme.sh --version

成功输出示例:

在这里插入图片描述

配置腾讯云API密钥,自动DNS验证泛域名证书

生成腾讯云API密钥

一般不推荐使用主账户进行操作,因为一旦泄露会导致账户的面临无法预测的损失。因此推荐子用户的权限,对权限进行限制,即便泄露也为无法影响到未授权的部分。

  • 新建用户
    在这里插入图片描述
    在这里插入图片描述
    在这里插入图片描述
  • 设置权限,给个DNS解析就行
    在这里插入图片描述
    在这里插入图片描述
    在这里插入图片描述
  • 创建子账户API密钥
    在这里插入图片描述
    在这里插入图片描述

在这里插入图片描述

API密钥只有在创建时可见,所有妥善保存,同时请勿外泄。

持久化配置腾讯云密钥

泛域名证书

*.你的域名

无法使用HTTP文件验证,必须DNS解析验证,acme.sh内置腾讯云DNS插件

dns_tencent

。
在这里插入图片描述

由于后续对宝塔的密钥文件进行更改,但需管理员权限sudo acme.sh是行不通的,因此建议在root用户进行下列操作,将其保存未环境变量。

sudo su

编辑bash环境变量文件,永久保存SecretId、SecretKey:

nano ~/.bashrc

文件末尾追加下面两行,替换为自己腾讯云密钥:

export Tencent_SecretId="xxxx"
export Tencent_SecretKey="xxx"

保存退出后重载生效:

source ~/.bashrc
# 校验环境变量是否写入成功
echo $Tencent_SecretId

在这里插入图片描述

一键申请根域名+泛域名证书

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

工具会自动调用腾讯云API添加_acme-challenge解析记录,自动完成域名校验并签发证书。

证书部署至宝塔Nginx

宝塔面板证书统一存放目录:

/www/server/panel/vhost/cert/域名/

普通ubuntu用户无该目录写入权限,直接执行部署命令会出现权限报错,所以提前激活root:

touch: cannot touch '/www/server/panel/vhost/cert/域名/privkey.pem': Permission denied

在这里插入图片描述

部署操作

root下执行证书部署命令

acme.sh --installcert -d 域名 \
--key-file    /www/server/panel/vhost/cert/域名/privkey.pem \
--fullchain-file /www/server/panel/vhost/cert/域名/fullchain.pem \
--reloadcmd     "/www/server/nginx/sbin/nginx -s reload"

成功执行日志参考:
在这里插入图片描述

校验证书文件生成

查看证书目录文件权限:

ls -la /www/server/panel/vhost/cert/域名/

输出结果:
在这里插入图片描述

配置证书自动续期,Cron定时任务

acme.sh安装时自动为root生成定时任务,每日检测证书有效期,剩余30天自动续签,自动重载Nginx。

查看定时任务

crontab -l

能看到acme.sh自带定时脚本:

34 15 * * * "/root/.acme.sh"/acme.sh --cron --home "/root/.acme.sh" > /dev/null

在这里插入图片描述

手动测试自动续期逻辑

/root/.acme.sh/acme.sh --cron --home /root/.acme.sh

未到续期时间输出日志:
在这里插入图片描述

强制手动续签

/root/.acme.sh/acme.sh --renew -d 域名 --force

在这里插入图片描述


总结

总结: 本文介绍了通过Gitee国内镜像安装acme.sh工具,利用腾讯云API实现泛域名证书的自动DNS验证与申请。针对宝塔面板证书目录权限问题,提供了root用户部署方案,并配置定时任务实现90天自动续签。


致谢

欲尽善本文,因所视短浅,怎奈所书皆是瞽言蒭议。行文至此,诚向予助与余者致以谢意。


参考

[1] https://github.com/acmesh-official/acme.sh/wiki/Install-in-China
[2] 腾讯云-创建子账号并授权

发表评论

滚动至顶部