密码学与证书 / 系统课时
用 --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 则明确本次证书只包含这个域名。
sudo nginx -t && sudo certbot --nginx -d example.com预期输出
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 状态码。
curl -sS -o /dev/null -w '%{http_code}\n' https://example.com/预期输出
<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 连接成功作为验收标准。