Ubuntu 24.04 用 Certbot + 腾讯云 DNSPod 自动申请与续期通配符证书
本文记录在 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)o | Y |
Share email with EFF? (Y)es/(N)o | N |
看到下面的输出就说明签发成功:
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-challenge | DNS 传播时间不足,或主域名与通配符共用同名 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 悄悄失败却没人发现。
評論
還沒有評論,來說兩句吧