密码学与证书 / 系统课时
Nginx 应该引用哪个证书文件
Nginx 应该引用哪个证书文件
Certbot 为同一张证书保存了多个 PEM 文件,Nginx 并不是任选两个就能完成 TLS 配置。实际部署时,服务器证书通常引用 fullchain.pem,私钥引用 privkey.pem,并让路径始终指向 Certbot 管理的 live 目录。
学习目标
- 区分
cert.pem、chain.pem、fullchain.pem与privkey.pem的用途 - 正确配置 Nginx 的
ssl_certificate与ssl_certificate_key - 理解为什么生产配置应引用
live目录而不是固定的归档文件
Nginx 实际需要哪两个文件
一套典型 Certbot 证书目录包含四类文件。对普通 Nginx HTTPS 站点而言,真正需要配置的是 fullchain.pem 和 privkey.pem。
| 文件 | 内容 | Nginx 常见用途 |
|---|---|---|
cert.pem |
当前站点的叶子证书 | 通常不单独作为 ssl_certificate 使用 |
chain.pem |
CA 提供的中间证书链 | 某些验证或额外信任配置可能使用 |
fullchain.pem |
叶子证书加中间证书链 | 配置 ssl_certificate |
privkey.pem |
与叶子证书匹配的私钥 | 配置 ssl_certificate_key |
浏览器建立 TLS 连接时,不仅要收到站点自己的证书,还需要能够沿中间证书构建信任链。因此只把 cert.pem 交给客户端,可能造成部分客户端无法正确验证证书链。fullchain.pem 已把服务器证书和所需中间证书组合好,更适合作为 Nginx 对外发送的证书文件。
配置 Nginx 的证书路径
下面是一个最小的 HTTPS Server Block 片段。示例中的 example.com 应替换成 Certbot 实际使用的证书名称,该名称不一定与当前访问域名完全相同。
片段示例:以下配置需要放入现有 Nginx server 块或站点配置文件中,并假设证书已经由 Certbot 签发。
server {
listen 443 ssl;
server_name example.com www.example.com;
ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
}配置完成后,先检查 Nginx 是否能够读取证书和私钥,同时验证整体配置语法。
sudo nginx -t预期输出
nginx: the configuration file <PATH> syntax is ok
nginx: configuration file <PATH> test is successful其中 <PATH> 是当前系统实际加载的 Nginx 配置文件路径,具体值可能不同。检查成功后才能执行 reload,避免因为路径写错或权限问题使正在运行的站点受到影响。
为什么路径要指向 live 目录
Certbot 通常把证书的具体历史版本保存在 archive 目录,再通过 live/<证书名称>/ 下的链接暴露当前有效版本。续期生成新版本后,Certbot 可以更新这些链接,而 Nginx 配置中的文件名保持不变。
因此不要把 Nginx 固定到类似 archive/example.com/fullchain1.pem、fullchain2.pem 这样的版本文件。这样做虽然短期可以工作,但后续 Certbot 产生新版本时,Nginx 仍会读取旧文件,自动续期就失去了意义。
什么时候需要重新检查路径
如果重新申请证书时改变了证书名称,Certbot 可能创建新的 live 子目录,例如在名称冲突时产生不同的证书 lineage。此时应以 certbot certificates 显示的 Certificate Path 和 Private Key Path 为准,再核对 Nginx 配置。
日常续期并不要求反复修改 Nginx 中的文件名。只要配置持续引用正确的 live 目录,并在证书更新后让 Nginx 重新加载配置,就能让服务稳定使用 Certbot 当前维护的 fullchain.pem 与 privkey.pem。