密码学与证书 / 系统课时

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 签发。

nginx
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 是否能够读取证书和私钥,同时验证整体配置语法。

bash
sudo nginx -t

预期输出

text
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。

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

目录与阅读设置

阅读设置

17

记录一个想法

Nginx 应该引用哪个证书文件

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

登录哪都通