全站 HTTPS 实战:SSL 证书与 CA 证书申请、Nginx 配置、报错排查完整指南
一、问题背景与根因:为什么装了证书仍然不是“全站 HTTPS”
HTTP 以明文传输,用户在登录页输入的账号密码、Cookie、API 返回的 JSON 都会在链路上裸奔。运营商劫持插广告、公共 WiFi 抓包、中间人篡改下载包,都是这条链路带来的直接后果。Chrome 对 HTTP 页面标注“不安全”,微信小程序、iOS 的 ATS、HTTP/2 与 HTTP/3 也基本要求 HTTPS。HTTPS 已经从“加分项”变成“准入项”。
但大量站点上线 HTTPS 时只做了一半:证书装上了,浏览器仍报错;首页能开,内页图片裂;主域名正常,www 子域报错。根因是“HTTPS 可用”并不由一张证书决定,而是下面 6 个条件必须同时成立:
- 证书链完整:服务器必须下发“站点证书 + 中间 CA 证书”。缺中间证书时桌面浏览器可能靠缓存蒙混过关,但 Android、Java 客户端、curl 会直接报错。
- 私钥匹配:证书公钥与服务器私钥必须成对,混用两张证书的 key 会握手失败。
- 域名匹配:现代浏览器只校验 SAN(Subject Alternative Name)扩展,不再看 CN 字段。证书里没有 www.example.com 的 SAN,访问 www 就一定报错。
- 协议与套件不过期:仍开启 TLSv1.0/1.1 或 RC4、3DES 的站点会被判定为弱配置,部分客户端直接拒绝握手。
- 全站 301 跳转:80 端口必须跳 HTTPS,否则用户仍可能落到明文页面,HSTS 也无从生效。
- 无混合内容: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 统一跳到一个已在证书内的域名。
- HTTPS证书申请 · SSL证书安装部署 · 证书续费
- 代购 SSL 证书 · DigiCert / GeoTrust / RapidSSL 单域名与通配符
- Wildcard 通配符 SSL 证书安装部署续费申请
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 不生效。