密码学与证书 / 系统课时
什么时候更适合 certonly
什么时候更适合 certonly
当 Nginx 配置复杂、入口经过反向代理,或者站点配置由 Ansible、模板系统、容器编排平台统一管理时,让 Certbot 自动改写 Nginx 往往不是最佳选择。certonly 可以把“申请证书”和“部署证书”拆开,让配置的所有权保持清晰。
学习目标
- 判断哪些场景更适合使用
certonly而不是让 Certbot 自动安装证书 - 理解认证方式与证书部署是两个可以独立选择的环节
- 手工引用 Certbot 证书文件,并正确处理续期后的 Nginx 加载
certonly 改变的是职责边界
certonly 的含义是只获取或续期证书,不替你把证书安装进 Web 服务器配置。它并不等于某一种域名验证方式:你仍然可以配合 --nginx、--webroot 或 DNS 插件完成域名控制权验证。
因此,选择 certonly 的核心理由通常不是“Certbot 不支持 Nginx”,而是你不希望 Certbot拥有 HTTPS 配置的最终控制权。
| 场景 | 更适合的方式 | 原因 |
|---|---|---|
| 普通单站点,Nginx 配置简单 | certbot --nginx |
自动申请和安装最省事 |
| Nginx 配置由模板或配置管理系统生成 | certonly |
避免人工工具修改自动生成文件 |
| 多层反向代理或共享入口 | certonly |
可以自行决定证书真正部署在哪一层 |
| 需要统一 TLS 参数、路径和发布流程 | certonly |
证书签发与配置发布职责分离 |
| 希望 Certbot 完全不参与 Nginx 配置修改 | certonly --webroot 或 DNS 插件 |
验证过程也可以与 Nginx 配置编辑解耦 |
用 Webroot 只申请证书
假设 Nginx 已经把 /.well-known/acme-challenge/ 映射到 /var/www/acme,可以让 Certbot 只负责在该目录写入挑战文件并申请证书:
sudo mkdir -p /var/www/acme/.well-known/acme-challenge
sudo certbot certonly --webroot -w /var/www/acme -d example.com -d www.example.com预期结果
证书签发成功
证书文件:<PATH>/fullchain.pem
私钥文件:<PATH>/privkey.pem实际证书名称和路径可能因现有证书记录而不同,可以使用 certbot certificates 核对,不要仅根据域名猜测目录名称。
由 Nginx 明确引用证书
取得证书后,由你自己的 Nginx 模板或配置管理系统负责引用证书文件。下面是放在 Nginx http 上下文所包含站点配置中的片段示例,<PATH> 需要替换为 Certbot 实际给出的证书目录。
server {
listen 443 ssl;
server_name example.com www.example.com;
ssl_certificate <PATH>/fullchain.pem;
ssl_certificate_key <PATH>/privkey.pem;
location / {
proxy_pass http://127.0.0.1:8080;
}
}配置文件本身不会因为保存成功就自动生效。发布配置后先检查语法,再重新加载 Nginx:
sudo nginx -t && sudo systemctl reload nginx预期输出
nginx: configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful如果 nginx -t 失败,后面的 reload 不会执行,这比直接重新加载错误配置更安全。
续期后还要让服务重新读取证书
使用 certonly 不会失去 Certbot 的续期能力。后续 certbot renew 会根据已经保存的证书续期配置选择相应认证方式,并更新 Certbot 管理的证书文件。
但 Nginx 已经运行的 worker 不会仅因为磁盘上的证书发生变化就自动重新读取它。自动化任务可以在成功续期后使用 deploy hook 检查并重新加载 Nginx:
sudo certbot renew --deploy-hook "nginx -t && systemctl reload nginx"预期结果
未到续期时间:证书保持不变,不执行成功续期后的部署动作
成功续期:先通过 Nginx 配置检查,再重新加载 Nginx生产环境若由 systemd timer、Cron 或其他平台统一调用 certbot renew,应把 reload 动作纳入同一套持久化自动化流程,而不是依赖管理员偶尔手工执行命令。
certonly 最有价值的地方不是减少一步命令,而是明确职责:Certbot 管理证书生命周期,Nginx 配置仍由现有部署系统管理。配置越复杂、自动化程度越高,这种边界通常越容易维护和审计。