SSL 证书申请与 HTTPS 部署全指南:Nginx/Apache/IIS/Tomcat 适配小程序与 APP TLS 1.2
问题背景与根因:小程序和 APP 为什么卡在 HTTPS 与 TLS 1.2
微信小程序、Android 与 iOS APP 调用后端时,普遍要求 HTTPS 与 TLS 1.2 及以上。小程序侧还要求域名已备案并加入服务器域名白名单,证书必须由受信任 CA 签发;Android 7.0 起默认只信任系统 CA,iOS ATS 默认要求 TLS 1.2 与完整证书链。最常见的根因是证书链不完整、域名与 SAN 不匹配、服务器仍开放 TLS 1.0/1.1、未配置 SNI,或把自签名证书装到客户端,而非证书没买。公开信任的 TLS 证书最长有效期为 398 天,Let’s Encrypt 为 90 天,旧文章里的多年期证书已不符合现状。先执行 openssl s_client -connect example.com:443 -servername example.com -tls1_2 </dev/null,输出末尾出现 Verify return code: 0 (ok) 才说明 TLS 1.2 与证书链基本可用。若出现 curl: (60) SSL certificate problem: unable to get local issuer certificate,优先检查 fullchain 是否缺少中间证书。根因排查表:域名不匹配查 SAN;链不完整查 s_client -showcerts;协议不兼容查 ssl_protocols;老 Android 报错查 RSA/ECC 套件。修正事实:TLS 1.0/1.1 已不应启用,TLS 1.2 是兼容底线,TLS 1.3 可并行开启。
申请 SSL 证书与生成 CSR:从域名校验到证书文件落盘
在服务器上生成私钥与 CSR,私钥不要上传给任何人。OpenSSL 1.1.1+ 可直接写 SAN:
openssl req -new -newkey rsa:2048 -nodes -keyout example.com.key -out example.com.csr -subj '/C=CN/ST=Beijing/L=Beijing/O=Example/CN=example.com' -addext 'subjectAltName=DNS:example.com,DNS:www.example.com'
openssl req -in example.com.csr -noout -text | grep -A1 'Subject Alternative Name'
chmod 600 example.com.key
提交 CSR 后按 CA 要求做 DNS TXT 或文件验证。签发后通常得到 domain.crt、ca_bundle.crt、privkey.pem;Nginx/Apache 使用 fullchain.pem 更稳:cat domain.crt ca_bundle.crt > fullchain.pem,注意 fullchain 只放服务器证书和中间证书,不要放根证书。验证链:openssl verify -CAfile ca_bundle.crt fullchain.pem。有效期要按新规规划:公开信任 TLS 证书最长 398 天,Let’s Encrypt 90 天,必须配置自动续期与 reload。CSR 中 CN 只写主域名,多域名和通配符必须进 SAN;小程序、APP、H5 共用同一域名时,SAN 要覆盖实际访问域名。私钥权限 600,证书目录不要允许目录浏览。若 CA 只给 .pfx,IIS 可直接导入;Nginx/Apache/Tomcat 需转换,后文给出命令。
Nginx 与 Apache 配置示例:可直接落地的 TLS 1.2/1.3 参数
Nginx 1.15+ 不要再用 ssl on;,改为 listen 443 ssl。示例:
server {
listen 443 ssl http2;
server_name example.com www.example.com;
ssl_certificate /etc/nginx/ssl/fullchain.pem;
ssl_certificate_key /etc/nginx/ssl/privkey.pem;
ssl_protocols TLSv1.2 TLSv1.3;
ssl_ciphers 'ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384';
ssl_prefer_server_ciphers off;
ssl_session_cache shared:SSL:10m;
ssl_session_timeout 1d;
add_header Strict-Transport-Security 'max-age=31536000' always;
}
执行 nginx -t && systemctl reload nginx。Apache 2.4 示例:
LoadModule ssl_module modules/mod_ssl.so
Listen 443 https
<VirtualHost *:443>
ServerName example.com
SSLEngine on
SSLCertificateFile /etc/httpd/ssl/domain.crt
SSLCertificateKeyFile /etc/httpd/ssl/domain.key
SSLCertificateChainFile /etc/httpd/ssl/chain.crt
SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1
SSLCipherSuite ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256
SSLHonorCipherOrder off
</VirtualHost>
执行 httpd -t && systemctl reload httpd。关键点:证书路径必须是绝对路径;Apache 的 SSLCertificateFile 若使用 fullchain 可省 ChainFile,但老版本建议分开;不要保留 SSLv2/SSLv3;小程序和 APP 只需 TLS 1.2 即可握手,TLS 1.3 提升性能。若前面有 CDN/SLB,源站也要配证书,否则回源可能 502 或证书校验失败。
IIS、宝塔与 Tomcat 配置示例:PFX/JKS 与端口绑定
IIS:把 CA 给的 .pfx 导入“服务器证书”,站点绑定 443 并勾选 SNI,证书链通常包含在 PFX 中。PowerShell 可执行:Import-PfxCertificate -FilePath C:/ssl/example.pfx -CertStoreLocation Cert:/LocalMachine/My -Password (ConvertTo-SecureString '证书密码' -AsPlainText -Force)。宝塔:网站设置 → SSL → 其他证书,分别粘贴 fullchain.pem 与 privkey.pem,保存后开启强制 HTTPS;宝塔会调用 Nginx 或 Apache,改完执行 nginx -t 或 apachectl -t。Tomcat 建议用 PKCS12 再转 JKS:
openssl pkcs12 -export -in fullchain.pem -inkey privkey.pem -out example.p12 -name tomcat -CAfile chain.pem -caname root
keytool -importkeystore -deststorepass 密码 -destkeypass 密码 -destkeystore example.jks -srckeystore example.p12 -srcstoretype PKCS12 -srcstorepass 密码 -alias tomcat
server.xml 的 Connector 示例:<Connector port='443' protocol='org.apache.coyote.http11.Http11NioProtocol' SSLEnabled='true' scheme='https' secure='true' keystoreFile='/opt/tomcat/conf/example.jks' keystorePass='密码' sslEnabledProtocols='TLSv1.2,TLSv1.3' />。注意 keystorePass 与 keypass 一致,Tomcat 9 建议启用 TLS 1.2/1.3。IIS 导出备份时勾选“导出私钥”,记下密码;Tomcat 修改后重启,检查 443 监听。
多平台部署对比表格:证书格式、命令与 TLS 参数
不同平台的证书格式与验证命令差异很大,选错格式会出现“文件存在但握手失败”。对照表:
- SSL/HTTPS 证书配置 · 证书安装 · 证书申请
- Wildcard 通配符 SSL 证书安装部署续费申请
- 代购 SSL 证书 · DigiCert / GeoTrust / RapidSSL 单域名与通配符
| 平台 | 推荐证书格式 | 关键配置 | 验证命令 | 注意 |
|---|---|---|---|---|
| Nginx | fullchain.pem + privkey.pem | listen 443 ssl; ssl_certificate; ssl_certificate_key | nginx -t | 不要用 ssl on; 链要完整 |
| Apache | domain.crt + key + chain.crt | SSLCertificateFile/KeyFile/ChainFile | apachectl -t | 2.4.8+ 可用 fullchain |
| IIS | .pfx | 服务器证书导入、443 绑定、SNI | 浏览器/SSL Labs | PFX 含私钥与链 |
| 宝塔 | fullchain + key 文本 | SSL 面板粘贴、强制 HTTPS | nginx -t | 注意面板实际 Web 服务 |
| Tomcat | JKS 或 PKCS12 | keystoreFile、keystorePass、sslEnabledProtocols | keytool -list | 密码与 alias 要匹配 |
格式转换优先用 OpenSSL:openssl pkcs12 -in example.pfx -nodes -out all.pem 可拆出私钥和证书;openssl rsa -in privkey.pem -check 检查私钥。表格中的验证命令只能证明语法与本地文件可读,最终仍要用 openssl s_client -connect example.com:443 -servername example.com -tls1_2 验证握手和链。公开信任证书最长 398 天,Let’s Encrypt 90 天,续期后必须 reload 对应服务。
常见错误排查:真实报错与逐条修复
1)curl: (60) SSL certificate problem: unable to get local issuer certificate:服务器只发了站点证书,缺中间证书。用 openssl s_client -connect example.com:443 -servername example.com -showcerts 看证书数量,把中间证书拼进 fullchain。2)NET::ERR_CERT_COMMON_NAME_INVALID 或小程序提示证书域名不匹配:CSR 的 SAN 没覆盖 www、API 子域名,重新签发,不要只改 CN。3)request:fail ssl hand shake error:小程序侧握手失败,先查 openssl s_client -connect api.example.com:443 -servername api.example.com -tls1_2,再查是否只开 TLS1.0/1.1 或链不完整。4)Android 报 javax.net.ssl.SSLHandshakeException: Handshake failed:老系统或自定义 TrustManager 不信任链,优先补全链、用 RSA 2048 兼容套件,不要关闭校验。5)Nginx 报 [emerg] unknown directive 'ssl':未装 http_ssl_module 或仍写 ssl on;,改 listen 443 ssl; 并 nginx -V | grep with-http_ssl_module。6)Apache 报 AH02217: ssl_stapling_init_cert failed:OCSP stapling 缺链或证书不匹配,先补 chain 再开 stapling。7)Tomcat 报 java.io.IOException: Keystore was tampered with, or password was incorrect:keystorePass 与生成时不一致,重做 JKS 并核对 alias。每条修复后都执行 nginx -t、httpd -t 或重启 Tomcat,再用 s_client 复测。
效果验证与自动化续期:openssl、curl 与证书到期监控
部署后至少做三层验证。第一层看证书主题、签发者、有效期:openssl s_client -connect example.com:443 -servername example.com -tls1_2 </dev/null 2>/dev/null | openssl x509 -noout -subject -issuer -dates。第二层强制 TLS 1.2 请求:curl -I --tlsv1.2 --tls-max 1.2 https://example.com,应返回 200/301/302 而非证书错误。第三层枚举协议与套件:nmap --script ssl-enum-ciphers -p 443 example.com,确认 TLS1.0/1.1 不出现,TLS1.2/1.3 可用。Let’s Encrypt 用 certbot 自动续期:certbot renew --dry-run,续期后钩子执行 systemctl reload nginx。到期监控可用 openssl x509 -checkend 2592000 -noout -in fullchain.pem,返回 0 表示 30 天内不过期。注意公开信任证书最长 398 天,Let’s Encrypt 90 天,不能依赖人工年检。小程序和 APP 发布后仍要复测,因为 CDN、SLB、源站任一层证书过期都会导致握手失败。最后用 SSL Labs 或 testssl.sh 检查链、协议与 HSTS。
常见问题
小程序必须使用哪种 SSL 证书?
使用受信任 CA 签发的 DV、OV 或 EV 证书均可,核心是域名与 SAN 匹配、证书链完整、服务器支持 TLS 1.2 及以上;自签名证书和过期证书会导致 request:fail。域名还需按小程序要求完成备案与服务器域名配置。
证书最长有效期是多久?
公开信任的 TLS 证书最长有效期为 398 天,Let’s Encrypt 免费证书为 90 天。应使用自动续期和到期监控,不要购买或部署多年期证书。
一张证书能同时用于小程序、APP 和多个域名吗?
可以。使用 SAN 多域名证书或通配符证书覆盖实际访问域名即可。APP 端不要硬编码证书内容,应校验证书链和域名,并预留证书轮换能力。
为什么浏览器正常,Android 或 iOS 却握手失败?
常见原因是证书链不完整、只开 TLS 1.0/1.1、加密套件不兼容或客户端信任库旧。用 openssl s_client -tls1_2 和 SSL Labs 检查,补中间证书并启用 TLS 1.2/1.3。
Nginx 配置 ssl on 报错怎么办?
Nginx 1.15+ 已弃用 ssl on;,改为 listen 443 ssl;,证书用 ssl_certificate 与 ssl_certificate_key 指定,执行 nginx -t 后 reload。
需要开启 TLS 1.3 吗?
建议同时开启 TLS 1.2 和 TLS 1.3,关闭 TLS 1.0/1.1。TLS 1.2 是兼容小程序和旧 APP 的底线,TLS 1.3 可提升握手性能,但要以实际客户端测试为准。