密码学与证书 / 系统课时
把证书接入 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 配置为:
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:
sudo nginx -t && sudo systemctl reload nginx预期输出
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 本机配置正确也无法让公网用户得到这张证书。