跳到主要内容
ssl证书按装

Nginx HTTPS 证书配置与 SSL 证书申请全指南:398 天有效期、CSR、证书链与排错

Nginx HTTPS 证书配置与 SSL 证书申请全指南:398 天有效期、CSR、证书链与排错 — Nginx HTTPS 证书配置与 SSL 证书申请全指南:398 天有效期、CSR、证书链与排错

问题背景与根因:HTTPS 已是强制项,证书有效期已缩短

很多站点把 HTTPS 当成装个证书就结束,实际故障集中在三处:证书链不完整、私钥与证书不匹配、证书过期未续。微信小程序、苹果 ATS、HTTP/2 和现代浏览器都要求 TLS;Chrome 对非 HTTPS 表单、混合内容会拦截。另一个过时认知是证书可以买多年,自 2020-09-01 起,公开信任 TLS 证书单张最长有效期 398 天,Let’s Encrypt 为 90 天,因此必须建立自动续期。DV、OV、EV 的区别在身份审核,不在加密强度。根因还包括 ECS 安全组未放行 443、Nginx 仍只监听 80、SNI 配置错误、证书文件权限过宽。所谓长期 CA 证书只能是商业合同周期,不是单张证书有效期。

echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null | openssl x509 -noout -dates -subject -issuer

输出中的 notAfter 就是到期时间;若 verify return code 非 0,先查证书链。不要把 cert.pem 当 fullchain.pem 使用。排查顺序建议为 DNS 解析、安全组、端口监听、证书路径、证书链、协议与套件、应用混合内容。每层都用命令验证,避免盲目重装。长期方案是 ACME 自动续期、到期监控和配置版本化。

申请前的域名、端口与证书类型准备

申请前先确认四件事:域名解析已生效、80 和 443 端口可访问、服务器系统与 Web 软件版本明确、证书类型与覆盖范围匹配。HTTP-01 验证需要 80 端口,DNS-01 验证需要能添加 TXT 记录。ECS 要在安全组入方向放行 443,若使用 HTTP-01 或 301 跳转还要放行 80。通配符证书 *.example.com 只覆盖一级子域,不覆盖 a.b.example.com。

cat /etc/os-release | head -n 2
nginx -v
ss -lntp | grep ':443'
firewall-cmd --add-service=https --permanent; firewall-cmd --reload
ufw allow 443/tcp
dig +short TXT _acme-challenge.example.com

个人博客和 API 选 DV 即可;企业门户可选 OV;金融、电商若合同要求可选 EV,但多数现代浏览器已不再显示绿色公司名。多子域业务优先评估通配符 DV,但要注意它不能跨主域,也不能覆盖二级通配。申请材料通常包括域名、域名管理权限、服务器操作系统版本、Nginx 或 Apache 版本。不要把私钥发给 CA,CA 只需要 CSR。

生成 CSR 与私钥的可执行命令

CSR 只包含公钥和主体信息,私钥必须留在服务器。RSA 建议至少 2048 位,ECDSA 建议 P-256。现代浏览器更偏好 ECDSA,但部分老旧客户端仍需 RSA,可按业务选择。生成 CSR 时必须写入 SAN,浏览器早已忽略仅靠 CN 的证书。

openssl req -new -newkey rsa:2048 -nodes -keyout example.com.key -out example.com.csr -subj '/C=CN/ST=Beijing/L=Beijing/O=Example/CN=example.com' -addext 'subjectAltName=DNS:example.com,DNS:www.example.com'
chmod 600 example.com.key
openssl req -in example.com.csr -noout -text | grep -A1 'Subject Alternative Name'
openssl rsa -in example.com.key -check

若使用 ECDSA,可执行以下命令。签发后要确认证书 SAN 与 CSR 一致,且私钥权限为 600,属主为 root 或运行 Nginx 的用户。CSR 中的组织信息不会改变 DV 证书的加密能力,只影响 OV、EV 的身份展示。

openssl ecparam -genkey -name prime256v1 -out example.com.ec.key
openssl req -new -key example.com.ec.key -out example.com.ec.csr -subj '/CN=example.com' -addext 'subjectAltName=DNS:example.com'

Nginx HTTPS 配置完整示例

推荐把 80 端口只做 301,把业务全部放到 443。证书路径应指向 fullchain.pem,私钥指向 key 文件。Nginx 1.25.1 及以上建议使用 listen 443 ssl 加 http2 on;旧版本可用 listen 443 ssl http2。HSTS 要等全站和子域都确认 HTTPS 后再加,否则回退困难。

server {
    listen 80;
    server_name example.com www.example.com;
    return 301 https://$host$request_uri;
}

server {
    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';
    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; includeSubDomains' always;
    root /var/www/html;
    index index.html;
}

修改后先执行 nginx -t,再 systemctl reload nginx。若报 cannot load certificate,先检查路径和权限;若浏览器提示证书链不完整,检查是否误用 cert.pem 而非 fullchain.pem。不要启用 TLSv1.0、TLSv1.1,也不要把 ssl 指令写在 http 块里替代 listen 443 ssl。

证书链、自动续期与 OCSP 配置

fullchain.pem 通常由站点证书加中间证书组成,不应把根证书塞进链里。可用 s_client 查看服务端实际下发的证书链。Let’s Encrypt 单张 90 天,certbot 默认在到期前 30 天续期,务必用 dry-run 验证续期和 reload 钩子。

openssl s_client -connect example.com:443 -servername example.com -showcerts 2>/dev/null | grep 'i:'
curl -I https://example.com
apt install certbot python3-certbot-nginx
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

使用 acme.sh 时可执行 acme.sh –issue -d example.com -w /var/www/html –reloadcmd ‘systemctl reload nginx’。OCSP 装订可降低握手延迟,但必须配置正确的中间证书和 DNS 解析器;若链不完整,先修链再开装订。

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;

证书类型与部署方案对比表

证书类型不是加密强度等级,DV、OV、EV 在 TLS 加密算法上没有本质差别,差别在身份审核和浏览器展示。公开信任证书单张最长 398 天,Let’s Encrypt 为 90 天;多年合同只是续费周期,不能突破单张有效期上限。

类型 验证方式 单张有效期 签发时间 覆盖范围 适用场景
DV 单域名 域名控制 最长 398 天 几分钟 一个域名 博客、API、测试环境
DV 通配符 DNS TXT 最长 398 天 几分钟到数小时 *.example.com 一级 多子域业务
OV 企业资料审核 最长 398 天 3-5 工作日 指定域名 企业门户
EV 严格身份审核 最长 398 天 5-10 工作日 指定域名 金融、电商合同要求
Let’s Encrypt DV ACME 90 天 分钟级 单域名或多域名 自动化部署

选择建议:能自动续期优先选 ACME;需要通配符选 DNS-01;企业品牌展示可评估 OV;EV 不再普遍显示绿色地址栏,不应把它当作加密升级。生产环境必须监控到期时间,至少提前 14 天告警。

常见错误排查:真实报错与修复

排错先看 nginx -t 和 error.log,再看 curl 与 openssl 输出。以下报错在证书部署中最常见。

  • nginx: [emerg] cannot load certificate ... No such file or directory:路径错误或权限不足。执行 ls -l /etc/nginx/ssl/fullchain.pem 和 namei -l 检查逐级目录权限。
  • SSL_CTX_use_PrivateKey: key values mismatch:证书与私钥不匹配。分别计算 modulus 后比较,输出必须一致。
  • curl: (60) SSL certificate problem: unable to get local issuer certificate:缺少中间证书。把站点证书和中间证书合并为 fullchain.pem,再用 s_client -showcerts 验证。
  • NET::ERR_CERT_AUTHORITY_INVALID:证书链不受信任、系统时间错误或 SNI 未命中。检查 date、server_name 和证书 SAN。
  • nginx: [warn] the ssl directive is deprecated:旧写法。改用 listen 443 ssl,并在新版本使用 http2 on。
openssl x509 -noout -modulus -in fullchain.pem | openssl md5
openssl rsa -noout -modulus -in example.com.key | openssl md5
openssl s_client -connect example.com:443 -servername example.com -showcerts 2>/dev/null

效果验证与上线检查清单

上线前按顺序执行以下命令,确认语法、跳转、证书链、协议版本和端口监听。预期结果是 80 返回 301,443 返回 200,证书 issuer 正确,TLSv1.2 和 TLSv1.3 可握手,TLSv1.0 被拒绝。

nginx -t
systemctl reload nginx
curl -I http://example.com
curl -I https://example.com
curl -vI https://example.com 2>/dev/null | grep -E 'SSL|TLS|subject|issuer'
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null | openssl x509 -noout -dates -issuer -subject
ss -lntp | grep ':443'

浏览器侧检查 Console 是否有 Mixed Content,Network 面板确认所有资源为 https。用 SSL Labs 或 testssl.sh 检查链、协议、套件和 HSTS。确认 OCSP 装订生效,证书到期监控已接入。若使用 CDN 或负载均衡,证书要同时部署在回源和边缘节点,避免只改 Nginx 而边缘仍旧证书。

常见问题

证书真的可以申请多年吗?

不能。公开信任 TLS 证书单张最长 398 天,Let’s Encrypt 为 90 天。多年合同只是续费和服务周期,不改变单张证书有效期,必须按到期时间续签。

Let’s Encrypt 90 天太短怎么办?

用 certbot 或 acme.sh 自动续期,配置 deploy-hook 重载 Nginx,并用 certbot renew –dry-run 和 systemctl list-timers 验证定时任务。不要手工记到期日。

Nginx 配了证书浏览器仍提示不安全?

优先查 fullchain 是否完整、页面是否有 http 混合内容、服务器时间是否准确、SNI 和 server_name 是否匹配。用 curl -vI 与 openssl s_client 查看实际下发的证书链。

通配符证书能覆盖 a.b.example.com 吗?

不能。*.example.com 只覆盖一级子域,如 a.example.com,不覆盖 a.b.example.com。二级子域需要单独证书或额外 SAN。

443 安全组已开仍无法访问?

继续检查 Nginx 是否 listen 443、本机防火墙、SELinux、云负载均衡监听和回源端口。用 ss -lntp 与 curl -I https://127.0.0.1 -H ‘Host: example.com’ 分层定位。

EV 证书还会显示绿色公司名吗?

多数现代浏览器已取消绿色地址栏,EV 主要体现更严格的身份审核,不提升 TLS 加密强度。是否需要 EV 应看合同和品牌要求,而不是期待浏览器绿条。

内容审核

长期从事 SSL/TLS 证书部署与 HTTPS 运维,负责本站证书选型、安装配置与故障排查内容的编写与审核。