HTTPS 证书配置与 Nginx SSL 配置实战:398 天有效期、Let’s Encrypt 90 天与常见报错排查
问题背景与根因:HTTPS 证书配置为什么总在 Nginx 上失败
很多旧教程把 HTTPS 配置写成“上传证书、改 Nginx、重载”三步,但实际故障集中在证书链、私钥匹配、域名覆盖和混合内容。Nginx 的 ssl_certificate 应指向包含站点证书与中间证书的 fullchain.pem;只配站点证书时,浏览器可能正常,但 Android、Java、curl 会报 unable to get local issuer certificate。私钥与证书不匹配会触发 SSL_CTX_use_PrivateKey: key values mismatch。证书只覆盖 example.com 而访问 www.example.com 会报 NET::ERR_CERT_COMMON_NAME_INVALID。页面 HTTPS 后样式错乱,多为程序仍写死 http:// 资源,属于混合内容,不是证书安装失败。另需注意:公网 TLS 服务器证书最长有效期 398 天,Let’s Encrypt 为 90 天;所谓“长期 CA 证书”通常指根 CA 或中间 CA,不是可直接部署到网站的叶子证书。排查先看 nginx -t、error.log,再用 openssl s_client -connect example.com:443 -servername example.com -showcerts 验证链。
证书类型与有效期:398 天、90 天和“长期 CA 证书”的边界
公网信任的 SSL/TLS 证书由 CA 签发,浏览器信任的是根证书,服务器应部署“叶子证书 + 中间证书”。按 CA/B Forum 基线要求,自 2020-09-01 起,公网 TLS 服务器证书最长有效期 398 天;Let’s Encrypt 免费证书有效期 90 天,建议剩余 30 天前自动续期。根 CA 证书可以长达 10 年以上,中间 CA 也常见多年有效期,但它们不能替代网站证书,也不能把根证书私钥放到服务器。DV 只验证域名控制权,适合博客、API、测试环境;OV 验证组织身份,适合企业官网、支付相关入口;EV 在现代浏览器中不再显示绿色地址栏,但仍做更严格身份核验。通配符 *.example.com 只覆盖一级子域,不覆盖 example.com 和多级子域;多域名证书用 SAN 扩展覆盖。查看证书信息可用:openssl x509 -in fullchain.pem -noout -dates -subject -issuer -ext subjectAltName。续期后必须重载 Nginx:systemctl reload nginx。
完整实操步骤:从 CSR 到 Nginx 启用 HTTPS 的可执行命令
先备份:sudo cp -a /etc/nginx /etc/nginx.bak.$(date +%F)。使用 Let’s Encrypt 时安装 Certbot:sudo apt update && sudo apt install -y certbot python3-certbot-nginx;执行 sudo certbot –nginx -d example.com -d www.example.com –redirect,按提示选择自动跳转;测试续期 sudo certbot renew –dry-run。使用商业证书时先生成 CSR:openssl req -new -newkey rsa:2048 -sha256 -nodes -keyout example.com.key -out example.com.csr -subj ‘/CN=example.com’,把 CSR 交给 CA,收到证书后合并中间链:cat example.com.crt intermediate.crt > fullchain.pem。部署权限:sudo install -m 600 example.com.key /etc/nginx/ssl/example.com.key;sudo install -m 644 fullchain.pem /etc/nginx/ssl/fullchain.pem。检查并重载:sudo nginx -t && sudo systemctl reload nginx。若 443 不通,检查云安全组、firewalld/ufw 与 listen 443 ssl。不要用 chmod 777 解决权限,Nginx worker 只需读权限,私钥建议 600 且属主 root。
Nginx SSL 配置示例:TLS 1.2/1.3、HSTS 与 OCSP Stapling
以下片段可直接放入 server 块。Nginx 1.25.1 及以上建议用 http2 on;,旧版本用 listen 443 ssl http2;。证书路径按实际修改,ssl_certificate 必须用 fullchain.pem。
server {
listen 80;
server_name example.com www.example.com;
return 301 https://$host$request_uri;
}
server {
listen 443 ssl;
http2 on;
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';
ssl_prefer_server_ciphers off;
ssl_session_cache shared:SSL:10m;
ssl_session_timeout 1d;
ssl_stapling on;
ssl_stapling_verify on;
ssl_trusted_certificate /etc/nginx/ssl/chain.pem;
resolver 223.5.5.5 1.1.1.1 valid=300s;
add_header Strict-Transport-Security 'max-age=31536000; includeSubDomains' always;
root /var/www/html;
index index.html;
}
HSTS 会强制浏览器后续走 HTTPS,首次上线建议先用 max-age=300 验证,再逐步增大;确定所有子域都支持 HTTPS 后再加 includeSubDomains。OCSP Stapling 需要 chain.pem 为中间证书链,且服务器可访问外网 DNS。修改后必须执行 sudo nginx -t,输出 syntax is ok 与 test is successful 才可 reload。
证书方案对比表格:DV、OV、通配符与 Let’s Encrypt 怎么选
| 方案 | 典型有效期 | 验证方式 | 适用场景 | 注意点 |
|---|---|---|---|---|
| Let’s Encrypt DV | 90 天 | HTTP-01 或 DNS-01 | 个人站、API、测试 | 必须自动续期,剩余 30 天前 renew |
| 商业 DV | 最长 398 天 | 域名控制权 | 中小企业官网 | 仍需 fullchain,价格随品牌变化 |
| OV | 最长 398 天 | 域名 + 组织资料 | 企业门户、金融入口 | 审核 1-3 个工作日,证书含 O 信息 |
| OV 通配符 | 最长 398 天 | 域名 + 组织资料 + DNS | 多子域统一管理 | *.example.com 不覆盖 example.com |
| EV | 最长 398 天 | 严格组织核验 | 高信任品牌场景 | 现代浏览器不显示绿色地址栏 |
选择时先确认域名清单:根域、www、API、多级子域。通配符证书只匹配一级子域,example.com 需要单独加入 SAN 或另签。免费证书与商业证书在加密强度上无本质差别,差异在有效期、保障、审核和服务。若旧文章提到“网站加密证书长期”,应理解为自动续期机制让 HTTPS 长期可用,而不是购买一张多年有效期的公网叶子证书。部署后用 openssl x509 -noout -dates -subject -issuer 核对有效期和主体,避免把根证书或中间证书误配为站点证书。
常见错误排查:真实报错、原因与修复命令
1)nginx: [emerg] cannot load certificate … BIO_new_file() failed (SSL: error:80000002:system library::No such file or directory):路径错误或文件不存在,执行 ls -l /etc/nginx/ssl/ 并修正 ssl_certificate。2)SSL_CTX_use_PrivateKey: key values mismatch:证书与私钥不配对,用 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 改 fullchain.pem,不要只写 example.com.crt。4)NET::ERR_CERT_COMMON_NAME_INVALID:域名不在 SAN,检查 openssl x509 -noout -ext subjectAltName -in fullchain.pem,重新签发含 www 或多域名的证书。5)Mixed Content: The page at … was loaded over HTTPS, but requested an insecure resource …:页面仍引用 http:// 图片、JS、CSS,改相对协议或 https,并配置 CSP upgrade-insecure-requests。6)nginx: [emerg] unknown directive ‘http2’:旧版 Nginx 不支持 http2 on;,改用 listen 443 ssl http2;。排查顺序:sudo nginx -t,sudo tail -n 50 /var/log/nginx/error.log,再用 curl -vI https://example.com 看握手。
效果验证:curl、openssl 与浏览器三路确认
先验证跳转:curl -I http://example.com,期望 301 或 308 且 Location: https://example.com/。再验证证书链:curl -vI https://example.com 2>&1 | grep -E ‘SSL|TLS|subject|issuer|expire’;更精确用 echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null | openssl x509 -noout -dates -subject -issuer -ext subjectAltName。检查 TLS 版本:openssl s_client -connect example.com:443 -servername example.com -tls1_2 与 -tls1_3 均应成功,旧协议 tls1_0、tls1_1 应失败。检查 HSTS:curl -sI https://example.com | grep -i strict-transport-security。浏览器打开开发者工具 Security 面板,确认证书有效、无混合内容;再访问 SSL Labs 或 Hardenize 查看链、协议、HSTS、OCSP。续期后执行 sudo certbot renew –dry-run 与 sudo nginx -t,观察证书到期时间是否更新;生产环境建议用 systemd timer 或 cron 每天检查,并在监控中设置证书剩余天数小于 21 天告警。
常见问题
公网 TLS 服务器证书按 CA/B Forum 基线要求最长 398 天;Let’s Encrypt 免费证书固定 90 天,建议剩余 30 天前自动续期,不能用一张多年叶子证书替代续期机制。
优先 fullchain.pem,即站点证书加中间证书;只配 crt 在部分浏览器正常,但 curl、Java、Android 可能报 unable to get local issuer certificate。私钥用 ssl_certificate_key 指向 key。
不能。*.example.com 只覆盖 www、api 等一级子域,不覆盖 example.com,也不覆盖 a.b.example.com;根域需单独加入 SAN 或另签证书。
多数不是,是混合内容。页面仍加载 http:// 的图片、JS、CSS,浏览器会拦截或告警;把资源改为 https 或相对协议,并检查 CSP 与程序模板。
用 certbot renew –dry-run 测试,生产用 systemctl list-timers | grep certbot 确认定时器;续期后执行 nginx -t 和 systemctl reload nginx,并监控剩余天数。
不能。根 CA 和中间 CA 用于建立信任链,不应把根证书私钥放服务器;网站应部署 CA 签发的叶子证书和中间链,公网叶子证书最长 398 天。