密码学与证书 / 系统课时

用 --nginx 申请单域名证书

用 --nginx 申请单域名证书

对于已经通过 HTTP 正常提供服务的单域名站点,certbot --nginx 可以完成证书申请、域名验证和 Nginx 安装。本节以 example.com 为例,从申请前检查到 HTTPS 验证走完一次最小可用流程。

学习目标

  • 能判断单域名使用 Nginx 插件申请证书的前置条件
  • 能使用 --nginx 和 -d 完成指定域名的申请与安装
  • 能通过 HTTPS 请求验证部署是否真正生效

申请前确认站点满足条件

开始前,example.com 的 DNS A 或 AAAA 记录应指向当前对外提供服务的地址,公网请求需要能够通过 80 端口到达这台 Nginx。Nginx 配置中还应存在包含 server_name example.com; 的 Server Block,并且当前 HTTP 站点可以正常访问。

还要确认系统已经安装 Certbot 及 Nginx 插件。Nginx 插件使用 HTTP-01 完成常规域名验证,因此即使最终只准备开放 HTTPS,申请阶段也不能简单依靠修改 Certbot 的本地监听端口来绕过公网 80 端口要求。

申请并自动安装证书

先让 Nginx 完成配置语法检查,检查通过后再执行 Certbot。--nginx 指定 Nginx 插件负责验证与安装,-d example.com 则明确本次证书只包含这个域名。

bash
sudo nginx -t && sudo certbot --nginx -d example.com

预期输出

text
nginx: configuration file <PATH> test is successful
Successfully received certificate.
Successfully deployed certificate for example.com to <PATH>

<PATH> 会随系统安装方式和 Nginx 配置布局变化,Certbot 不同版本的提示文字也可能略有差异。判断成功的重点是:Nginx 配置检查通过、证书签发成功,并且证书已经部署到 example.com 对应的站点。

首次使用 Certbot 时,终端还可能要求填写联系邮箱、接受 ACME 服务条款等信息。完成后,Certbot 会保存证书和续期配置,并修改匹配的 Nginx Server Block,使站点能够通过 HTTPS 提供服务。

验证 HTTPS 已经生效

申请命令成功并不应成为唯一验收依据,还要从客户端真正建立一次 HTTPS 连接。下面让 curl 校验证书并只打印站点返回的 HTTP 状态码。

bash
curl -sS -o /dev/null -w '%{http_code}\n' https://example.com/

预期输出

text
<STATUS>

<STATUS> 取决于站点业务,常见值可能是 200、301、302 或其他正常响应码。关键是 curl 能完成 TLS 校验并返回 HTTP 状态,而不是出现证书名称不匹配、未知签发者或 TLS 握手失败等错误。

失败时按验证链路定位

如果第一条命令停在 nginx -t,问题属于 Nginx 配置,应先修复语法、重复监听或引用文件错误,不要继续申请证书。如果 Certbot 能读取配置但找不到目标站点,应检查 server_name 是否明确包含 example.com。

如果失败发生在 ACME 验证阶段,则重点检查 DNS 是否已经生效、80 端口是否能从公网访问,以及反向代理、CDN、防火墙或负载均衡器是否把 /.well-known/acme-challenge/ 请求送到了其他位置。对于不能让 HTTP-01 请求抵达当前 Nginx 的环境,应改用适合该网络结构的验证方式,而不是反复执行同一条 --nginx 命令。

单域名场景中,只要域名解析、80 端口、server_name 和 Nginx 配置都处于正确状态,sudo certbot --nginx -d example.com 就能把申请与部署合并为一次操作;最终仍应以真实 HTTPS 连接成功作为验收标准。

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

目录与阅读设置

阅读设置

17

记录一个想法

用 --nginx 申请单域名证书

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

登录哪都通