SSL 证书 HTTPS 配置全流程实战:CSR 申请、Nginx/Apache 部署、398 天有效期与报错排查
一、问题背景与根因:HTTP 站点为什么必须升级 HTTPS
微信小程序自 2017 年起强制所有网络请求走 HTTPS,Chrome、Firefox、Edge 对 HTTP 页面在地址栏标注“不安全”,iOS 的 ATS 默认拦截明文请求。更实际的风险是:明文 HTTP 没有完整性校验,公共 Wi-Fi、运营商链路、被污染的 DNS 都可以在响应里插入广告脚本——这就是“防广告劫持”必须依赖 TLS 的根本原因。
动手前先分清线上 HTTPS 失败的三大根因,能省掉八成排查时间:
- 证书链不完整:服务端只下发了服务器证书(leaf),没有附带中间证书(intermediate)。桌面版 Chrome 常能靠 AIA 自动补链,但旧版 Android、Java 客户端、微信内置 WebView 会直接报
NET::ERR_CERT_AUTHORITY_INVALID。 - 域名不匹配:证书 SAN 里只有
example.com,用户却访问www.example.com,报NET::ERR_CERT_COMMON_NAME_INVALID或SSL_ERROR_BAD_CERT_DOMAIN。 - 协议或套件不匹配、端口不通:服务端仍只开 TLS 1.0 或仅支持 3DES 套件,报
ERR_SSL_VERSION_OR_CIPHER_MISMATCH;云主机安全组未放通 443,表现为连接超时。
一条命令先做体检:
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | openssl x509 -noout -subject -issuer -dates -ext subjectAltName
如果输出里 depth 只有 0 层、Verify return code 不是 0,基本可判定为证书链不完整或根证书不受信任。确认根因后,再进入下面的选型与部署流程,避免“换个证书试试”式盲试。
二、证书选型与有效期规则:先修正三个过时认知
事实一:公共 CA 证书最长 398 天。自 2020-09-01 起,Apple、Mozilla、Google 的政策要求公共信任 CA 签发的 TLS 证书有效期不得超过 398 天,“买一张用一年或三年”的说法早已不成立。CA/Browser Forum 已通过分阶段缩短方案:2026-03-15 起降至 200 天,2027-03-15 起 100 天,2029-03-15 起 47 天,域名与 IP 验证结果的重用期同步压缩。
事实二:Let’s Encrypt 免费证书有效期 90 天。官方建议每 60 天自动续期一次(certbot renew 只在剩余 30 天内才真正续签),必须配 cron 或 systemd timer,否则 90 天后必然过期。
事实三:EV 证书不再显示绿色地址栏。Chrome 77(2019 年)起移除了 EV 的组织名展示,地址栏对所有 HTTPS 站点统一显示锁形图标;EV 的价值只剩证书 Subject 中的 O 字段与 CT 日志可查,对浏览器展示和 SEO 没有加分。
| 类型 | 验证内容 | 签发时长 | 浏览器表现 | 适用场景 |
|---|---|---|---|---|
| DV 域名型 | 域名控制权(DNS TXT 或 HTTP 文件) | 5 分钟至 1 小时 | 锁形图标 | 个人站、小程序后端、API 网关 |
| OV 企业型 | 营业执照 + 组织电话回拨 | 1-5 个工作日 | 锁形图标,证书详情含企业名 | 企业官网、SaaS 平台 |
| EV 增强型 | 严格企业身份核验 | 3-7 个工作日 | 与 OV 相同(无绿条) | 金融、电商、合规硬性要求 |
按覆盖范围分:单域名证书只保护一个 FQDN;多域名证书通过 SAN 字段一次覆盖多个域名(单张通常上限 100 个);通配符证书 *.example.com 只覆盖一级子域名,a.b.example.com 仍需单独加进 SAN。
三、实操步骤一:生成私钥与 CSR(含 SAN 写法)
CSR(Certificate Signing Request)是提交给 CA 的证书申请文件,包含公钥与主体信息。私钥必须留在自己服务器上,任何情况下都不要发给 CA 或代维服务商,否则等同于把站点身份交出去。
mkdir -p /etc/ssl/private/example.com && cd /etc/ssl/private/example.com
# 1) 生成 2048 位 RSA 私钥(兼容性最好)
openssl genpkey -algorithm RSA -pkeyopt rsa_keygen_bits:2048 -out example.com.key
# 2) 或生成 ECDSA P-256 私钥(握手更快、报文更小,需确认客户端支持)
openssl genpkey -algorithm EC -pkeyopt ec_paramgen_curve:P-256 -out example.com.key
chmod 600 example.com.key
# 3) 生成 CSR,多域名必须写进 subjectAltName
openssl req -new -key example.com.key -out example.com.csr
-subj '/C=CN/ST=Zhejiang/L=Hangzhou/O=Example Tech Co., Ltd./CN=example.com'
-addext 'subjectAltName=DNS:example.com,DNS:www.example.com'
三个必须检查的点:
- CN 只写一个主域名,其余全部放 SAN。Chrome 58 起不再读取 CN,只看
subjectAltName,漏写www上线就会报证书名称不匹配。 - 核对 CSR 内容:
openssl req -in example.com.csr -noout -text | grep -A2 'Subject Alternative Name',确认域名列表、大小写与拼写。 - 核对私钥与证书是否配对(拿到证书后):
openssl x509 -noout -pubkey -in example.com.crt | openssl md5与openssl pkey -pubout -in example.com.key | openssl md5的输出必须完全一致。
OV/EV 证书的 O(组织名)必须与营业执照完全一致,包括括号全半角与 Co., Ltd. 的写法,否则会被人为审核打回,白白多等 1-2 个工作日。
四、实操步骤二:域名验证与证书签发(DNS-01 与 HTTP-01)
CA 通过三种方式确认域名控制权,选错验证方式是“一直卡在验证中”的最常见原因:
- HTTP-01:CA 访问
http://example.com/.well-known/acme-challenge/<token>,要求 80 端口对公网可达,且 301 跳转后仍能取到同一 token。不支持通配符证书。 - DNS-01:添加 TXT 记录
_acme-challenge.example.com,支持通配符,不依赖 80 端口,适合内网、CDN 回源、80 被占用的场景。 - TLS-ALPN-01:走 443 端口专用扩展,需要服务端支持,日常很少用到。
付费 CA 的 DV 证书通常用 DNS TXT 或域名邮箱验证,需提供域名管理权限配合加记录;OV/EV 还要提交营业执照、组织电话回拨,并核对 WHOIS 中注册人信息与申请主体是否一致。
# Let's Encrypt + 已有 Nginx(webroot 方式,不断服)
certbot certonly --webroot -w /var/www/html
-d example.com -d www.example.com
--email ops@example.com --agree-tos --no-eff-email
# 通配符必须走 DNS 挑战
certbot certonly --manual --preferred-challenges dns -d example.com -d '*.example.com'
国内 DNS 服务商建议用 acme.sh 的 API 自动加记录:
- SSL证书申请 · SSL证书购买 · SSL证书安装配置
- HTTPS证书申请 · SSL证书安装部署 · 证书续费
- 代购 SSL 证书 · DigiCert / GeoTrust / RapidSSL 单域名与通配符
acme.sh --issue --dns dns_ali -d example.com -d '*.example.com' --keylength ec-256
acme.sh --install-cert -d example.com --ecc
--key-file /etc/ssl/private/example.com.key
--fullchain-file /etc/nginx/ssl/example.com.fullchain.pem
--reloadcmd 'systemctl reload nginx'
验证 TXT 是否生效:dig +short TXT _acme-challenge.example.com @8.8.8.8。注意 Let’s Encrypt 对同一注册域名有每周 50 张证书的签发上限,反复失败先看 /var/log/letsencrypt/letsencrypt.log,别硬重试把配额打满。
五、配置示例:Nginx / Apache / Tomcat 与 301 强制跳转
部署前先把证书拼成“服务器证书 + 中间证书”的顺序,根证书不要放进去:
cat example.com.crt intermediate.crt > example.com.fullchain.pem
# 核对链层数,正常应能看到 2 段 BEGIN CERTIFICATE
grep -c 'BEGIN CERTIFICATE' example.com.fullchain.pem
# /etc/nginx/conf.d/example.com.conf
server {
listen 80;
server_name example.com www.example.com;
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/example.com.fullchain.pem;
ssl_certificate_key /etc/ssl/private/example.com/example.com.key;
ssl_trusted_certificate /etc/nginx/ssl/example.com.chain.pem;
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;
resolver 223.5.5.5 119.29.29.29 valid=300s;
add_header Strict-Transport-Security 'max-age=31536000; includeSubDomains' always;
add_header X-Content-Type-Options nosniff always;
root /var/www/example.com;
index index.html;
}
Apache(httpd 2.4)核心片段:
<VirtualHost *:443>
SSLEngine on
SSLCertificateFile /etc/httpd/ssl/example.com.fullchain.pem
SSLCertificateKeyFile /etc/httpd/ssl/example.com.key
SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1
Header always set Strict-Transport-Security 'max-age=31536000'
</VirtualHost>
Tomcat 只认 keystore,需先转换:openssl pkcs12 -export -in fullchain.pem -inkey example.com.key -name tomcat -out example.com.p12,再在 server.xml 的 <SSLHostConfig> 中引用;IIS 导入 .pfx 后,还必须把中间证书装进“中间证书颁发机构”存储,否则同样报不受信任。改完执行 nginx -t && nginx -s reload 或 systemctl reload httpd 生效。
六、对比表格:验证方式与部署形态怎么选
| 验证方式 | 依赖端口 | 支持通配符 | 适用场景 | 失败典型原因 |
|---|---|---|---|---|
| HTTP-01 | 80 | 否 | 有公网 Web 服务的常规站点 | 80 被安全组拦截、跳转丢 token |
| DNS-01 | 无 | 是 | 通配符、内网、CDN 回源 | TXT 未生效、TTL 过长、存在多条冲突记录 |
| TLS-ALPN-01 | 443 | 否 | 仅 443 可用的特殊环境 | 前置代理不支持 ALPN 扩展 |
| 部署形态 | 证书文件格式 | 关键配置项 | 备注 |
|---|---|---|---|
| Nginx | PEM(fullchain + key) | ssl_certificate / ssl_certificate_key | fullchain 必须是 leaf 在前、中间证书在后 |
| Apache | PEM | SSLCertificateFile(2.4.8+ 可含链) | 老版本用 SSLCertificateChainFile |
| IIS | PFX | 站点绑定 443 + 中间证书存储 | 缺中间证书是最常见的 IIS 报错来源 |
| Tomcat | PKCS12 / JKS | SSLHostConfig / Certificate | 用 openssl pkcs12 转换后再引用 |
| 云负载均衡 / CDN | PEM 上传 | 监听 443 + 证书链上传 | 回源协议与后端端口要同步检查 |
上云场景还要额外确认两件事:一是安全组入方向放通 TCP:443(源地址按业务收敛,不要长期 0.0.0.0/0 全开);二是负载均衡与后端 ECS 之间的回源协议,若后端仍为 HTTP,需在 LB 上终止 TLS 并在应用侧读取 X-Forwarded-Proto,否则 301 跳转会形成死循环。
七、常见错误排查:真实报错对照表
curl: (60) SSL certificate problem: unable to get local issuer certificate:缺中间证书。用openssl s_client -connect example.com:443 -showcerts看链层数,修复即cat leaf.crt intermediate.crt > fullchain.pem。nginx: [emerg] cannot load certificate "/etc/nginx/ssl/a.pem": PEM_read_bio_X509_AUX() failed (SSL: error:0909006C:PEM routines:get_name:no start line):文件不是 PEM 或被 CRLF、BOM 污染。转换:openssl x509 -in a.der -inform DER -out a.pem -outform PEM,再sed -i 's/r$//' a.pem。nginx: [emerg] SSL_CTX_use_PrivateKey() failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch):证书与私钥不配对,按第三节的 md5 比对方法定位。request:fail ssl handshake error(微信小程序):要求 TLS 1.2 及以上、证书由受信任 CA 签发、域名与证书 SAN 完全一致、不支持 IP 直连,且不能有自签名中间证书。ERR_SSL_PROTOCOL_ERROR或sslv3 alert handshake failure:协议或套件不匹配,也可能 443 被非 TLS 服务占用。用openssl s_client -connect 127.0.0.1:443 -tls1_2定位。curl: (7) Failed to connect to example.com port 443: Connection timed out:端口不通。firewall-cmd --add-service=https --permanent && firewall-cmd --reload、ufw allow 443/tcp,并检查云安全组与ss -lntp | grep 443。Mixed Content: The page at 'https://...' was loaded over HTTPS, but requested an insecure resource 'http://...':页面内仍有 HTTP 资源,加响应头Content-Security-Policy: upgrade-insecure-requests并全站替换硬编码链接。x509: certificate has expired or is not yet valid:证书过期或服务器时间漂移,用timedatectl核对时区与 NTP,chronyc sources -v确认同步源正常。
排查顺序建议固定为:端口连通性 → TLS 握手 → 证书链 → 域名匹配 → 有效期 → 混合内容,自下而上逐层排除,比反复重装证书高效得多。
八、效果验证:七条命令确认 HTTPS 真正生效
# 1) 301 跳转是否生效
curl -sI http://example.com | head -3 # 期望 301 + Location: https://...
# 2) 站点是否 200 且走 HTTP/2
curl -sI https://example.com | head -1 # 期望 HTTP/2 200
# 3) 证书主体、签发者与到期时间
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null | openssl x509 -noout -subject -issuer -dates
# 4) 证书链是否完整,Verify return code 必须为 0
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | grep -E 'depth=|Verify return code'
# 5) 是否已禁用 TLS 1.0/1.1(期望握手失败)
openssl s_client -connect example.com:443 -tls1_1 </dev/null
# 6) 安全响应头
curl -sI https://example.com | grep -iE 'strict-transport-security|x-content-type'
# 7) 自动续期演练
certbot renew --dry-run
再用 testssl.sh --severity HIGH https://example.com 或 SSL Labs 做一次全量扫描,目标评级 A 及以上;重点看是否残留 TLS 1.0/1.1、RC4/3DES 套件、是否开启 OCSP Stapling 与 HSTS。对小程序与 App 后端,还要额外用真机(尤其是低版本 Android)跑一遍请求,确认没有只对桌面浏览器生效的“假成功”。
最后把续期做成无人值守:0 3 * * * /usr/bin/certbot renew --quiet --deploy-hook 'systemctl reload nginx',并在监控里加一条证书剩余天数告警(阈值 20 天),这样 398 天或 90 天的有效期就不会变成线上事故。
常见问题
SSL 证书最长有效期是多久?
公共信任 CA 签发的 TLS 证书自 2020-09-01 起最长 398 天;Let’s Encrypt 免费证书为 90 天。按 CA/Browser Forum 已通过的计划,2026-03-15 起降至 200 天,2027-03-15 起 100 天,2029-03-15 起 47 天。因此“一次部署长期不管”的做法已不可行,必须配置自动续期与到期告警。
通配符证书能覆盖几级子域名?
*.example.com 只覆盖一级子域名,如 www.example.com、api.example.com,不覆盖 a.b.example.com,也不覆盖裸域 example.com。裸域需要单独加入 SAN,多级子域名要么再签一张通配符,要么在 SAN 中逐条列出。
换服务器后 HTTPS 打不开,先查什么?
按顺序查:安全组与防火墙是否放通 443;ss -lntp | grep 443 确认服务在监听;证书与私钥路径是否随迁移失效;fullchain 是否漏了中间证书;DNS 是否已切到新 IP 且 TTL 已过期。多数“迁移后报错”是证书文件没带过去或权限不对(Nginx 读不到私钥会启动失败)。
免费的 Let’s Encrypt 和付费 DV 证书有区别吗?
加密强度与浏览器信任上没有区别,两者都受主流浏览器信任,可放心用于商业站点。差异在于:Let’s Encrypt 有效期 90 天且需自动续期;付费 DV 通常带商业支持、可签发更长有效期(上限 398 天)、提供保险与人工协助;若需要证书中出现企业名称,则必须选 OV 或 EV。
EV 证书还会在地址栏显示公司名称吗?
不会。Chrome 77(2019 年)起移除了 EV 证书的绿色地址栏与组织名展示,Firefox、Edge 也已跟进。现在 EV 与 OV 在浏览器中的可见差异仅存在于证书详情与 CT 日志中,选择 EV 应基于合规或招标要求,而不是“地址栏更好看”。
小程序仍报 ssl handshake error 怎么继续排查?
先确认证书链完整且 Verify return code 为 0;再确认服务端已启用 TLS 1.2 及以上、未启用已被淘汰的套件;然后核对请求域名与证书 SAN 是否逐字一致(含 www 与端口);最后检查是否有中间设备(CDN、WAF)在下发自签名或过期证书。真机抓包或让客户端请求一个最小接口,可快速区分是证书问题还是业务层问题。