SSL 证书配置与 HTTPS 部署实战:从 CSR 申请到微信小程序 HTTPS 校验
问题背景与根因:为什么“装了证书”仍然提示不安全
大量站点在服务商处装完证书后,浏览器地址栏依旧显示不安全,微信小程序调用接口仍然报 request:fail ssl hand shake error。问题通常不在证书本身,而在下面三处。
- 证书链不完整:只把域名证书(leaf)写进
ssl_certificate,漏掉中间证书(intermediate)。桌面 Chrome 有 AIA 自动补链能力,可能显示正常;但 Android 旧版 WebView、OkHttp/Java 客户端、微信小程序以及 curl 默认都不补链,直接判定“签发者不受信任”。 - 混合内容(Mixed Content):页面已经 HTTPS,但
img、script、ajax 仍写死http://。Chrome 对主动型混合内容直接拦截,控制台输出Mixed Content: The page at 'https://a.com/' was loaded over HTTPS, but requested an insecure resource 'http://a.com/api'。所谓“不调整网站代码”,卡住的正是这一步。 - 协议与套件过旧:仍开启 TLS 1.0/1.1,或只保留 CBC 套件,新客户端握手失败,报
ERR_SSL_PROTOCOL_ERROR或SSL_ERROR_NO_CYPHER_OVERLAP。
还要正视有效期问题:公共信任证书单张最长 398 天(Apple 与 Chrome 共同执行的行业上限),Let’s Encrypt 免费证书固定 90 天;按 CA/Browser Forum SC-081 计划,2026 年 3 月起降至 200 天、2027 年 100 天、2029 年 47 天。靠人工一年一换必然出现“到期未续”事故,配置必须从第一天就按自动化设计。
前置准备:私钥、CSR 与域名核对
CSR(Certificate Signing Request)是提交给 CA 的申请材料,私钥必须留在自己的服务器上,不要交给服务商“代为生成”再传回。
# 1) 生成 2048 位 RSA 私钥 + CSR,并把所有域名写进 SAN
openssl req -new -newkey rsa:2048 -nodes
-keyout /etc/nginx/ssl/example.com.key
-out /tmp/example.com.csr
-subj "/C=CN/ST=Guangdong/L=Shenzhen/O=Example Co.,Ltd/CN=example.com"
-addext "subjectAltName=DNS:example.com,DNS:www.example.com"
# 2) 校验 CSR 内容,确认 SAN 覆盖全部需要 HTTPS 的域名
openssl req -in /tmp/example.com.csr -noout -text | grep -A1 "Subject Alternative Name"
# 3) 收紧私钥权限,避免被其他进程读取
chmod 600 /etc/nginx/ssl/example.com.key
- ECDSA P-256 私钥更小、握手更快:把
-newkey rsa:2048换成-newkey ec -pkeyopt ec_paramgen_curve:prime256v1。注意 Android 4.x 等老设备不支持 ECDSA,可同时部署 RSA 与 ECDSA 双证书。 - CN 已废弃:Chrome 58 起不再回退匹配 CN,只有 SAN 中的域名才算数。漏写
www就会触发NET::ERR_CERT_COMMON_NAME_INVALID。 - 通配符
*.example.com只覆盖一级子域,a.b.example.com不匹配,也不允许写成*.*.example.com;且它不覆盖主域example.com本身,通常需要一并加入 SAN。
证书申请与域名验证(HTTP-01 / DNS-01)
DV 证书可通过 ACME 协议全自动签发。HTTP-01 需要 80 端口能被公网访问;通配符证书只能走 DNS-01。
# 方式 A:certbot + webroot,续期由 systemd timer 自动触发
certbot certonly --webroot -w /var/www/html
-d example.com -d www.example.com
--email ops@example.com --agree-tos --no-eff-email
# 方式 B:acme.sh + DNS API,支持通配符,签发后自动 reload Nginx
curl https://get.acme.sh | sh -s email=ops@example.com
acme.sh --issue -d example.com -d '*.example.com' --dns dns_ali --keylength ec-256
acme.sh --install-cert -d example.com --ecc
--key-file /etc/nginx/ssl/example.com.key
--fullchain-file /etc/nginx/ssl/example.com.crt
--reloadcmd "systemctl reload nginx"
验证失败的三个高频原因:①域名解析未生效或已指向 CDN,ACME 请求打到了别的机器;②.well-known/acme-challenge/ 被 Nginx 的 location ~ /. 规则拦截,返回 403;③存在 CAA 记录但未授权该 CA,报 CAA record(s) ... do not permit issuance。签发前用 dig +short CAA example.com 自查。
OV/EV 证书需人工提交营业执照或组织信息,审核 1–3 个工作日,不要在有效期只剩几天时才下单。企业对外站点、支付回调域名建议用 OV,证书详情中可展示组织名称,便于用户核验。
Nginx 配置示例:证书链、TLS 1.2/1.3、OCSP 与 HSTS
# /etc/nginx/conf.d/example.com.conf
server {
listen 80;
server_name example.com www.example.com;
return 301 https://$host$request_uri; # 用 $host,避免 CDN 回源时死循环
}
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.crt; # fullchain:域名证书 + 中间证书
ssl_certificate_key /etc/nginx/ssl/example.com.key;
ssl_trusted_certificate /etc/nginx/ssl/example.com-chain.pem; # 只放中间证书,供 OCSP 校验
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;
location / { proxy_pass http://127.0.0.1:8080; }
}
关键细节:拼接顺序必须是“域名证书在前、中间证书在后”,即 cat example.com.crt intermediate.crt > fullchain.crt,反过来会导致部分客户端链校验失败;ssl_trusted_certificate 与 ssl_certificate 不要混用同一个文件。Apache 对应 SSLCertificateFile(含域名证书)与 SSLCertificateChainFile(中间证书)。修改后执行 nginx -t && systemctl reload nginx,用 reload 而不是 restart,避免连接中断。HSTS 首次上线建议先设 max-age=300,确认全站 HTTPS 无遗漏后再调到一年。
微信小程序 HTTPS 要求与后端落地
微信小程序对证书的校验比浏览器更严格,因为它不做 AIA 补链,也不允许用户点“继续访问”。
- 接口域名必须 HTTPS,证书须由受信任 CA 签发,自签名或私有 CA 一律失败;
- TLS 版本需 1.2 及以上,不支持 SSLv3、TLS 1.0/1.1;
- 域名要在微信公众平台「开发管理 → 开发设置 → 服务器域名」中配置为 request 合法域名,只填域名、不带协议与路径,不支持 IP、不支持自定义端口(仅 443);
- 国内主体的域名需完成 ICP 备案;
- 小程序不校验 HSTS 与 OCSP,但要求证书链完整,缺中间证书时 Android 端直接报
request:fail ssl hand shake error。
wx.request({
url: 'https://api.example.com/v1/user', // 必须与后台配置的合法域名完全一致
method: 'GET',
success: res => console.log(res.data),
fail: err => console.error(err.errMsg) // 先打印真实 errMsg 再定位
});
真机排查顺序:①在开发者工具「详情 → 域名信息」确认配置已生效(平台侧有 5–10 分钟缓存);②用手机浏览器访问同一 URL,若也报错,说明问题在服务端证书链而非小程序配置;③执行 openssl s_client -connect api.example.com:443 -servername api.example.com -showcerts,数一下返回几张证书,正常应为 2 张(域名证书 + 中间证书)。另外注意 iOS 与 Android 的差异:Android 7 起对证书链完整性更敏感,而 iOS 会校验服务器是否发送完整链,两端都要测。
证书类型与部署方式对比
| 证书类型 | 覆盖范围 | 验证方式 | 单张有效期 | 典型场景 |
|---|---|---|---|---|
| 单域名 DV | 1 个精确域名 | DNS/HTTP-01 | ≤398 天(Let’s Encrypt 90 天) | 测试环境、个人站点 |
| 多域名 SAN | 多个不同域名(常见上限 100) | DV 或 OV | ≤398 天 | 主站 + API + 管理后台 |
| 通配符 DV/OV | *.example.com 一级子域 | 仅 DNS-01 | ≤398 天 | 子域数量多、弹性扩容 |
| OV 组织型 | 按购买域名数 | 企业资质审核 | ≤398 天 | 支付回调、对外业务 |
| 部署方式 | 续期方式 | 运维成本 | 适用规模 |
|---|---|---|---|
| 手工上传 + 重启 | 人工,易漏 | 高,每年至少一次停机风险 | 1–2 个域名 |
| certbot 自动续期 | systemd timer | 低,需 80 端口 | 单机站点 |
| acme.sh + DNS API | cron + reloadcmd | 低,支持通配符 | 多域名、内网机器 |
| CDN/负载均衡托管 | 云厂商自动 | 最低,需回源 HTTPS | 已有 CDN 的业务 |
选型结论:域名数 ≤3 且无通配符需求,用 certbot 最省事;子域多、机器在内网无公网 80 端口,选 acme.sh 的 DNS-01;已接入 CDN 的,优先在 CDN 侧托管证书,但必须同步把回源协议改为 HTTPS,否则源站仍是明文,且容易出现 301 循环。
常见错误排查(含真实报错)
| 真实报错 | 根因 | 修复 |
|---|---|---|
curl: (60) SSL certificate problem: unable to get local issuer certificate |
证书链缺中间证书 | ssl_certificate 指向 fullchain |
NET::ERR_CERT_COMMON_NAME_INVALID |
SAN 不含当前访问域名 | 补全 SAN 后重新签发 |
nginx: [emerg] SSL_CTX_use_PrivateKey(...) failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch) |
证书与私钥不配对 | 用下方命令比对 modulus |
nginx: [emerg] PEM_read_bio_X509_AUX(...) failed (SSL: error:0909006C:PEM routines:get_name:no start line) |
文件是 DER 格式、为空或含 BOM | openssl x509 -in a.crt -out a.pem 转 PEM |
Mixed Content: The page at 'https://a.com/' was loaded over HTTPS, but requested an insecure resource |
页面内残留 http 资源 | 改为相对协议 // 或 https |
request:fail ssl hand shake error(小程序) |
链不全或协议低于 TLS 1.2 | 补中间证书 + 禁用 TLS 1.0/1.1 |
ERR_TOO_MANY_REDIRECTS |
CDN 回源 80 又被 301 | 回源改 HTTPS,跳转用 $host |
# 校验证书与私钥是否匹配(RSA):两个 md5 必须一致
openssl x509 -noout -modulus -in example.com.crt | openssl md5
openssl rsa -noout -modulus -in example.com.key | openssl md5
# ECDSA 证书改用公钥比对
openssl x509 -noout -pubkey -in example.com.crt | openssl md5
openssl pkey -pubout -in example.com.key | openssl md5
效果验证:从命令行到真机
# 1) 查看证书主体、签发者与有效期
printf '' | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null
| openssl x509 -noout -subject -issuer -dates
# 2) 校验证书链,输出必须包含 "Verify return code: 0 (ok)"
openssl s_client -connect example.com:443 -servername example.com -CAfile /etc/ssl/certs/ca-certificates.crt </dev/null
# 3) 确认已协商到 TLS 1.3
openssl s_client -connect example.com:443 -servername example.com -tls1_3 </dev/null | grep Protocol
# 4) HTTP 层:80 应 301 到 https,443 应带 HSTS 头
curl -sSI http://example.com | head -5
curl -sSI https://example.com | grep -i strict-transport-security
# 5) 到期监控:剩余不足 30 天时返回非 0,可接入告警
printf '' | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null
| openssl x509 -noout -checkend 2592000 || echo "证书 30 天内到期"
命令行全绿之后,再做三层验收:①SSL Labs 或 MySSL 在线评级,目标 A 及以上,重点看“证书链不完整”“TLS 1.0 可协商”两项告警;②浏览器 F12 的 Console 与 Network,确认无 Mixed Content 与证书错误;③微信开发者工具 + iOS/Android 真机各跑一次接口,Android 端尤其要测,它对中间证书缺失最敏感。最后把第 5 条命令挂到 cron,每天执行一次,比任何人工巡检都可靠。
常见问题
可以,但两个域名必须在同一张证书的 SAN 中同时列出,签发后无法追加。已有单域名证书只能重新签发;预算允许可直接申请通配符 *.example.com,但要注意它不覆盖主域本身,通常需把 example.com 一并写入 SAN。
先执行 nginx -t 看具体报错。最常见是 key values mismatch(证书与私钥不配对)和 PEM_read_bio_X509_AUX failed(文件为 DER 格式或内容为空)。用 openssl 比对证书与私钥的 modulus 或公钥,一致才能加载,最后用 systemctl reload 而非 restart。
浏览器有 AIA 自动补链,缺中间证书也能通过;小程序和 Android 网络栈不做补链。把 ssl_certificate 指向 fullchain(域名证书在前、中间证书在后),用 openssl s_client -showcerts 确认返回 2 张证书,并确保协议为 TLS 1.2 及以上。
目前公共信任证书单张最长 398 天,Let’s Encrypt 为 90 天;按 CA/B Forum SC-081 计划,2026 年 3 月起缩短至 200 天、2027 年 100 天、2029 年 47 天。不要人工换证,用 certbot 或 acme.sh 自动续期并 reload,再叠加到期告警。
不能。*.example.com 只匹配 a.example.com 这一级,a.b.example.com 不匹配,也不支持 *.*.example.com。多级子域需为每一级单独申请,或改用多域名 SAN 证书把具体域名逐一列出,SAN 数量上限依 CA 而定。
多数是 CDN 回源仍走 80 端口并再次被 301,或跳转规则写死域名导致 www 与非 www 互相跳转。把规则改为 return 301 https://$host$request_uri;,并在 CDN 侧把回源协议设为 HTTPS 或“跟随”,同时清理代码层的二次跳转。