密码学与证书 / 知识点
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.pemcertbot certificates 展示的证书名称、域名、有效期以及证书和私钥路径可用于确认申请结果。([Certbot文档][2])
风险与恢复
非交互模式不会替脚本补全缺失参数,也不会在遇到选择题时等待操作员,因此部署前应先验证 Nginx 配置、DNS 和挑战访问链路。若要在不保存正式证书的情况下验证申请流程,可针对 certonly 使用 --dry-run 连接测试环境;正式申请失败时先修复报错原因,再重新执行,不要通过反复申请来试探配置。([Certbot文档][1])
证书管理
测试与排障