Ubuntu 24.04 用 Certbot + 腾讯云 DNSPod 自动申请与续期通配符证书

2026-11-12 运维部署 有希 124 次瀏覽

本文记录在 Ubuntu 24.04 LTS 上用 Python 虚拟环境安装 Certbot,通过腾讯云 DNSPod API 3.0 完成 DNS-01 验证,为 example.com 与 *.example.com 申请 Let's Encrypt 通配符证书的完整过程。配置完成后,cron 会在每天凌晨 2:30 检查续期,续期成功才平滑重载 Nginx。

为什么选 DNS-01 + 通配符证书

  • 支持通配符:一次签发覆盖 *.example.com,以后加子域名不用重新申请
  • 不占用 80 端口:DNS 验证只写 TXT 记录,适合 80 端口被占用或无法临时放行的服务器
  • 可全自动:腾讯云 DNSPod 提供 API,插件能自动增删 _acme-challenge 记录

DNS-01 验证的是域名控制权,不改变服务器本身是否可达;证书签发后仍要部署到 Web 服务里。

一、准备工作

项目要求
操作系统Ubuntu 24.04 LTS(noble)
域名已托管在腾讯云 DNSPod,解析正常
权限sudo 或 root
DNS 插件certbot-dns-dnspod-109(适配腾讯云 API 3.0)
证书目录/etc/letsencrypt/live/example.com/

下文统一用 example.com 举例,实际操作时替换成你自己的域名。

二、用虚拟环境安装 Certbot

把 Certbot 装在 Python 虚拟环境里,既不污染系统 Python,后续升级和回滚也更省心。

sudo apt update
sudo apt install python3-venv -y

python3 -m venv ~/certbot-venv
source ~/certbot-venv/bin/activate

pip install --upgrade pip
pip install certbot certbot-dns-dnspod-109

关键点:腾讯云 API 3.0 的 SecretId 以 AKID 开头,必须配合 certbot-dns-dnspod-109。旧版 certbot-dns-dnspod 只认旧版 Token,填 API 3.0 密钥会直接报 401。

三、创建腾讯云 API 密钥

不要用主账号密钥。建议在腾讯云 CAM 控制台新建子用户,只授予 QcloudDNSPodFullAccess 权限,再生成 API 3.0 密钥。

把密钥写入凭证文件:

mkdir -p ~/.secrets/certbot
nano ~/.secrets/certbot/dnspod-109.ini

文件内容只有两行:

dns_dnspod_109_secret_id = 你的SecretId
dns_dnspod_109_secret_key = 你的SecretKey

随后收紧权限,并确认结果:

chmod 600 ~/.secrets/certbot/dnspod-109.ini
chmod 700 ~/.secrets ~/.secrets/certbot
ls -l ~/.secrets/certbot/dnspod-109.ini
# 预期:-rw------- 1 ubuntu ubuntu ... dnspod-109.ini

安全提示:凭证文件不要提交到 Git,也不要上传到任何公开位置。一旦泄露,立刻在 CAM 控制台禁用密钥并重新生成。

四、卸载系统中的旧 Certbot(可选)

如果之前用 apt 装过 Certbot,建议卸载,避免两个版本争抢命令和配置目录。

apt list --installed | grep certbot
sudo apt purge -y certbot python3-certbot
sudo apt autoremove -y && sudo apt autoclean -y

apt purge 询问是否删除 /etc/letsencrypt 时要选择保留,否则已有的证书和续期配置会一起被删掉。

验证一下:

dpkg -l | grep certbot   # 应无输出

如果当前已激活虚拟环境,which certbot 仍会显示 ~/certbot-venv/bin/certbot,这是正常的。

五、申请通配符证书

Certbot 默认要写 /var/log/letsencrypt/,普通用户没有权限。下面两种方式选一种即可。

方式 A:使用 sudo(推荐)

sudo /home/ubuntu/certbot-venv/bin/certbot certonly 
  --authenticator dns-dnspod-109 
  --dns-dnspod-109-credentials /home/ubuntu/.secrets/certbot/dnspod-109.ini 
  --dns-dnspod-109-propagation-seconds 60 
  -d example.com 
  -d "*.example.com"

重要:sudo 下 ~ 会被解析成 /root,所以虚拟环境、凭证文件都要写绝对路径(/home/ubuntu/...),否则会提示找不到文件。

方式 B:不用 sudo,改用自定义目录

mkdir -p ~/certbot-data/{config,work,logs}

certbot certonly 
  --config-dir ~/certbot-data/config 
  --work-dir ~/certbot-data/work 
  --logs-dir ~/certbot-data/logs 
  --authenticator dns-dnspod-109 
  --dns-dnspod-109-credentials ~/.secrets/certbot/dnspod-109.ini 
  --dns-dnspod-109-propagation-seconds 60 
  -d example.com 
  -d "*.example.com"

方式 B 以后每次续期也要带同样的三个目录参数,否则 Certbot 找不到证书。生产环境更推荐方式 A。

交互提示怎么填

提示输入
Enter email address你的邮箱,用于证书到期提醒
Do you agree? (Y)es/(N)oY
Share email with EFF? (Y)es/(N)oN

看到下面的输出就说明签发成功:

Successfully received certificate.
Certificate is saved at: /etc/letsencrypt/live/example.com/fullchain.pem
Key is saved at: /etc/letsencrypt/live/example.com/privkey.pem

六、常见报错与处理

报错原因解决
Permission denied: '/var/log/letsencrypt/.certbot.lock'普通用户没有系统目录写权限用 sudo,或按方式 B 指定可写目录
Incorrect TXT record ... found at _acme-challengeDNS 传播时间不足,或主域名与通配符共用同名 TXT 记录把 --dns-dnspod-109-propagation-seconds 加到 120 或 180,必要时分两次单独申请
too many failed authorizations recently短时间验证失败过多,触发 Let's Encrypt 速率限制先排查 TXT 与解析,等待约 1 小时再重试
certbot: command not found虚拟环境没激活,或 sudo 后 PATH 不含虚拟环境source ~/certbot-venv/bin/activate,或直接用绝对路径

排查固定按三步走:先确认 TXT 记录已写入,再用 dig 确认解析生效,最后才重试签发。盲目重试最容易触发限流。

七、配置自动续期

Let's Encrypt 证书有效期 90 天,Certbot 会在剩余时间不足 30 天时自动续期,不需要每天强制签发。

1. 确认续期配置里的凭证路径

sudo cat /etc/letsencrypt/renewal/example.com.conf | grep -i credentials

预期输出:

dns_dnspod_109_credentials = /home/ubuntu/.secrets/certbot/dnspod-109.ini

该文件属于 ubuntu 用户、权限 600,但 cron 以 root 运行,读取不受影响。

2. 续期演练(必做)

sudo /home/ubuntu/certbot-venv/bin/certbot renew --dry-run

看到 Congratulations, all simulated renewals succeeded 才说明链路完整。--dry-run 不会替换证书,也不会触发 --post-hook。

3. 添加 cron 任务

sudo crontab -e

写入一行:

30 2 * * * /home/ubuntu/certbot-venv/bin/certbot renew --quiet --post-hook "/usr/sbin/nginx -t && /usr/sbin/nginx -s reload" >> /var/log/certbot-renew.log 2>&1

几个细节:

  • 全部用绝对路径:cron 的 PATH 很精简,certbot、nginx 都要写绝对路径(用 which nginx 确认)
  • 先检查再重载:nginx -t && nginx -s reload,配置有问题时不会把线上服务带挂
  • 只有真正续期成功才触发 hook:未到期和 --dry-run 都不会执行 hook
  • 用 Apache 的话,hook 换成 /usr/bin/systemctl reload apache2

4. 查看证书与续期日志

sudo /home/ubuntu/certbot-venv/bin/certbot certificates
sudo tail -f /var/log/certbot-renew.log

八、在 Nginx 中引用证书

ssl_certificate     /etc/letsencrypt/live/example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;

live/ 下是软链接,真实文件在 archive/ 目录,root 运行的 Web 服务默认可读。

保存后先检查再重载:

sudo nginx -t && sudo nginx -s reload

验证证书是否生效:

curl -I https://example.com
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null | openssl x509 -noout -subject -dates

九、收尾与检查清单

配置完成后可以退出虚拟环境:

deactivate

cron 通过绝对路径调用,不依赖 shell 状态。上线前逐项确认:

  • 凭证文件权限 600,属主正确
  • renewal 配置里的凭证路径与 cron 使用的一致
  • certbot renew --dry-run 成功
  • cron 行里 certbot 与 nginx 都是绝对路径
  • Nginx 已引用 live/ 下的证书并成功 reload
  • 已用 curl 或 openssl s_client 验证线上证书

附:路径速查

项目路径
虚拟环境/home/ubuntu/certbot-venv/
Certbot 可执行文件/home/ubuntu/certbot-venv/bin/certbot
DNS 凭证文件/home/ubuntu/.secrets/certbot/dnspod-109.ini
证书链/etc/letsencrypt/live/example.com/fullchain.pem
私钥/etc/letsencrypt/live/example.com/privkey.pem
续期配置/etc/letsencrypt/renewal/example.com.conf
续期日志/var/log/certbot-renew.log

证书自动化只是起点。上线后建议再加一条到期监控:在到期前 14 天检查一次剩余天数,避免 cron 悄悄失败却没人发现。

評論

登入後即可參與評論

還沒有評論,來說兩句吧