用 nginx 给单站点配 HTTPS:从证书落地到 curl 验证的完整走一遍

以一个监听 80 的 nginx 站点为起点,走通证书签发、server 块配置、HTTP 跳转和验证四个环节,重点说清每个命令在看什么、验证失败时往哪里查。

本文目录
用 nginx 给单站点配 HTTPS:从证书落地到 curl 验证的完整走一遍

很多站点 HTTPS 配置"坏掉"的方式很隐蔽:浏览器能打开,但某个旧客户端连不上,或者证书签下来了、跳转写了,三个月后到期自动续期却悄悄失败。这篇文章把一个完整流程走一遍:证书从哪来、nginx 怎么引它、怎么确认它真的在工作。前置条件很朴素——一个已解析到你机器的域名、一台装了 nginx 的 Linux 机器、root 或 sudo 权限。

第一步:拿到证书

如果域名直接解析到这台机器,最简单的路径是 ACME 的 HTTP-01 验证。以 Let’s Encrypt 为例,certbot 这类客户端会在 nginx 上临时响应 /.well-known/acme-challenge/ 请求,验证通过后把证书和私钥落到本机(certbot 默认在 /etc/letsencrypt/live/域名/ 下)。

如果你要的是泛域名证书(*.example.com),HTTP-01 帮不了你,必须走 DNS-01——往 DNS 里写一条 TXT 记录证明控制权。手动改 TXT 记录续期时会逼疯人,这一步基本只适合自动化。

在 CertbotX 中实践:CertbotX 支持 DNS-01 的 CNAME 委托——你把 _acme-challenge.域名 用 CNAME 指到一个专门用于验证的域,主 DNS 区域不用开放 API 权限,签发和到期前的重新签发都由 ACME 流程自动完成。签出来的证书可以自动部署到 Agent、EdgeOne 或其他 CDN,每次部署留有记录可审计。对"主 DNS 在别家、不想给 API key"的场景,委托这条路能省掉不少权限谈判。

第二步:配置 nginx

用 nginx 给单站点配 HTTPS:从证书落地到 curl 验证的完整走一遍:DNS ownership verification using a delegated CNAME, shown as a precise handoff between two controlled zones
用 nginx 给单站点配 HTTPS:从证书落地到 curl 验证的完整走一遍:DNS ownership verification using a delegated CNAME, shown as a precise handoff between two controlled zones查看原图

证书落地后,改 server 块。核心就几行:

server {
    listen 443 ssl;
    server_name example.com;

    ssl_certificate     /etc/letsencrypt/live/example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;

    # 其余站点配置照旧
}

两个容易踩的坑:

  1. 用 fullchain.pem 而不是 cert.pem。只引叶子证书,部分客户端(尤其是安卓旧机型和某些 Java 客户端)会因为缺中间证书而握手失败,桌面 Chrome 却可能因为缓存了中间证书而一切正常——这种问题最难排查,因为"我这边好的"。
  2. HTTP 跳转单独写一个 server 块,不要在同一个块里又听 80 又听 443 再 if 判断:
server {
    listen 80;
    server_name example.com;
    return 301 https://$host$request_uri;
}

改完先 nginx -t 看语法,再 systemctl reload nginx。用 reload 而不是 restart,万一新配置有问题,旧 worker 还在服务。

第三步:验证,别只看浏览器

用 nginx 给单站点配 HTTPS:从证书落地到 curl 验证的完整走一遍:an ACME request being validated at separate stations and turned into a new deployable artifact while private key material remains at its origin
用 nginx 给单站点配 HTTPS:从证书落地到 curl 验证的完整走一遍:an ACME request being validated at separate stations and turned into a new deployable artifact while private key material remains at its origin查看原图

浏览器地址栏的锁是最弱的验证。更靠谱的几条命令:

# 看证书链和握手是否完整
openssl s_client -connect example.com:443 -servername example.com

# 看证书有效期
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null \
  | openssl x509 -noout -dates

# 看跳转是否生效
curl -I http://example.com

s_client 输出里找 Verify return code: 0 (ok)。如果是 21 (unable to verify the first certificate),八成就是上面说的 fullchain 问题。

最后一件常被忘掉的事:验证续期。ACME 证书有效期短,自动化续期不是可选项。确认你的签发工具有续期任务在跑(certbot 一般装了 systemd timer,用 systemctl list-timers | grep certbot 看),并且续期后能触发 nginx reload——证书文件换了但 nginx 不 reload,进程里用的还是旧证书。

到这里,一个站点的 HTTPS 才算真的"配完了",而不是"能打开"。

参考:

← 返回资讯中心