跳到主要内容
ssl证书按装

SSL 证书 HTTPS 配置全流程实战:CSR 申请、Nginx/Apache 部署、398 天有效期与报错排查

SSL 证书 HTTPS 配置全流程实战:CSR 申请、Nginx/Apache 部署、398 天有效期与报错排查 — 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'

三个必须检查的点:

  1. CN 只写一个主域名,其余全部放 SAN。Chrome 58 起不再读取 CN,只看 subjectAltName,漏写 www 上线就会报证书名称不匹配。
  2. 核对 CSR 内容:openssl req -in example.com.csr -noout -text | grep -A2 'Subject Alternative Name',确认域名列表、大小写与拼写。
  3. 核对私钥与证书是否配对(拿到证书后):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 自动加记录:

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)在下发自签名或过期证书。真机抓包或让客户端请求一个最小接口,可快速区分是证书问题还是业务层问题。

内容审核

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