Nginx HTTPS 证书配置实战:从 CSR 签发到 398 天有效期管理与过期排查
问题背景与根因:HTTPS 故障为什么总是这三类
浏览器与生态已经把 HTTPS 变成硬门槛:Chrome、Edge 对 http:// 页面在地址栏标记「不安全」;微信小程序要求所有请求域名必须使用 HTTPS,且 TLS 版本不低于 1.2、证书必须由受信任 CA 签发,自签名证书一律被拒;iOS 的 ATS 默认阻断明文请求。国内还多一道前置条件——域名必须完成 ICP 备案,否则 443 端口即便配通,小程序侧仍会报域名不合法。
在一线排查中,90% 以上的 HTTPS 故障可以归到三类根因:
第一类,证书链不完整。运维只把域名证书 cert.pem 部署到 ssl_certificate,没有带上中间证书。桌面浏览器会通过证书里的 AIA 地址自动补链,于是「电脑上能打开」,但 Android WebView、微信内置浏览器、Java 的 HttpClient 没有这个补链行为,直接握手失败。这类问题占「浏览器正常、小程序报错」的绝大多数。
第二类,证书过期。自 2020-09-01 起,公有 CA 签发的 TLS 证书最长有效期被限制为 398 天,Let’s Encrypt 免费证书只有 90 天;CA/Browser Forum 已通过逐步缩短方案(2026-03 起 200 天、2027-03 起 100 天、2029-03 起 47 天)。靠人工日历提醒续期,在 398 天甚至 47 天周期下必然出错。
第三类,链路与端口。云主机安全组未放行 443、系统 firewalld/ufw 拦截、Nginx 只监听 80、反向代理 upstream 仍写 http 导致 502。
还有一类是「过时教程残留」:大量文章仍在写 listen 443 ssl http2;(Nginx 1.25.1 起该写法已废弃,需拆成 listen 443 ssl; 加 http2 on;),以及给 Let’s Encrypt 证书配置 OCSP stapling(LE 已于 2025 年停止提供 OCSP 响应,配置后只会得到警告)。下文按选型、CSR、签发、配置、排错、验证的顺序给出可直接执行的流程。
证书类型与有效期:DV/OV/EV 与三种域名覆盖怎么选
先明确一个已被广泛误传的事实:EV 证书不再在浏览器地址栏显示公司名称。Chrome 77 起移除 EV 视觉标识,Firefox 与 Safari 也已跟进,地址栏只显示锁标与域名。EV 今天的价值在于金融、支付行业的合规审计要求与 CA 提供的一定金额责任险,而不是「显得更可信」的 UI 效果。为 EV 多付的几千元与 5–7 个工作日审核成本,普通企业站完全不必承担。
| 类型 | 审核内容 | 签发时长 | 典型价格区间(元/年) | 适用场景 |
|---|---|---|---|---|
| DV 域名型 | 仅验证域名控制权 | 1–10 分钟 | 0(LE)~300 | 个人站、博客、API、小程序后端 |
| OV 企业型 | 域名 + 企业工商信息 | 1–3 个工作日 | 800~3000 | 企业官网、SaaS 平台 |
| EV 增强型 | 域名 + 企业 + 律师函/电话核验 | 3–7 个工作日 | 3000~10000+ | 银行、支付、持牌金融机构 |
按域名覆盖范围又分三种:单域名证书只保护一个 FQDN(example.com 与 www.example.com 算两个,除非 SAN 中同时写入);多域名证书(SAN/UCC)一张证书可写多个不同主域,默认 3–5 个,可扩展到 100 个;通配符证书写作 *.example.com,覆盖所有二级子域,但不覆盖 example.com 本身,也不覆盖 a.b.example.com 这种三级域,实务中通常把 example.com 与 *.example.com 一起写进 SAN。
有效期方面,所有公有 CA 签发的证书上限均为 398 天,这是浏览器厂商强制执行的策略,不是 CA 的商业限制;任何宣称「三年期证书」的销售话术,实质都是每年重签。选型结论很直接:个人与中小企业选 DV 通配符 + 自动化续期,把预算投在监控与自动化上,收益远高于证书等级。
生成私钥与 CSR:一条命令产出的文件要能直接过 CA 校验
CSR(Certificate Signing Request)里的公钥、CN 与 SAN 决定了最终证书能覆盖哪些域名,一旦签发就不可更改,只能重签。因此生成阶段必须一次写对 SAN。以下命令在 Nginx 所在主机执行:
mkdir -p /etc/nginx/ssl && cd /etc/nginx/ssl
# 方式一:RSA 2048(兼容性最好,老 Android 4.x、老 JDK 也能握手)
openssl genrsa -out example.com.key 2048
# 方式二:ECDSA P-256(握手更快、包更小,TLS1.3 首选;JDK 8u261+ 才完整支持)
openssl ecparam -genkey -name prime256v1 -out example.com.key
# 生成 CSR,CN 写主域名,SAN 必须显式列出所有要覆盖的域名
openssl req -new -key example.com.key -out example.com.csr
-subj "/C=CN/ST=Zhejiang/L=Hangzhou/O=Example Technology/CN=example.com"
-addext "subjectAltName=DNS:example.com,DNS:www.example.com,DNS:*.example.com"
chmod 600 example.com.key
chown root:root example.com.key
生成后必须自检,两条命令缺一不可:
# 1) 确认 SAN 完整(这是最常出错的地方)
openssl req -in example.com.csr -noout -text | grep -A2 "Subject Alternative Name"
# 2) 确认私钥与 CSR 中的公钥匹配
openssl req -noout -modulus -in example.com.csr | openssl md5
openssl rsa -noout -modulus -in example.com.key | openssl md5
输出两行 MD5 必须完全一致。若使用 ECDSA 私钥,第二条命令改用 openssl ec -noout -text -in example.com.key 比对公钥段。通配符 *.example.com 一定不要漏写裸域 example.com,否则用户直接访问裸域会报 NET::ERR_CERT_COMMON_NAME_INVALID。若使用商业 CA,提交 CSR 时还需配合完成域名验证:DV 通常要求添加一条 TXT 记录(如 _dnsauth.example.com)或放置指定验证文件,OV/EV 还需提交营业执照与电话回访。
签发与自动续期:acme.sh 与 certbot 两条路线
免费证书走 ACME 协议,主流两个客户端。国内服务器推荐 acme.sh,它自带阿里云、腾讯云、DNSPod 的 DNS API,可用 DNS-01 方式签发通配符证书,不需要暴露 80 端口,也不受备案与防火墙影响:
curl https://get.acme.sh | sh -s email=ops@example.com
source ~/.bashrc
# 阿里云 DNS 自动加 TXT 记录(密钥建议用 RAM 子账号,仅授权 AliyunDNSFullAccess)
export Ali_Key="LTAI********"
export Ali_Secret="**************"
~/.acme.sh/acme.sh --issue --dns dns_ali
-d example.com -d "*.example.com" --keylength ec-256
# 安装到 Nginx 目录,并注册续期后自动 reload
~/.acme.sh/acme.sh --install-cert -d example.com --ecc
--key-file /etc/nginx/ssl/example.com.key
--fullchain-file /etc/nginx/ssl/fullchain.pem
--reloadcmd "systemctl reload nginx"
注意 --fullchain-file 对应的是 fullchain.pem(叶子证书 + 中间证书),绝不能用只含叶子证书的 cert.pem。acme.sh 安装时会自动写入 crontab,每天检查一次,到期前 30 天自动续签并执行 reloadcmd,这也是它比手动下载证书更可靠的地方。
certbot 路线适合已有 80 端口 Web 服务的场景,使用 webroot 模式:
apt install certbot -y
certbot certonly --webroot -w /var/www/html
-d example.com -d www.example.com
--deploy-hook "systemctl reload nginx"
# 验证续期逻辑(不真正签发)
certbot renew --dry-run
systemctl list-timers | grep certbot
webroot 模式要求 http://example.com/.well-known/acme-challenge/ 能返回 200。若站点开了强制 HTTPS 跳转或伪静态把路径重写到 index.php,验证会返回 404,需在 Nginx 中对 /.well-known/acme-challenge/ 单独放行。Let’s Encrypt 证书有效期固定 90 天,续期必须完全自动化。
Nginx 配置示例:可直接落地的 server 块
以下配置在 Nginx 1.24/1.26 上验证通过,包含 80 到 443 的 301 跳转、TLS 1.2/1.3、现代 cipher、会话复用与 HSTS:
server {
listen 80;
listen [::]:80;
server_name example.com www.example.com;
# ACME 验证路径必须放行,否则续期失败
location ^~ /.well-known/acme-challenge/ {
root /var/www/html;
default_type text/plain;
}
location / {
return 301 https://$host$request_uri;
}
}
server {
listen 443 ssl;
listen [::]:443 ssl;
http2 on; # Nginx >= 1.25.1 写法;旧版用 listen 443 ssl http2;
server_name example.com www.example.com;
ssl_certificate /etc/nginx/ssl/fullchain.pem;
ssl_certificate_key /etc/nginx/ssl/example.com.key;
ssl_protocols TLSv1.2 TLSv1.3;
ssl_ciphers ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305;
ssl_prefer_server_ciphers off;
ssl_session_cache shared:SSL:10m;
ssl_session_timeout 1d;
ssl_session_tickets off;
add_header Strict-Transport-Security "max-age=31536000" always;
add_header X-Content-Type-Options nosniff always;
root /var/www/html;
index index.html;
}
三个易踩的坑:其一,不要为 Let’s Encrypt 证书配置 ssl_stapling on;,LE 已于 2025 年关闭 OCSP 响应服务,配置后 Nginx 日志会出现 [warn] "ssl_stapling" ignored, no OCSP responder URL in the certificate,属于无效配置,直接删掉即可;商业 CA 证书仍需配 ssl_stapling on; ssl_stapling_verify on; ssl_trusted_certificate /etc/nginx/ssl/chain.pem;。其二,ssl_dhparam 只在启用 DHE 套件时需要,使用上面的 ECDHE 列表可省略,避免每次握手多一次模幂运算。其三,HSTS 的 max-age 不要一上来就写 63072000,先用 300 秒验证全站 HTTPS 无混合内容,再逐步拉长,否则回滚代价极高。
改完执行 nginx -t 通过后 systemctl reload nginx,并在云控制台安全组放行 443/TCP(firewall-cmd --add-service=https --permanent && firewall-cmd --reload)。
方案对比:验证方式、客户端与部署位置
选错验证方式会让续期在无人值守时失败,这是自动化链条上最脆弱的一环:
- SSL证书申请 · SSL证书购买 · SSL证书安装配置
- 代购 SSL 证书 · DigiCert / GeoTrust / RapidSSL 单域名与通配符
- SSL/HTTPS 证书配置 · 证书安装 · 证书申请
| 验证方式 | 原理 | 支持通配符 | 前提条件 | 失败高发点 |
|---|---|---|---|---|
| HTTP-01 | CA 访问 80 端口的挑战文件 | 否 | 80 端口公网可达 | 强制跳转、伪静态、CDN 回源 |
| DNS-01 | 添加 _acme-challenge TXT 记录 | 是 | 域名 DNS API 权限 | TXT 未生效、子域 NS 不托管 |
| 文件验证 | 商业 CA 上传指定 HTML 文件 | 视产品 | 站点根目录可写 | 验证期间被 WAF 拦截 |
客户端与部署位置的组合选择:
| 场景 | 推荐方案 | 关键参数 |
|---|---|---|
| 单台 ECS + Nginx | acme.sh + DNS-01 | –dns dns_ali –keylength ec-256 |
| 已有 Apache/IIS 的 80 服务 | certbot –webroot | –deploy-hook 自动 reload |
| 多台后端 + SLB/CLB | 证书上传到负载均衡,后端走 HTTP | 后端需校验 X-Forwarded-Proto |
| 全站 CDN | 证书托管在 CDN,源站可用自签或 LE | 回源协议选 HTTPS + 校验源站证书 |
| Kubernetes Ingress | cert-manager + ClusterIssuer | 自动创建 secret 并热加载 |
如果使用负载均衡或 CDN 卸载 TLS,源站与边缘之间也要校验证书,否则存在中间人风险;此时 proxy_set_header X-Forwarded-Proto https; 必须显式设置,否则后端应用生成的跳转链接会退回 http,引发混合内容告警。
常见错误排查:8 个真实报错与定位命令
1)nginx: [emerg] cannot load certificate "/etc/nginx/ssl/fullchain.pem": BIO_new_file() failed (SSL: error:02001002:system library:fopen:No such file or directory):路径错、文件未上传,或 SELinux 限制。用 ls -l /etc/nginx/ssl/ 与 getenforce 排查,SELinux 开启时执行 chcon -t httpd_cert_t /etc/nginx/ssl/*.pem。
2)SSL_CTX_use_PrivateKey() failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch):证书与私钥不配对,常见于续期后只替换了其中一个文件。用 modulus 比对:openssl x509 -noout -modulus -in fullchain.pem | openssl md5 与 openssl rsa -noout -modulus -in example.com.key | openssl md5,两值必须相同。
3)curl: (60) SSL certificate problem: unable to get local issuer certificate:证书链缺失,ssl_certificate 指向了不含中间证书的 cert.pem。修复方式是把中间证书拼到叶子证书后面,或直接使用 fullchain.pem。openssl s_client -connect example.com:443 -showcerts </dev/null | grep -c "BEGIN CERTIFICATE" 返回 1 即证明缺链,正常应为 2 或 3。
4)浏览器报 NET::ERR_CERT_DATE_INVALID:证书已过期或服务器时间错误。先 date -u 校时(timedatectl set-ntp true),再 openssl x509 -noout -dates -in fullchain.pem 看 notAfter。
5)SSL_ERROR_RX_RECORD_TOO_LONG:用 https:// 访问了只监听 80 的端口,或 443 被其它服务(如 httpd、Docker 容器)占用。ss -lntp | grep 443 查看实际监听进程。
6)NET::ERR_CERT_COMMON_NAME_INVALID:访问的域名不在 SAN 列表里,通配符不覆盖三级域。用 openssl x509 -noout -text -in fullchain.pem | grep -A1 "Subject Alternative Name" 核对,只能重签。
7)acme.sh 报 Invalid response from http://example.com/.well-known/acme-challenge/xxx: 404:webroot 路径错,或站点伪静态把请求重写到 index.php。在 Nginx 中对 location ^~ /.well-known/acme-challenge/ 单独放行并指向真实目录,或改用 DNS-01。
8)[warn] "ssl_stapling" ignored, no OCSP responder URL in the certificate:Let’s Encrypt 已停止 OCSP,删除 stapling 相关三行配置即可,不影响证书可用性。
此外,443 连接超时而 Nginx 日志无记录,一定是安全组或防火墙问题,不是证书问题——先 telnet example.com 443 确认连通性,再谈配置。
效果验证:5 条命令确认证书、链路、协议与续期
配置完成后不要只看浏览器锁标,按下面顺序逐项验证:
# 1. 配置语法与端口监听
nginx -t
ss -lntp | grep -E ':80|:443'
# 2. 301 跳转是否正确
curl -sI http://example.com | head -n 5 # 期望 301 + Location: https://...
curl -sI https://example.com | head -n 5 # 期望 200
# 3. 证书主体、签发者与有效期
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null
| openssl x509 -noout -subject -issuer -dates
# 4. 证书链是否完整(期望 2 或 3)
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null
| grep -c "BEGIN CERTIFICATE"
# 5. 协议降级应被拒绝(TLS1.0/1.1 必须失败)
openssl s_client -connect example.com:443 -tls1_1 </dev/null 2>&1 | grep -i "alert|handshake failure"
再加一条过期预警,可放进 Zabbix/Prometheus 的 textfile 采集:openssl x509 -checkend 2592000 -noout -in /etc/nginx/ssl/fullchain.pem,返回非 0 表示 30 天内到期,直接触发告警。最后用 curl -sI https://example.com | grep -i strict-transport-security 确认 HSTS 生效,用 journalctl -u nginx --since "10 min ago" | grep -i ssl 确认无握手告警。全部通过后,再检查页面是否残留 http:// 的图片、JS 引用——混合内容会让锁标出现黄色警告,虽不影响握手但会影响用户信任与小程序审核。
常见问题
证书有效期到底是 398 天还是 90 天?
两个都对,取决于 CA。公有 CA 签发的证书受浏览器厂商策略约束,最长 398 天;Let’s Encrypt 作为免费 CA 自定 90 天,并已提供更短的 6 天短期证书选项。CA/Browser Forum 已通过逐步缩短方案:2026 年 3 月起 200 天、2027 年 3 月起 100 天、2029 年 3 月起 47 天。无论哪种,人工续期都不可行,必须配置 acme.sh 或 certbot 的自动续期与 reload。
为什么浏览器能正常打开,微信小程序却提示证书错误?
九成是证书链不完整。桌面浏览器会通过证书内的 AIA 字段自动下载中间证书补全链,而 Android WebView、微信内置浏览器、Java HttpClient 不做这件事,只认服务端下发的完整链。用 openssl s_client -connect example.com:443 -showcerts 数一下 BEGIN CERTIFICATE 的条数,只有 1 条就是缺链,把 ssl_certificate 改指向 fullchain.pem 即可。剩下的一成是 TLS 版本被限制在 1.0/1.1,小程序要求 TLS 1.2 及以上。
通配符证书 *.example.com 能保护 example.com 本身吗?
不能。通配符只匹配该层级下的一个标签,*.example.com 覆盖 a.example.com、b.example.com,但不覆盖裸域 example.com,也不覆盖 a.b.example.com。正确做法是签发时把 example.com 与 *.example.com 一起写入 SAN,或用 acme.sh 的 -d example.com -d "*.example.com" 同时申请,二者会合并到一张证书里。
证书续期成功但线上仍是旧证书,是什么原因?
Nginx 只在启动或 reload 时读取证书文件。acme.sh 必须带 --reloadcmd "systemctl reload nginx" 参数,certbot 必须配置 --deploy-hook,否则新证书落盘也不会生效。另外若使用了 SLB/CDN,证书需同步上传到云平台,只更新源站无效;Kubernetes 场景下则要确认 cert-manager 的 secret 已被 Ingress 重新加载。
还要不要配置 OCSP stapling?
Let’s Encrypt 证书不需要——LE 已于 2025 年停止提供 OCSP 响应,配置后会得到 "ssl_stapling" ignored, no OCSP responder URL in the certificate 警告,纯属无效配置。商业 CA 证书仍然建议开启:ssl_stapling on; ssl_stapling_verify on; ssl_trusted_certificate /etc/nginx/ssl/chain.pem;,可减少客户端额外查询 OCSP 的握手延迟。
HTTP 301 跳转后,为什么接口仍然报跨域或混合内容?
301 只对页面导航生效,页面内硬编码的 http:// 资源引用、前端 JS 里的 API 地址、后端生成的绝对 URL 都不会被自动改写。需同时做三件事:页面资源改用相对协议或 https 绝对地址;Nginx 加 add_header Content-Security-Policy "upgrade-insecure-requests";;反向代理场景补 proxy_set_header X-Forwarded-Proto https;,让后端框架按 HTTPS 生成链接。