用 nginx 给单站点配 HTTPS:从证书落地到 curl 验证的完整走一遍
以一个监听 80 的 nginx 站点为起点,走通证书签发、server 块配置、HTTP 跳转和验证四个环节,重点说清每个命令在看什么、验证失败时往哪里查。
本文目录

很多站点 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

证书落地后,改 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;
# 其余站点配置照旧
}两个容易踩的坑:
- 用
fullchain.pem而不是cert.pem。只引叶子证书,部分客户端(尤其是安卓旧机型和某些 Java 客户端)会因为缺中间证书而握手失败,桌面 Chrome 却可能因为缓存了中间证书而一切正常——这种问题最难排查,因为"我这边好的"。 - 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 还在服务。
第三步:验证,别只看浏览器

浏览器地址栏的锁是最弱的验证。更靠谱的几条命令:
# 看证书链和握手是否完整
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.coms_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 才算真的"配完了",而不是"能打开"。
参考: