密码学与证书 / 系统课时

为什么申请多个域名要写多个 -d

为什么申请多个域名要写多个 -d

一张证书可以同时覆盖多个域名,但 Certbot 只会把你明确交给它的 DNS 名称写进申请,不会因为这些名称看起来相关就自动补齐。本节用一次多域名申请说明 -d 与证书 SAN 的对应关系,并教你验证最终覆盖范围。

学习目标

  • 理解 -d 声明的是证书必须包含的 DNS 名称。
  • 能用重复的 -d 参数申请一张多域名证书并核对结果。
  • 知道哪些相似域名仍然需要分别显式指定。

-d 实际声明的是什么

在 Certbot 中,-d(--domains)表示本次证书申请要包含的域名。写三个 -d 并不是申请三张证书,而是把三个 DNS Name 放进同一张证书的 Subject Alternative Name(SAN)集合。

例如 example.com、www.example.com 和 api.example.com 是三个不同的 DNS Name。即使它们属于同一个主域名,也不会因为申请了其中一个就自动获得另外两个的覆盖。

Certbot 的 Nginx 插件在交互模式下可以从 server_name 中发现候选域名供你选择,但它不会根据“同站点”“同主域”之类的业务关系自动猜测还应该包含哪些名称。最终需要哪些名称,仍由证书申请明确指定。

用一张证书覆盖三个域名

假设三个域名都已经解析到当前服务器,并且 Nginx 可以通过 80 端口完成 HTTP-01 验证,可以显式列出全部名称:

bash
sudo certbot certonly --nginx \
  -d example.com \
  -d www.example.com \
  -d api.example.com

sudo certbot certificates

预期输出中应能看到同一个证书条目包含三个域名;证书有效期和实际保存路径会因环境而不同:

text
Successfully received certificate.
Certificate Name: example.com
Domains: example.com www.example.com api.example.com
Expiry Date: <TIME>
Certificate Path: <PATH>
Private Key Path: <PATH>

重复写 -d 是最清晰的多域名写法。Certbot 也允许在一次 -d 中使用逗号分隔多个名称,但无论采用哪种写法,关键都不是参数出现几次,而是所有希望证书覆盖的 DNS Name 都必须出现在请求中。

为什么相似域名也不能省略

普通证书中的 example.com 不会自动覆盖 www.example.com,www.example.com 也不会覆盖 api.example.com。浏览器校验证书时,会把访问主机名与证书 SAN 中的名称进行匹配;SAN 中没有对应名称,就可能出现主机名不匹配错误。

因此,准备多域名证书时应先列出真实需要提供 HTTPS 的主机名,再逐一放入 -d。不要把 DNS 解析关系、Nginx 的 Server Block 关系或“这些域名都属于同一家公司”误当成证书的自动继承规则。

什么时候应该重新检查域名列表

上线前、增加新子域名或调整站点入口时,都应重新执行 certbot certificates 核对 Domains。如果目标名称没有出现在该列表中,就不要假设证书已经覆盖它;应重新申请包含完整目标名称集合的证书。

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

目录与阅读设置

阅读设置

17

记录一个想法

为什么申请多个域名要写多个 -d

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

登录哪都通