密码学与证书 / 系统课时

把证书接入 Nginx HTTPS

把证书接入 Nginx HTTPS

这一练习把 Certbot 已签发的证书真正交给 Nginx 使用:在 443 Server Block 中引用完整证书链和私钥,先用 nginx -t 检查路径与语法,再安全重载配置。完成后,Nginx 才会在 TLS 握手中向客户端提供正确证书。

学习目标

  • 正确区分并配置 Certbot 的完整证书链与私钥文件。
  • 为站点建立可用的 443 HTTPS Server Block。
  • 使用 nginx -t 在重载前发现证书路径、权限或配置错误。

配置 443 Server Block

下面以域名 example.com、站点目录 /var/www/example 为例。Certbot 常把当前生效证书暴露在 /etc/letsencrypt/live/<证书名称>/ 下,其中 fullchain.pem 是服务器证书加中间证书链,privkey.pem 是对应私钥。Nginx 应引用 live 目录中的当前文件,不要固定指向 archive 目录里的某个历史编号。

把站点的 HTTPS Server Block 配置为:

nginx
server {
    listen 443 ssl;
    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;

    root /var/www/example;
    index index.html;

    location / {
        try_files $uri $uri/ =404;
    }
}

这段配置的关键关系是:ssl_certificate 必须指向可发送给客户端的完整证书链,ssl_certificate_key 必须指向与该证书匹配的私钥。若 Certbot 实际创建的证书名称不是 example.com,应按签发时显示的真实 live 路径修改,不能只根据域名猜目录名。

验证后再重载

保存配置后,先做语法和证书加载检查,只有检查成功才重载 Nginx:

bash
sudo nginx -t && sudo systemctl reload nginx

预期输出

text
nginx: the configuration file <PATH> syntax is ok
nginx: configuration file <PATH> test is successful

<PATH> 是当前系统实际使用的 Nginx 主配置文件路径,可能与发行版有关。systemctl reload nginx 成功时通常不会额外输出;如果 nginx -t 失败,&& 会阻止重载,旧配置继续提供服务。

处理最常见的失败

若检查时报 cannot load certificate,优先确认 fullchain.pem 路径是否存在且证书名称是否写对。若提示私钥无法加载或证书与私钥不匹配,应回到 Certbot 生成的同一套 live 目录,不要从不同证书目录混搭文件。

nginx -t 成功只说明 Nginx 能解析并加载配置。正式切换后还应从客户端访问 https://example.com,确认浏览器看到的域名与证书覆盖范围一致;如果 DNS 指向错误主机,Nginx 本机配置正确也无法让公网用户得到这张证书。

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

目录与阅读设置

阅读设置

17

记录一个想法

把证书接入 Nginx HTTPS

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

登录哪都通