密码学与证书 / 系统课时

什么时候更适合 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 只负责在该目录写入挑战文件并申请证书:

bash
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

预期结果

text
证书签发成功
证书文件:<PATH>/fullchain.pem
私钥文件:<PATH>/privkey.pem

实际证书名称和路径可能因现有证书记录而不同,可以使用 certbot certificates 核对,不要仅根据域名猜测目录名称。

由 Nginx 明确引用证书

取得证书后,由你自己的 Nginx 模板或配置管理系统负责引用证书文件。下面是放在 Nginx http 上下文所包含站点配置中的片段示例,<PATH> 需要替换为 Certbot 实际给出的证书目录。

nginx
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:

bash
sudo nginx -t && sudo systemctl reload nginx

预期输出

text
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:

bash
sudo certbot renew --deploy-hook "nginx -t && systemctl reload nginx"

预期结果

text
未到续期时间:证书保持不变,不执行成功续期后的部署动作
成功续期:先通过 Nginx 配置检查,再重新加载 Nginx

生产环境若由 systemd timer、Cron 或其他平台统一调用 certbot renew,应把 reload 动作纳入同一套持久化自动化流程,而不是依赖管理员偶尔手工执行命令。

certonly 最有价值的地方不是减少一步命令,而是明确职责:Certbot 管理证书生命周期,Nginx 配置仍由现有部署系统管理。配置越复杂、自动化程度越高,这种边界通常越容易维护和审计。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

什么时候更适合 certonly

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通