跳到主要内容
HTTPS安装配置

SSL 证书安装与 HTTPS 配置实战:Linux/Windows 双环境 + 微信小程序 HTTPS 排错指南

SSL 证书安装与 HTTPS 配置实战:Linux/Windows 双环境 + 微信小程序 HTTPS 排错指南 — 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。先导入证书到「本地计算机 – 个人」存储:

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 站点。

内容审核

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