跳到主要内容
ssl证书按装

SSL 证书配置与 HTTPS 部署实战:从 CSR 申请到微信小程序 HTTPS 校验

SSL 证书配置与 HTTPS 部署实战:从 CSR 申请到微信小程序 HTTPS 校验 — 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 或“跟随”,同时清理代码层的二次跳转。

内容审核

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