密码学与证书 / 知识点

Certbot 常用命令与参数速查

续期与自动化

CODE
certbot certonly --nginx -n --agree-tos -m EMAIL -d DOMAIN [-d DOMAIN] ...

在脚本或自动部署中关闭交互输入,并预先提供服务条款确认、联系邮箱和域名;所有必要参数必须完整,否则命令会直接失败而不会等待人工输入。

非交互申请证书

在无人值守脚本或自动部署中,用 -n 禁止 Certbot 等待交互输入,并提前提供服务条款确认、联系邮箱和全部目标域名。certonly 只申请或续订证书,不负责把证书安装到 Nginx 配置中。([Certbot文档][1])

基本语法

bash
certbot certonly --nginx -n --agree-tos -m EMAIL -d DOMAIN [-d DOMAIN] ...
  • --nginx:使用 Nginx 插件完成域名控制权验证,要求对应插件可用且现有 Nginx 配置可被 Certbot 处理。
  • -n:以非交互模式运行;缺少必需信息或出现需要人工选择的情况时直接失败。
  • --agree-tos:预先接受 ACME 服务条款,避免出现确认提示。
  • -m EMAIL:设置 ACME 账户联系邮箱。
  • -d DOMAIN:指定证书包含的域名,可重复提供多个域名。([Certbot文档][1])

常用示例

执行前应确认域名已解析到当前服务器,并且 Nginx 站点配置能够完成相应的 ACME 验证。下面一次申请两个域名:

bash
sudo certbot certonly --nginx -n --agree-tos -m admin@example.com -d example.com -d www.example.com
sudo certbot certificates

预期输出:申请成功后不会停下来等待人工确认,随后可在 Certbot 管理列表中看到包含两个域名的证书。有效期、剩余天数和实际路径会因执行环境而不同。

text
Found the following certificates:
  Certificate Name: example.com
    Domains: example.com www.example.com
    Expiry Date: <TIME> (VALID: <DAYS> days)
    Certificate Path: <PATH>/fullchain.pem
    Private Key Path: <PATH>/privkey.pem

certbot certificates 展示的证书名称、域名、有效期以及证书和私钥路径可用于确认申请结果。([Certbot文档][2])

风险与恢复

非交互模式不会替脚本补全缺失参数,也不会在遇到选择题时等待操作员,因此部署前应先验证 Nginx 配置、DNS 和挑战访问链路。若要在不保存正式证书的情况下验证申请流程,可针对 certonly 使用 --dry-run 连接测试环境;正式申请失败时先修复报错原因,再重新执行,不要通过反复申请来试探配置。([Certbot文档][1])

证书管理

测试与排障

目录与阅读设置

记录一个想法

Certbot 常用命令与参数速查

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

登录哪都通