密码学与证书 / 知识点

Certbot 常用命令与参数速查

基础查询

CODE
certbot [SUBCOMMAND] [options] [-d DOMAIN] [-d DOMAIN] ...

Certbot 命令由子命令、全局选项和域名参数组成;不确定具体操作时,可先从这个结构判断需要使用申请、续期还是管理类子命令。

Certbot 通用命令结构

用这条结构先判断“要做什么”,再补对应选项和域名。SUBCOMMAND 决定操作类型,options 控制验证方式、插件或运行行为,-d 用于声明证书应覆盖的域名;同一张证书包含多个域名时可重复使用 -d。

基本语法

bash
certbot [SUBCOMMAND] [options] [-d DOMAIN] [-d DOMAIN] ...

这是一条 synopsis,不应把方括号或 DOMAIN 原样输入。方括号表示该部分按场景选择,末尾省略号表示 -d DOMAIN 可以重复出现。

子命令与参数怎么组合

常见操作可按目的区分:申请但不自动安装证书时使用 certonly,检查并续期已管理证书时使用 renew,查看现有证书时使用 certificates,撤销或删除证书则分别进入对应的管理子命令。不同子命令接受的选项并不完全相同,应以当前安装版本的帮助信息为准。

-d DOMAIN 是可重复参数。例如一张证书同时覆盖主域名与 www 域名时,需要分别提供两个 -d。域名必须是实际希望写入证书的名称,不能把 URL、协议前缀或路径放进去。

安全主示例

先用只读的证书列表命令确认当前 Certbot 管理了哪些证书,再决定是否执行申请、续期或删除操作。

bash
certbot certificates

预期输出:如果本机存在由 Certbot 管理的证书,会显示证书名称、所含域名和有效期等信息;具体文本随版本和证书状态变化,结构类似:

text
Found the following certs:
  Certificate Name: <CERT_NAME>
  Domains: <DOMAIN_LIST>
  Expiry Date: <TIME>

如果当前没有可列出的证书,命令会给出相应提示,而不会新建或修改证书。

风险与边界

通用结构本身不代表命令一定安全:申请、安装、撤销和删除类操作可能触发 ACME 请求、修改 Web 服务器配置或改变本地证书状态。执行前先确认子命令、域名和插件选择,尤其不要把生产域名直接套入来源不明的示例。只想确认语法时优先查看帮助;要测试续期链路时使用该子命令提供的测试机制,而不是反复发起真实签发请求。

证书申请与安装

续期与自动化

目录与阅读设置

记录一个想法

Certbot 常用命令与参数速查

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

登录哪都通