跳到主要内容
ssl证书按装

Nginx HTTPS 证书配置实战:从 CSR 签发到 398 天有效期管理与过期排查

Nginx HTTPS 证书配置实战:从 CSR 签发到 398 天有效期管理与过期排查 — 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)。

方案对比:验证方式、客户端与部署位置

选错验证方式会让续期在无人值守时失败,这是自动化链条上最脆弱的一环:

验证方式 原理 支持通配符 前提条件 失败高发点
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 生成链接。

内容审核

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