SSL 证书安装与 HTTPS 配置实战:Linux/Windows 双环境 + 微信小程序 HTTPS 排错指南
问题背景与根因:HTTPS 打不开、小程序报错的四类原因
在云厂商买完证书、上传到服务器之后,浏览器地址栏仍然显示「不安全」,微信小程序调用接口直接返回 request:fail ssl hand shake error。绝大多数情况下证书文件本身没有坏,问题出在下面四类根因上。
根因一:证书链不完整。CA 签发时给的是「站点证书 + 中间证书」,很多教程只让你上传站点证书(如 example.com.crt),漏掉了中间证书 ca-bundle.crt / chain.crt。桌面 Chrome 有 AIA 自动补链机制,看起来一切正常;但 Android 微信内置浏览器、微信小程序、Java/Python 客户端不会自动补链,直接握手失败。这是线上最常见的坑。
根因二:域名不匹配。证书 CN/SAN 里只有 example.com,你却用 www.example.com 或 api.example.com 访问,浏览器报 ERR_CERT_COMMON_NAME_INVALID。注意现代浏览器只校验 SAN 扩展,不再看 CN 字段,所以签发时裸域和 www 必须一起写进 SAN。
根因三:TLS 版本与加密套件过旧。微信小程序要求 TLS 1.2 及以上,且不接受自签名证书、IP 地址、非 443 端口。服务器若只开 TLSv1 TLSv1.1,PC 浏览器还能打开,小程序握手直接失败。
根因四:私钥与证书不匹配或证书过期。Let’s Encrypt 证书有效期 90 天;商业 DV/OV 证书按 CA/B Forum 规定最长 398 天,且 SC-081 提案落地后将依次缩短为 200 天(2026-03-15)、100 天(2027-03-15)、47 天(2029-03-15),忘记续期就是全站报错。
先跑三条命令自查,能定位八成的现场问题:
openssl x509 -in fullchain.pem -noout -subject -issuer -dates -ext subjectAltName
openssl x509 -noout -modulus -in fullchain.pem | openssl md5
openssl rsa -noout -modulus -in example.com.key | openssl md5
两条 md5 输出一致,说明私钥与证书配对;-dates 看有效期;subjectAltName 看域名覆盖范围。三项都正常还报错,问题就在协议版本或证书链上。
安装前准备:生成 CSR、识别证书文件与有效期规则
如果证书由云厂商控制台签发(阿里云、腾讯云、华为云),CSR 通常由控制台代生成,可跳过第一步;需要自建 CSR 时执行:
openssl req -new -newkey rsa:2048 -sha256 -nodes
-keyout example.com.key -out example.com.csr
-subj "/C=CN/ST=Zhejiang/L=Hangzhou/O=Example/CN=example.com"
-addext "subjectAltName=DNS:example.com,DNS:www.example.com"
参数说明:-nodes 表示私钥不加密(Nginx 启动时无法交互输入密码,加密私钥会导致 Enter PEM pass phrase 卡死);-sha256 为摘要算法;-addext 把裸域与 www 都写进 SAN,漏写是装完报域名不匹配的头号原因。生成后立刻收紧权限:chmod 600 example.com.key。
签发下来的压缩包文件名五花八门,对照下表识别:
| 文件名常见写法 | 含义 | 用途 |
|---|---|---|
| example.com.crt / _public.crt | 站点证书(只含你的域名) | 不能单独用于生产 |
| ca-bundle.crt / chain.crt / _chain.crt | 中间证书 | 拼接到站点证书之后 |
| fullchain.pem / example.com.pem | 站点证书 + 中间证书 | Nginx、Apache 2.4.8+ 直接用这个 |
| example.com.key / _private.key | 私钥 | 权限必须 600,禁止外泄 |
| example.com.pfx / .p12 | 证书 + 私钥 + 链,带密码 | Windows IIS、Tomcat |
如果只拿到 crt 和 ca-bundle 两个文件,一条命令合成 fullchain:
cat example.com.crt ca-bundle.crt > fullchain.pem
有效期方面,Let’s Encrypt 证书 90 天到期,必须配置自动续期,certbot renew --dry-run 可演练;商业证书最长 398 天,到期前 30 天应完成替换。无论是哪种,都不要把私钥提交进 Git 仓库或放在 Web 根目录下。
Linux + Nginx 完整配置步骤(命令可直接执行)
以下步骤在 Ubuntu 22.04 / CentOS 7+ 均验证通过。第一步,上传文件到独立目录并收紧权限:
sudo mkdir -p /etc/nginx/ssl
sudo cp fullchain.pem /etc/nginx/ssl/example.com.fullchain.pem
sudo cp example.com.key /etc/nginx/ssl/example.com.key
sudo chmod 600 /etc/nginx/ssl/example.com.key
sudo chmod 644 /etc/nginx/ssl/example.com.fullchain.pem
# CentOS / RHEL 开启 SELinux 时还需
sudo restorecon -Rv /etc/nginx/ssl
第二步,写入站点配置 /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/nginx/ssl/example.com.key;
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;
ssl_trusted_certificate /etc/nginx/ssl/example.com.fullchain.pem;
add_header Strict-Transport-Security "max-age=31536000" always;
location / {
proxy_pass http://127.0.0.1:8080;
proxy_set_header Host $host;
proxy_set_header X-Forwarded-Proto https;
}
}
第三步,语法检查并热加载,注意 nginx -t 不通过就不要 reload,否则线上直接 502:
sudo nginx -t
sudo systemctl reload nginx
sudo ss -lntp | grep ':443'
第四步,放行端口。云服务器安全组要单独放行 443,本机防火墙同理:sudo ufw allow 443/tcp 或 sudo firewall-cmd --add-service=https --permanent && sudo firewall-cmd --reload。
用 Let’s Encrypt 免费证书时,certbot 可一键完成上述全部配置:
sudo certbot --nginx -d example.com -d www.example.com --redirect
sudo certbot renew --dry-run
certbot 会自动写入 /etc/letsencrypt/renewal/ 并注册 systemd timer,90 天证书无需人工干预;若用 certonly 模式,则需要自己在 reload 钩子里重启 Nginx:--deploy-hook "systemctl reload nginx"。
Apache 与 Windows IIS 配置示例
Apache(Debian/Ubuntu):先启用模块,再写虚拟主机。
sudo a2enmod ssl headers
sudo systemctl restart apache2
<VirtualHost *:80>
ServerName example.com
Redirect permanent / https://example.com/
</VirtualHost>
<VirtualHost *:443>
ServerName example.com
DocumentRoot /var/www/html
SSLEngine on
SSLCertificateFile /etc/apache2/ssl/example.com.fullchain.pem
SSLCertificateKeyFile /etc/apache2/ssl/example.com.key
# Apache < 2.4.8 才需要下面这行,2.4.8+ 已并入 SSLCertificateFile
# SSLCertificateChainFile /etc/apache2/ssl/ca-bundle.crt
SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1
SSLCipherSuite ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256
SSLHonorCipherOrder off
Header always set Strict-Transport-Security "max-age=31536000"
</VirtualHost>
检查配置:sudo apachectl configtest 输出 Syntax OK 后再 systemctl reload apache2。RHEL 系把包名换成 yum install mod_ssl,配置写在 /etc/httpd/conf.d/ssl.conf。
Windows IIS:IIS 不认 PEM,必须用 pfx。先导入证书到「本地计算机 – 个人」存储:
- HTTPS证书申请 · SSL证书安装部署 · 证书续费
- 代购 SSL 证书 · DigiCert / GeoTrust / RapidSSL 单域名与通配符
- SSL域名证书申请 · 小程序证书 · 国外SSL证书
Import-PfxCertificate -FilePath C:sslexample.com.pfx `
-CertStoreLocation Cert:LocalMachineMy `
-Password (ConvertTo-SecureString -String 'PfxPassword' -AsPlainText -Force)
Get-ChildItem Cert:LocalMachineMy | Select-Object Subject, Thumbprint, NotAfter
然后在 IIS 管理器中选中站点 → 绑定 → 添加 https / 443 / 选择证书;或用命令行绑定并开启 SNI:
New-WebBinding -Name 'Default Web Site' -Protocol https -Port 443 `
-HostHeader example.com -SslFlags 1
netsh http show sslcert hostnameport=example.com:443
-SslFlags 1 表示启用 SNI,同一台机器多站点共用 443 时必须加。netsh 输出中的 Certificate Hash 与证书指纹一致,才算绑定成功。
证书格式、类型与环境配置项对比表
同一张证书有四种封装格式,选错格式就会出现「文件明明在,服务就是起不来」。对照下表:
| 格式 | 扩展名 | 编码 | 适用场景 |
|---|---|---|---|
| PEM | .pem .crt .cer | Base64 文本,含 BEGIN/END 行 | Nginx、Apache、宝塔、Docker |
| DER | .der .cer | 二进制 | Java 部分场景、Windows 双击安装 |
| PKCS#12 | .pfx .p12 | 二进制,含证书+私钥+链,带密码 | IIS、Tomcat、Java 应用 |
| JKS | .jks | Java KeyStore | Tomcat、JBoss、WebLogic |
格式互转常用命令:
# PFX 转 PEM(拆出 fullchain + key)
openssl pkcs12 -in example.com.pfx -nodes -out fullchain.pem
openssl pkcs12 -in example.com.pfx -nocerts -nodes | openssl rsa -out example.com.key
# DER 转 PEM
openssl x509 -inform DER -in example.com.cer -out example.com.pem
# PEM 转 PFX
openssl pkcs12 -export -in fullchain.pem -inkey example.com.key -out example.com.pfx
证书类型选择同样影响成本与覆盖范围:
| 类型 | 覆盖域名 | 典型有效期 | 适用场景 |
|---|---|---|---|
| 单域名 DV | 1 个精确域名(含 www 需另列 SAN) | 398 天内 | 个人站、测试环境 |
| 通配符 DV | *.example.com(仅一级,不含 a.b.example.com) | 398 天内 | 多子域业务后台 |
| 多域名 SAN | 默认 5 个,可扩展到 100 个 | 398 天内 | 多品牌、多主域 |
| Let’s Encrypt | 单域名或多域名 SAN | 90 天,自动续期 | 成本敏感、可自动化 |
不同环境的配置项对照,方便迁移时逐项核对:
| 环境 | 证书配置项 | 私钥配置项 | 备注 |
|---|---|---|---|
| Nginx | ssl_certificate(fullchain) | ssl_certificate_key | 无独立链配置项 |
| Apache 2.4.8+ | SSLCertificateFile(fullchain) | SSLCertificateKeyFile | 不再需要 ChainFile |
| Apache < 2.4.8 | SSLCertificateFile(站点证书) | SSLCertificateKeyFile | 另配 SSLCertificateChainFile |
| IIS | 图形界面绑定或 netsh | 随 pfx 导入 | 需 SNI 标志 |
| 宝塔面板 | SSL → 其他证书 → 粘贴 PEM | 同页粘贴 KEY | 内容含 BEGIN 行 |
常见错误排查:真实报错与定位命令
下面这些报错几乎覆盖了证书安装 90% 的故障,按报错信息直接对号入座:
| 真实报错 | 根因 | 解决 |
|---|---|---|
| nginx: [emerg] cannot load certificate … PEM_read_bio_X509_AUX() failed … no start line | 文件不是 PEM,误传 pfx/der 二进制 | 转格式:openssl pkcs12 -in a.pfx -nodes -out fullchain.pem |
| nginx: [emerg] SSL_CTX_use_PrivateKey_file() failed … key values mismatch | 私钥与证书不配对 | modulus md5 比对,重新下载对应私钥 |
| curl: (60) SSL certificate problem: unable to get local issuer certificate | 缺中间证书 | 改用 fullchain.pem |
| NET::ERR_CERT_COMMON_NAME_INVALID | 访问域名不在 SAN 中 | 重签含该域名的证书 |
| NET::ERR_CERT_DATE_INVALID / certificate has expired | 证书过期 | 续期并 reload |
| request:fail ssl hand shake error(小程序) | TLS 低于 1.2 / 链不全 / 自签名 / 非 443 端口 | 开 TLSv1.2+、补链、换受信 CA |
| ERR_SSL_VERSION_OR_CIPHER_MISMATCH | 协议或套件不匹配 | 配置 TLSv1.2 TLSv1.3 与现代 ECDHE 套件 |
| nginx: [warn] ssl_stapling ignored, issuer certificate not found | 缺少可用于 OCSP 的链 | 配置 ssl_trusted_certificate 指向 fullchain |
| openssl verify error 20 at 0 depth lookup: unable to get local issuer certificate | 链不完整 | 补齐中间证书后再验证 |
逐层定位的三条命令:
# 1) 服务端到底发了什么证书
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | grep -E '^ *[si]:'
# 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 2>/dev/null | grep 'Verify return code'
# 3) 是否仍在监听已被淘汰的协议(应握手失败)
openssl s_client -connect example.com:443 -tls1_1 </dev/null
特别注意小程序侧:登录微信公众平台 → 开发 → 开发管理 → 服务器域名,request 合法域名必须是 HTTPS、443 端口、受信任 CA 签发、TLS 1.2 以上,且不能填 IP。改了证书后若小程序仍报错,先在开发者工具「详情 → 项目配置 → 域名信息」里确认域名已生效,再清缓存重试。
效果验证:命令行核验、小程序联调与到期监控
配置完成不等于验收通过,按下面五步逐项验证,任何一步不通过都算未交付。
# 1) HTTP 是否强制跳转 301
curl -sSI http://example.com | head -n 3
# 2) HTTPS 状态码与证书信息
curl -sSI https://example.com | head -n 5
# 3) 证书链层级(应看到 2~3 个 s: 条目,最后一条为根或中间)
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | grep -c 'BEGIN CERTIFICATE'
# 4) 到期时间与 SAN
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null | openssl x509 -noout -dates -ext subjectAltName
# 5) 加密套件枚举
nmap --script ssl-enum-ciphers -p 443 example.com
浏览器侧验证:Chrome 打开开发者工具 → Security 面板,应显示 Connection - Secure (valid certificate),点击 View certificate 能看到完整链;或用 SSL Labs 在线检测,目标是 A 及以上、Chain issues 为 None、TLS 1.0/1.1 显示 No。
小程序侧验证:在微信开发者工具中真机调试一次 request,确认返回 200;若仍失败,用 openssl s_client 指定 -tls1_2 复测,因为开发者工具走系统网络栈,真机走微信自研栈,两者对证书链的宽容度不同。
最后一定要做到期监控,否则 90 天的 Let’s Encrypt 证书迟早会在某个周末过期。一个可直接放进 crontab 的脚本:
#!/bin/bash
end=$(echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null
| openssl x509 -noout -enddate | cut -d= -f2)
days=$(( ( $(date -d "$end" +%s) - $(date +%s) ) / 86400 ))
if [ "$days" -lt 15 ]; then
echo "SSL 证书剩余 ${days} 天:example.com" | mail -s '[告警] SSL 即将过期' ops@example.com
fi
配合 systemctl list-timers | grep certbot 确认自动续期任务存在,certbot renew --dry-run 每月演练一次,才算真正闭环。
常见问题
多半是证书链不完整或 TLS 版本过低。桌面浏览器有 AIA 自动补链,微信小程序不会。请把站点证书与中间证书拼成 fullchain.pem 后重新配置,并确认只启用 TLSv1.2 和 TLSv1.3,端口必须是 443。
说明 ssl_certificate 指向的文件不是 PEM 文本格式,常见于误把 .pfx 或 .cer 二进制直接上传。执行 openssl pkcs12 -in a.pfx -nodes -out fullchain.pem 转换,确认文件首行是 —–BEGIN CERTIFICATE—– 后重新 nginx -t。
可以,但签发时两个域名必须都写进 SAN 扩展。现代浏览器只校验 SAN 不看 CN,如果只签了裸域,访问 www 就会报 ERR_CERT_COMMON_NAME_INVALID,需要重新签发或改用通配符证书。
有效期 90 天。使用 certbot 安装时会自动注册 systemd timer 或 cron,在到期前 30 天续期并重载服务。建议用 certbot renew –dry-run 验证续期链路,并用 openssl x509 -checkend 提前告警。
目前公开信任的 TLS 证书单张最长有效期 398 天。按 CA/B Forum 的 SC-081 计划,将逐步缩短为 200 天(2026 年 3 月)、100 天(2027 年 3 月)、47 天(2029 年 3 月),建议尽早把续期流程自动化。
不能,IIS 只识别含私钥的 PKCS#12 文件。需先用 openssl pkcs12 -export -in fullchain.pem -inkey example.com.key -out example.com.pfx 转换,再通过 Import-PfxCertificate 导入本地计算机的个人存储并绑定 443 站点。