跳到主要内容
ssl证书按装

全站 HTTPS 实战:SSL 证书与 CA 证书申请、Nginx 配置、报错排查完整指南

全站 HTTPS 实战:SSL 证书与 CA 证书申请、Nginx 配置、报错排查完整指南 — 全站 HTTPS 实战:SSL 证书与 CA 证书申请、Nginx 配置、报错排查完整指南

一、问题背景与根因:为什么装了证书仍然不是“全站 HTTPS”

HTTP 以明文传输,用户在登录页输入的账号密码、Cookie、API 返回的 JSON 都会在链路上裸奔。运营商劫持插广告、公共 WiFi 抓包、中间人篡改下载包,都是这条链路带来的直接后果。Chrome 对 HTTP 页面标注“不安全”,微信小程序、iOS 的 ATS、HTTP/2 与 HTTP/3 也基本要求 HTTPS。HTTPS 已经从“加分项”变成“准入项”。

但大量站点上线 HTTPS 时只做了一半:证书装上了,浏览器仍报错;首页能开,内页图片裂;主域名正常,www 子域报错。根因是“HTTPS 可用”并不由一张证书决定,而是下面 6 个条件必须同时成立:

  1. 证书链完整:服务器必须下发“站点证书 + 中间 CA 证书”。缺中间证书时桌面浏览器可能靠缓存蒙混过关,但 Android、Java 客户端、curl 会直接报错。
  2. 私钥匹配:证书公钥与服务器私钥必须成对,混用两张证书的 key 会握手失败。
  3. 域名匹配:现代浏览器只校验 SAN(Subject Alternative Name)扩展,不再看 CN 字段。证书里没有 www.example.com 的 SAN,访问 www 就一定报错。
  4. 协议与套件不过期:仍开启 TLSv1.0/1.1 或 RC4、3DES 的站点会被判定为弱配置,部分客户端直接拒绝握手。
  5. 全站 301 跳转:80 端口必须跳 HTTPS,否则用户仍可能落到明文页面,HSTS 也无从生效。
  6. 无混合内容:HTTPS 页面里引用 http:// 的图片、JS、CSS 会被浏览器拦截或降级警告。

动手前先摸清现状,两条命令就能看清服务器到底下发了什么:

# 查看 80 端口是否跳转
curl -sSI http://example.com | head -n 5

# 查看 443 端口实际下发的证书主题、签发者与有效期
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null 
  | openssl x509 -noout -subject -issuer -dates

如果 subject 里的 CN/SAN 与访问域名不一致,或者加 -showcerts 后只输出一张证书(没有中间 CA),就按对应环节修。下面按“准备 → 签发 → 部署 → 配置 → 排错 → 验证 → 自动化”的顺序给出可直接执行的完整流程。

二、前置准备:域名、CSR 与证书选型

域名与备案:证书签发只校验域名控制权,与备案无关;但如果服务器在中国大陆,80/443 对公网提供服务前需完成 ICP 备案,否则会被拦截。备案与证书是两套独立体系,不要把“备案号”当成 HTTPS 的前提。

生成私钥与 CSR:推荐 2048 位 RSA 或 P-256 ECDSA。私钥必须在自己的服务器上生成,不要用 CA 后台代生成(等于把私钥交给了第三方)。

mkdir -p /etc/nginx/ssl && cd /etc/nginx/ssl
openssl genrsa -out example.com.key 2048
chmod 600 example.com.key
openssl req -new -key example.com.key -out example.com.csr 
  -subj '/C=CN/ST=Zhejiang/L=Hangzhou/O=Example Ltd/CN=example.com' 
  -addext 'subjectAltName=DNS:example.com,DNS:www.example.com'

说明:-addext 需要 OpenSSL 1.1.1 及以上;用 ECDSA 则把 genrsa 换成 openssl ecparam -genkey -name prime256v1 -out example.com.key。CSR 里的 SAN 只是“申请意向”,绝大多数商业 CA 以订单后台填写的域名列表为准,所以下单时务必把裸域和 www 都填进去。

提交前自检 CSR 是否带了 SAN:

openssl req -in example.com.csr -noout -text | grep -A1 'Subject Alternative Name'

选型三条线:验证级别(DV/OV/EV)、覆盖范围(单域名/通配符/多域名 SAN)、有效期。有效期最容易踩坑:自 2020-09-01 起,公开信任的 TLS 证书单张最长有效期被限制为 398 天;Let’s Encrypt 免费证书固定 90 天。CA/Browser Forum 已通过 SC-081 提案分阶段继续缩短:2026 年 3 月起 200 天、2027 年 3 月起 100 天、2029 年 3 月起 47 天。这意味着“一年一买、到期手动换”的做法彻底失效,ACME 自动续期必须在上线时就配好。

其他准备:私钥权限 600、属主为运行 Web 服务的账号;确认服务器时间同步(timedatectl 看 NTP 是否 active),时间偏差会导致 ERR_CERT_DATE_INVALID;提前规划好 80 端口用于 ACME HTTP-01 校验,或准备 DNS API 走 DNS-01。

三、完整实操:从证书签发到部署落地

CA 签发后通常给你两个文件:站点证书(example.com.crt)和中间证书(intermediate.crt 或 ca_bundle.crt)。服务器需要下发的是“站点证书在前、中间证书在后”的合并链,根证书不要放进去:

cat example.com.crt intermediate.crt > fullchain.crt
# 顺序错误会导致部分客户端报 unable to get local issuer certificate
grep -c 'BEGIN CERTIFICATE' fullchain.crt   # 应为 2(或按 CA 说明的链长度)

校验私钥与证书是否匹配(这是最常见的部署事故):

openssl x509 -noout -modulus -in fullchain.crt | openssl md5
openssl rsa -noout -modulus -in example.com.key | openssl md5
# 两行 md5 必须完全一致;ECDSA 证书改用 -pubkey 对比

Nginx 部署:把 fullchain.crt 与 example.com.key 放到 /etc/nginx/ssl/,改配置后执行:

nginx -t && nginx -s reload

Apache 部署(httpd 2.4.8+ 只需前两行,ChainFile 已废弃):

SSLCertificateFile      /etc/httpd/ssl/fullchain.crt
SSLCertificateKeyFile   /etc/httpd/ssl/example.com.key
# SSLCertificateChainFile /etc/httpd/ssl/intermediate.crt  # 老版本才需要
apachectl configtest && systemctl reload httpd

Tomcat 部署:Tomcat 只认 JKS/PKCS12,需要先转格式,注意 -name 与 Connector 的 keyAlias 保持一致:

openssl pkcs12 -export -in fullchain.crt -inkey example.com.key 
  -out example.p12 -name tomcat -passout pass:changeit
keytool -importkeystore -srckeystore example.p12 -srcstoretype PKCS12 
  -destkeystore example.jks -deststoretype JKS -deststorepass changeit

Connector 关键参数:keystoreFile、keystorePass、keyAlias="tomcat"、SSLEnabled="true"、sslProtocol="TLSv1.2,TLSv1.3"。改完需重启 Tomcat 实例,reload 对 Connector 无效。云厂商负载均衡(SLB/CLB/CDN)场景则把 fullchain 与 key 分别贴进控制台证书管理,注意私钥不要带密码口令。

四、配置示例:Nginx 全站 HTTPS + HSTS + OCSP Stapling

下面是一份可直接落地的 Nginx 配置,包含 80 跳 443、TLS 1.2/1.3、会话复用、HSTS 与 OCSP Stapling:

server {
    listen 80;
    server_name example.com www.example.com;
    location /.well-known/acme-challenge/ { root /var/www/acme; }
    location / { return 301 https://$host$request_uri; }
}

server {
    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.crt;
    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-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;

    ssl_stapling on;
    ssl_stapling_verify on;
    ssl_trusted_certificate /etc/nginx/ssl/chain.pem;
    resolver 223.5.5.5 119.29.29.29 valid=300s;
    resolver_timeout 5s;

    add_header Strict-Transport-Security 'max-age=31536000; includeSubDomains' always;
    add_header X-Content-Type-Options 'nosniff' always;

    location / { root /var/www/html; index index.html; }
}

几个必须注意的点:

  • HSTS 先短后长:首次上线用 max-age=300 观察一周,确认所有子域都能上 HTTPS 再改 31536000。一旦下发 includeSubDomains 且某个子域没有证书,该子域会被浏览器直接封死,回滚只能等 max-age 过期。
  • OCSP Stapling 并非万能:Let’s Encrypt 自 2025 年起已停止提供 OCSP 响应(改推 CRL),对 LE 证书开 stapling 没有意义;商业 CA 证书才需要,且 ssl_trusted_certificate 要指向含根与中间的 chain.pem。
  • 混合内容兜底:老站点资源引用写死 http:// 时,可加 add_header Content-Security-Policy 'upgrade-insecure-requests' always; 让浏览器自动升级请求,但这只是过渡手段,最终仍应改源码。
  • 多站点 SNI:同一 IP 挂多个域名时,每个 server 块都要有独立的 ssl_certificate;没有匹配到 server_name 的请求会落到 default_server,容易出现“证书串站”。

配置写完后先 nginx -t 校验语法,再 nginx -s reload 平滑生效,不要直接 restart 造成连接中断。

五、证书类型、有效期与验证级别对比

选证书前先明确三个维度的差异,避免为不需要的能力付费,也避免买了不匹配的产品。

对比项 DV 域名型 OV 组织型 EV 扩展验证
验证内容 仅域名控制权(DNS/文件/邮件) 域名 + 企业工商信息核验 域名 + 严格组织与法律存在性审核
签发时长 分钟级(ACME 可秒级) 1-3 个工作日 3-7 个工作日
浏览器表现 锁标志 锁标志 锁标志(绿色地址栏已被主流浏览器移除)
证书主题含 O 字段 否 是 是
典型场景 博客、API、内部测试、CDN 回源 企业官网、电商 金融、政企、强合规行业

按覆盖范围再分一层:

类型 覆盖示例 不覆盖 适用
单域名 example.com www.example.com 单一入口
多域名 SAN example.com、www.example.com、api.example.com(一张证书多条目) 未列出的新域名 域名数量固定且较少
通配符 *.example.com(匹配 a.example.com) example.com 裸域、a.b.example.com 子域多且持续新增

有效期与成本对比:Let’s Encrypt / ZeroSSL 等免费 DV 为 90 天,只能靠 ACME 自动续期;商业 DV/OV/EV 单张最长 398 天,且受前述 SC-081 缩短计划影响,2026 年后逐步降到 200 天、100 天、47 天。自签名 CA 证书不进入公共信任库,仅适合内网服务间通信,客户端需显式导入根证书。

一句话结论:面向公网、只需加密与信任的站点,免费 DV + ACME 自动续期性价比最高;需要向用户或审计方证明“这家公司真实存在”的,再选 OV/EV。

六、常见错误排查(含真实报错)

下面这些报错在部署现场出现频率最高,按“报错原文 → 根因 → 修复”对照处理。

1. 证书链不完整

curl: (60) SSL certificate problem: unable to get local issuer certificate
NET::ERR_CERT_AUTHORITY_INVALID

根因:服务器只下发了站点证书,缺中间 CA。修复:cat site.crt intermediate.crt > fullchain.crt 后重载;用 openssl s_client -connect example.com:443 -servername example.com -showcerts 确认输出里有 2 张以上证书。

2. 域名不在 SAN 中

NET::ERR_CERT_COMMON_NAME_INVALID
curl: (60) SSL: no alternative certificate subject name matches target host name

根因:现代客户端只认 SAN,不看 CN。修复:重新签发包含该域名的证书(裸域与 www 都要列),或用 301 把 www 统一跳到一个已在证书内的域名。

3. 证书文件格式错误

nginx: [emerg] cannot load certificate "/etc/nginx/ssl/fullchain.crt":
BIO_new_file() failed (SSL: error:80000002:system library::No such file or directory)
nginx: [emerg] PEM_read_bio_X509_AUX() failed (SSL: error:04800064:PEM routines::bad base64 decode)

根因:路径写错、文件被 Windows 换行/BOM 污染,或把 .pfx/.der 当 PEM 用。修复:file fullchain.crt 确认是 ASCII text,dos2unix fullchain.crt 去 CRLF,DER 格式先 openssl x509 -inform DER -in cert.der -out cert.pem。

4. 私钥与证书不匹配

nginx: [emerg] SSL_CTX_use_PrivateKey("/etc/nginx/ssl/example.com.key") failed
(SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch)

修复:用第三节的 modulus md5 对比法确认配对关系,常见原因是续期后只换了 crt 没换 key,或同一目录下存了多份历史私钥。

5. 端口不是 TLS 或中间设备拦截

curl: (35) error:0A000126:SSL routines::unexpected eof while reading

根因:443 端口跑的是 HTTP 服务,或四层代理/防火墙终止了握手。修复:ss -lntp | grep 443 看监听进程,curl -v https://example.com 观察握手阶段断在哪一跳。

6. ACME 校验失败

Challenge failed for domain example.com
Detail: Invalid response from http://example.com/.well-known/acme-challenge/xxx: 404
Type: urn:ietf:params:acme:error:connection ... Timeout during connect (likely firewall problem)

修复:确认 80 端口放行、CDN 未拦截 /.well-known/ 路径、root 目录与 location 一致;无法开放 80 时改用 DNS-01:acme.sh --issue --dns dns_ali -d example.com。

7. 证书过期 / 混合内容

NET::ERR_CERT_DATE_INVALID
Mixed Content: The page at 'https://example.com/' was loaded over HTTPS,
but requested an insecure image 'http://cdn.example.com/a.png'.

过期先查 timedatectl 与 openssl x509 -noout -dates -in fullchain.crt;混合内容用 DevTools Console 过滤 Mixed Content,逐条替换为 https 或相对协议。

七、效果验证:命令行与在线检测

部署完成后不要只看浏览器有没有小锁,按下面清单逐项验证,才算真正完成。

# 1) 证书主题、SAN、有效期
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null 
  | openssl x509 -noout -subject -ext subjectAltName -dates

# 2) 证书链是否完整(应能看到站点证书 + 中间 CA)
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | grep -c 'BEGIN CERTIFICATE'

# 3) 80 端口是否 301 到 https
curl -sSI http://example.com | grep -iE '^(HTTP|location)'

# 4) 旧协议是否已禁用(应握手失败)
openssl s_client -connect example.com:443 -tls1_1 </dev/null

# 5) HSTS 头是否下发
curl -sSI https://example.com | grep -i strict-transport-security

在线检测用 SSL Labs 的 API,可脚本化接入 CI:

curl -s 'https://api.ssllabs.com/api/v3/analyze?host=example.com&publish=off&all=done' | head -c 400

目标等级 A 及以上;出现“Chain issues: Incomplete”就是链不全,出现“This server accepts RC4”之类则是套件过旧。

再做一层到期监控,避免“某天早上突然全站打不开”:

#!/bin/bash
DOMAIN='example.com'
END=$(echo | openssl s_client -servername $DOMAIN -connect $DOMAIN:443 2>/dev/null 
      | openssl x509 -noout -enddate | cut -d= -f2)
DAYS=$(( ( $(date -d "$END" +%s) - $(date +%s) ) / 86400 ))
[ "$DAYS" -lt 30 ] && echo "WARN: $DOMAIN 证书剩余 $DAYS 天"

把这个脚本挂到 Zabbix/Prometheus textfile collector 或每日 cron,阈值设 30 天。最后做一次真实用户视角回归:Chrome 无痕模式访问、手机 4G 网络访问、curl -I 检查静态资源域名,确认没有遗漏的子域和混合内容。

八、自动化续期:ACME 与定时任务

证书有效期只会越来越短(398 天 → 200 天 → 100 天 → 47 天),人工续期必然出事故。生产环境统一走 ACME 自动化。

方案 A:certbot(webroot 模式)

certbot certonly --webroot -w /var/www/acme 
  -d example.com -d www.example.com 
  --deploy-hook 'nginx -t && nginx -s reload'
certbot renew --dry-run   # 先演练,确认无误

certbot 自带 systemd timer(systemctl list-timers | grep certbot),默认每天跑两次,到期前 30 天自动续。--deploy-hook 里的 reload 是关键,只续期不重载等于没续。

方案 B:acme.sh(支持 DNS-01,适合无法开放 80 端口的场景)

acme.sh --issue -d example.com -d www.example.com --webroot /var/www/acme
acme.sh --install-cert -d example.com 
  --key-file       /etc/nginx/ssl/example.com.key 
  --fullchain-file /etc/nginx/ssl/fullchain.crt 
  --reloadcmd      'nginx -t && nginx -s reload'

acme.sh 安装时会自动写入 crontab(crontab -l | grep acme 可见),证书默认 60 天续期。注意:--install-cert 会在续期后自动把新证书复制到指定路径并执行 reloadcmd,所以不要把 Nginx 直接指向 acme.sh 的 ~/.acme.sh/ 内部目录。

多机与容器场景:负载均衡后端有多台 Web 服务器时,证书只在一台机器上续期会导致其余节点过期。做法是把证书放到对象存储/配置中心统一分发,或用 certbot 的 --deploy-hook 触发分发脚本;K8s 环境用 cert-manager + Ingress,由控制器统一签发与轮换。

验证自动化是否真的生效:certbot renew --dry-run 或 acme.sh --renew -d example.com --force 强制跑一次,然后核对 openssl x509 -noout -dates -in /etc/nginx/ssl/fullchain.crt 的 notAfter 是否更新,并确认 nginx -t 无报错。把这一步写进上线检查清单,比事后救火便宜得多。

常见问题

没有区别。主流浏览器早已移除 EV 绿色地址栏,DV、OV、EV 都只显示锁标志。差别在于 CA 是否核验企业身份、证书主题是否含 O 字段、是否提供赔付承诺,以及企业内部合规要求。

公开信任的 TLS 证书单张最长 398 天(2020 年 9 月起强制),Let’s Encrypt 固定 90 天。CA/Browser Forum 已确定继续缩短:2026 年 3 月起 200 天、2027 年 3 月起 100 天、2029 年 3 月起 47 天,因此必须用 ACME 自动续期。

不能。*.example.com 只匹配一级子域(如 a.example.com),既不匹配 a.b.example.com,也不匹配裸域 example.com,裸域需额外加入 SAN。另外通配符只能签发 DV 或 OV,不能签发 EV。

不必。Let’s Encrypt、ZeroSSL 等免费 DV 证书同样被主流浏览器信任,适合绝大多数公网站点。只有需要 OV/EV 组织信息、商业 SLA 赔付、更长有效期或特定合规审计时才选商业 CA。

不需要重启整机。Nginx 执行 nginx -t && nginx -s reload 平滑生效;Apache 执行 apachectl configtest && systemctl reload httpd;Tomcat 的 Connector 配置变更则需重启实例,reload 不生效。

内容审核

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