跳到主要内容
ssl证书按装

SSL 证书申请与 HTTPS 部署全流程:宝塔 / phpStudy / IIS 配置与微信小程序握手失败排查

SSL 证书申请与 HTTPS 部署全流程:宝塔 / phpStudy / IIS 配置与微信小程序握手失败排查 — SSL 证书申请与 HTTPS 部署全流程:宝塔 / phpStudy / IIS 配置与微信小程序握手失败排查

一、问题背景与根因:小程序为什么强制 HTTPS,旧教程哪些说法已经失效

微信小程序自 2017 年起对 wx.request、wx.uploadFile、wx.connectSocket 等网络接口强制要求 HTTPS,服务端必须同时满足五个条件:证书由受信任 CA 签发(自签名一律拒绝)、TLS 协议版本不低于 1.2、支持前向保密套件(ECDHE 系列)、使用域名而非 IP 访问、中国大陆服务器域名已完成 ICP 备案并在公众平台“服务器域名”白名单中登记。浏览器侧同理,Chrome 从 68 起对 HTTP 页面标记“不安全”,Safari 的 ATS 要求 TLS 1.2 + 前向保密。

但这篇旧文有三处事实已经过时,直接照做会踩坑:

  1. “有效期一年的证书”已不存在。2020-09-01 起 CA/B Forum 规定公开信任证书单张最长 398 天,Chrome / Safari 会直接拒绝超期证书;Let’s Encrypt 固定 90 天。且已确定 2026-03-15 起缩短至 200 天、2027-03-15 起 100 天、2029-03-15 起 47 天,必须规划自动续期,不能靠人工一年一换。
  2. “EV 证书地址栏显示公司名”已失效。Chrome 77(2019-09)起移除 EV 标识,Safari、Firefox 同样不再展示,EV 现在只剩合规审计与赔付条款的价值。
  3. “通配符包含所有二级域名”不准确。*.example.com 只匹配 a.example.com 这一级,既不匹配裸域 example.com,也不匹配 a.b.example.com。

线上真实故障的根因排序是:证书链不完整(缺中间证书)> 域名不匹配(SAN 缺失)> TLS 版本或加密套件不满足客户端要求 > 混合内容。部署前先对照下表确认客户端门槛:

客户端 协议要求 证书要求 附加限制
微信小程序 TLS 1.2 及以上 受信任 CA、SAN 匹配 不支持自签名/IP、需备案
iOS ATS TLS 1.2 及以上 RSA ≥2048 或 ECC ≥256 需前向保密套件
Chrome / Edge TLS 1.2 及以上 有效期 ≤398 天 需完整证书链
Android 7+ TLS 1.2 及以上 系统信任库 旧机型对交叉签名敏感

二、证书选型:DV / OV / EV 与单域名 / 多域名 / 通配符怎么选

选证书要拆成两个独立维度看:验证强度决定审核流程和价格,覆盖范围决定能保护哪些域名,二者互不影响。先看验证强度:

类型 验证内容 签发时长 典型用途
DV 域名型 仅验证域名控制权(DNS TXT / 文件) 几分钟 个人站、API 网关、小程序后端
OV 企业型 域名 + 企业工商信息人工审核 1-5 工作日 企业门户、SaaS 平台
EV 增强型 OV + 更严格的组织核验 3-7 工作日 金融、支付、合规审计场景

再看覆盖范围,这是最容易买错的地方:

  • 单域名证书:只保护一个 FQDN,www.example.com 和 example.com 视为两个域名。
  • 多域名证书(SAN / UCC):一张证书可写多个域名,通常赠送 3-5 个 SAN 位,超出按个加价,适合 api. / m. / static. 多个子域。
  • 通配符证书:*.example.com 覆盖任意一级子域,但不含裸域,也不覆盖二级子域;签发时一般强制 DNS-01 验证。

免费方案要区分清楚:Let’s Encrypt、ZeroSSL 提供 90 天 DV 证书,支持通配符,可用 acme.sh 或 certbot 全自动续期,是个人站和小程序后端的首选;国内云厂商的“免费 DV”多为 3 个月期且限制张数,同样需要自动化。付费 DV 的价值主要在 398 天有效期、商业保险和人工支持。

选型结论:

  1. 个人博客、小程序接口、内部测试:Let’s Encrypt 或付费 DV,单域名即可。
  2. 主域 + www + 多个子域:多域名证书,或直接通配符 + 裸域 SAN 组合。
  3. 企业官网需要显示组织信息、过等保或投标:OV。
  4. EV 仅在有明确合规要求时购买,别指望地址栏展示公司名。

三、申请实操:生成 CSR、DNS TXT 验证与 ACME 自动签发

申请前准备三样东西:待签发域名清单、DNS 解析管理权限、Web 服务器类型与版本。所有命令在 Linux / macOS 的 OpenSSL 下执行,Windows 可用 Git Bash 或 WSL。

第一步,生成私钥与 CSR。推荐 2048 位 RSA(兼容性最好),或 P-256 椭圆曲线(握手更快,现代客户端均支持):

# RSA 2048
openssl genrsa -out example.com.key 2048
openssl req -new -key example.com.key -out example.com.csr 
  -subj "/C=CN/ST=Zhejiang/L=Hangzhou/O=Example Tech/CN=example.com"

# 或 ECC P-256
openssl ecparam -genkey -name prime256v1 -out example.com.key
openssl req -new -key example.com.key -out example.com.csr 
  -subj "/C=CN/ST=Zhejiang/L=Hangzhou/O=Example Tech/CN=example.com"

私钥权限必须收紧:chmod 600 example.com.key,否则 Nginx 启动会报权限错误,或被扫描器判定为泄露风险。

第二步,检查 CSR 内容。提交前务必确认 Common Name 和 SAN 都正确,SAN 才是现代客户端的校验依据:

openssl req -in example.com.csr -noout -subject -text | grep -A1 "Subject Alternative Name"

第三步,DNS TXT 验证。CA 会给出类似 _dnsauth.example.com 的主机记录和一段随机值,在 DNS 服务商添加 TXT 记录后先本地确认生效再点验证,避免触发风控重试限制:

dig +short TXT _dnsauth.example.com @8.8.8.8
nslookup -type=TXT _dnsauth.example.com 8.8.8.8

三个细节:TXT 值不要手工加英文双引号(多数 DNS 商会自动加,导致校验失败);TTL 设 600 以内便于回滚;主域和 www 都要签发时,务必两个域名都写进 SAN 或分别添加 TXT。

第四步,自动化签发(推荐长期方案)。用 acme.sh 一次配置、永久续期:

curl https://get.acme.sh | sh -s email=admin@example.com
~/.acme.sh/acme.sh --issue -d example.com -d www.example.com 
  --webroot /www/wwwroot/example.com
~/.acme.sh/acme.sh --install-cert -d example.com 
  --key-file /etc/nginx/ssl/example.com.key 
  --fullchain-file /etc/nginx/ssl/fullchain.pem 
  --reloadcmd "nginx -t && nginx -s reload"

签发完成后你会拿到三个文件:example.com.key(私钥,绝不能外泄)、example.com.crt(站点证书)、chain.crt(中间证书)。部署时要合并成 fullchain.pem,站点证书在前、中间证书在后,根证书不要放:

cat example.com.crt chain.crt > fullchain.pem
openssl verify -CAfile chain.crt -untrusted chain.crt example.com.crt

四、宝塔面板部署 Nginx 站点并强制 HTTPS

宝塔(BT Panel)是中小站点最常见的环境,操作路径清晰,但仍有几处容易出错。

步骤一:上传或申请证书。登录面板 → 网站 → 目标站点“设置” → SSL。两种方式:

  • 免费申请:切到“Let’s Encrypt”标签,勾选 example.com 与 www.example.com,验证方式选“文件验证”(需 80 端口可访问)或“DNS 验证”,点击申请。
  • 已有证书:切到“其他证书”,把 fullchain.pem 全部内容粘进“密钥(KEY)”上方的证书框,把 example.com.key 内容粘进“密钥(KEY)”框,保存。

粘贴顺序错误是最常见的失败原因:把中间证书放在最前面,浏览器会报 NET::ERR_CERT_AUTHORITY_INVALID;只贴站点证书不贴中间证书,安卓端和小程序会直接握手失败。

步骤二:开启强制 HTTPS。SSL 页面上方打开“强制 HTTPS”开关,宝塔会自动写入 301 跳转规则;也可以手工在配置里加:

server {
    listen 80;
    server_name example.com www.example.com;
    return 301 https://$host$request_uri;
}

步骤三:放行 443 端口。面板放行只是第一层,云服务器安全组是第二层:

# firewalld
firewall-cmd --add-service=https --permanent && firewall-cmd --reload
# ufw
ufw allow 443/tcp
# 确认监听
ss -lntp | grep -E ':80|:443'

步骤四:校验并重载。改完配置不要直接重启,先 nginx -t 检查语法,通过后再 reload,避免整站中断:

nginx -t
nginx -s reload

步骤五:续期保障。Let’s Encrypt 只有 90 天。面板的“计划任务”里默认存在 SSL 自动续签任务,确认状态为“正常”;用 acme.sh 的则检查 crontab 是否有 ~/.acme.sh/acme.sh --cron。续期失败最常见的两个原因是 80 端口被 CDN 或防火墙拦截、DNS API 密钥过期。

特别提醒:如果站点前面挂了 CDN 或反向代理(如 Nginx 反代到 Tomcat),证书必须装在最外层的反代上;同时后端要正确识别 X-Forwarded-Proto,否则 PHP 里判断 $_SERVER['HTTPS'] 为空,会出现“已上 HTTPS 却仍跳转到 http”的死循环。

五、phpStudy(Apache/Nginx)与 IIS 的证书安装

phpStudy v8 面板方式:网站 → 目标站点“管理” → SSL(HTTPS) → 粘贴证书与私钥 → 保存 → 重启对应服务。phpStudy 同时支持 Apache 与 Nginx,切换环境后需要重新配置一次证书路径。

phpStudy 手动 Apache 方式:先确认 httpd.conf 中已启用 SSL 模块并监听 443:

LoadModule ssl_module modules/mod_ssl.so
Include conf/extra/httpd-ssl.conf
Listen 443

然后在 httpd-ssl.conf 中配置站点。注意 Apache 2.4.8 及以上版本可以把站点证书与中间证书合并写在 SSLCertificateFile 里;更早版本必须单独指定 SSLCertificateChainFile,否则链不完整:

<VirtualHost *:443>
    ServerName example.com
    DocumentRoot "D:/phpstudy_pro/WWW/example.com"
    SSLEngine on
    SSLCertificateFile "D:/ssl/fullchain.crt"
    SSLCertificateKeyFile "D:/ssl/example.com.key"
    <Directory "D:/phpstudy_pro/WWW/example.com">
        Options FollowSymLinks
        AllowOverride All
        Require all granted
    </Directory>
</VirtualHost>

IIS 方式:IIS 只认 .pfx(含私钥的 PKCS#12),需要先转换,或直接用 Windows 的 certutil 合并:

openssl pkcs12 -export -out example.com.pfx 
  -inkey example.com.key -in example.com.crt 
  -certfile chain.crt -passout pass:YourPassword

导入步骤:Win + R 输入 certlm.msc → 个人 → 证书 → 所有任务 → 导入 → 选择 pfx → 输入密码 → 存储位置选“个人”。关键点:若中间证书没有随 pfx 一起进入“中间证书颁发机构”存储,IIS 对外提供的链就是不完整的,浏览器可能正常(有 AIA 自动补链)但小程序和部分安卓机握手失败。可在“中间证书颁发机构 → 证书”中手动导入 chain.crt。

随后在 IIS 管理器 → 站点 → 右侧“绑定” → 添加 → 类型 https、端口 443、SSL 证书选择刚导入的证书。IIS 8 及以上支持 SNI,多站点共用 443 时勾选“需要服务器名称指示”。命令行验证与绑定:

netsh http show sslcert
netsh http add sslcert ipport=0.0.0.0:443 certhash=<证书指纹> appid={4dc3e181-e14b-4a21-b022-59fc669b0914}

指纹可从证书详情页复制,注意去掉空格。绑定完成后重启站点即可,无需重启整台服务器。

六、配置示例汇总与三平台对比

Nginx 完整配置(宝塔 / phpStudy-Nginx 通用):注意 Nginx 1.25.1 之后 http2 不再写在 listen 行,改为独立指令,写错会导致启动失败。

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/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-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384;
    ssl_prefer_server_ciphers on;
    ssl_session_cache   shared:SSL:10m;
    ssl_session_timeout 10m;
    add_header Strict-Transport-Security "max-age=31536000" always;

    root /www/wwwroot/example.com;
    index index.php index.html;
}

server {
    listen 80;
    server_name example.com www.example.com;
    return 301 https://$host$request_uri;
}

IIS 强制跳转(web.config,需安装 URL Rewrite 模块):

<configuration>
  <system.webServer>
    <rewrite>
      <rules>
        <rule name="Force HTTPS" stopProcessing="true">
          <match url="(.*)" />
          <conditions>
            <add input="{HTTPS}" pattern="^OFF$" />
          </conditions>
          <action type="Redirect" url="https://{HTTP_HOST}/{R:1}" redirectType="Permanent" />
        </rule>
      </rules>
    </rewrite>
  </system.webServer>
</configuration>

三平台关键差异对比:

项目 宝塔面板 phpStudy IIS
证书文件格式 fullchain.pem + privkey.pem Apache: .crt(含链) + .key .pfx(含私钥)
证书存放位置 /www/server/panel/vhost/cert/域名/ 自定义目录,注意读权限 Windows 证书存储“个人”
生效命令 nginx -t && nginx -s reload 重启 Apache/Nginx 服务 重启站点或 iisreset
强制跳转方式 面板开关 / return 301 .htaccess RewriteRule web.config URL Rewrite
高频坑 证书粘贴顺序、443 未放行 mod_ssl 未启用、80 被占用 中间证书缺失、未勾 SNI
自动续期 计划任务内置 需自建 acme.sh 定时 需自建脚本 + win-acme

Apache 下的 .htaccess 跳转示例:

RewriteEngine On
RewriteCond %{HTTPS} off
RewriteRule ^(.*)$ https://%{HTTP_HOST}/$1 [R=301,L]

三个平台都遵循同一条铁律:改配置前先备份,改完先做语法检查再重载,不要直接重启服务,否则一个分号错误就会导致全站 502 或 403。

七、常见错误排查:真实报错与修复命令

1. curl: (60) SSL certificate problem: unable to get local issuer certificate

服务端证书链不完整,缺中间证书。修复:拼接 fullchain 并验证。

cat example.com.crt chain.crt > fullchain.pem
openssl verify -CAfile chain.crt -untrusted chain.crt example.com.crt
# 期望输出:example.com.crt: OK

2. 小程序 request:fail 未能找到使用指定主机名的服务器 / 浏览器 NET::ERR_CERT_COMMON_NAME_INVALID

域名不在证书 SAN 里。典型场景:只签了 example.com 却用 www.example.com 访问,或买了通配符 *.example.com 却访问裸域。核对命令:

openssl x509 -in fullchain.pem -noout -text | grep -A1 "Subject Alternative Name"

3. 小程序 request:fail ssl handshake failed

服务端未启用 TLS 1.2、加密套件只保留 CBC/RC4/3DES,或证书链不全。逐项验证:

openssl s_client -connect api.example.com:443 -servername api.example.com -tls1_2 </dev/null 2>&1 | grep -E "Protocol|Cipher|Verify return code"
# Verify return code 必须是 0 (ok);返回 21 表示链不完整,20 表示无法获取本地签发者

4. ERR_SSL_PROTOCOL_ERROR

通常是访问了未监听 443 的端口,或 Nginx 配置未 reload,或客户端被强制降级到 TLS 1.0。检查监听与协议:

ss -lntp | grep 443
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>&1 | grep "Protocol"

5. nginx: [emerg] cannot load certificate “…fullchain.pem”: PEM_read_bio_X509_AUX() failed

文件不是 PEM 格式(比如误传了 .pfx 或 .der),或路径写错、权限不足。用 head -1 fullchain.pem 确认首行是 -----BEGIN CERTIFICATE-----,并 chmod 600 私钥。

6. IIS 站点访问报 HTTP 错误 403.7 – Forbidden

站点绑定的证书与私钥不匹配,或证书未装入“个人”存储,或 pfx 导入时未勾选“密钥可导出”。在 IIS 绑定窗口重新选择证书,或 certlm.msc 中确认证书图标带钥匙标记。

7. 浏览器控制台 Mixed Content 警告

报错形如 The page at 'https://a.com/' was loaded over HTTPS, but requested an insecure XMLHttpRequest endpoint 'http://a.com/api'。把页面内所有 http:// 资源改为相对协议 // 或 https,并加响应头 Content-Security-Policy: upgrade-insecure-requests。

8. NET::ERR_CERT_DATE_INVALID

证书已过期或服务器系统时间错误。先 date -u 核对时间,再 openssl x509 -in fullchain.pem -noout -dates 核对有效期。

八、效果验证:命令、SSL Labs 与小程序真机

部署完成后不要只看浏览器绿锁,按下面四层依次验证。

第一层,协议与状态码。

curl -I https://example.com
curl -I http://example.com          # 应返回 301 且 Location 指向 https
curl -vI https://example.com 2>&1 | grep -E "SSL connection|subject|expire"

第二层,证书链完整性。这是决定小程序能否握手的关键:

echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null 
  | openssl x509 -noout -subject -issuer -dates
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null

输出中 Verify return code 必须为 0 (ok);-showcerts 应至少返回两张证书(站点证书 + 中间证书)。只有一张说明链不完整。

第三层,到期监控脚本。证书有效期已缩短到 398 天甚至更短,人工记忆必然出事,建议所有站点上监控:

#!/bin/bash
DOMAIN=example.com
END=$(echo | openssl s_client -connect $DOMAIN:443 -servername $DOMAIN 2>/dev/null 
  | openssl x509 -noout -enddate | cut -d= -f2)
DAYS=$(( ($(date -d "$END" +%s) - $(date +%s)) / 86400 ))
echo "$DOMAIN 剩余 $DAYS 天"
[ $DAYS -lt 15 ] && echo "$DOMAIN 证书将在 $DAYS 天后到期" | mail -s "SSL 到期告警" admin@example.com

把脚本加入 crontab 每天执行一次即可。

第四层,评级与真机。用 SSL Labs(ssllabs.com/ssltest)跑一次完整评估,目标 A 及以上;出现 “Chain issues: Incomplete” 说明中间证书仍缺失。小程序侧分两步:开发者工具中“详情 → 本地设置 → 不校验合法域名”只能用于调试,真机预览必须走真实校验;同时在公众平台“开发管理 → 开发设置 → 服务器域名”里把 https://api.example.com 加入 request 合法域名,注意该项有修改次数限制,别频繁改动。

最后提醒 HSTS:首次上线不要直接设 max-age=31536000 并提交 preload,建议先设 max-age=300 观察一周,确认全站子域都已支持 HTTPS 后再逐步加长,否则回退极其麻烦。

常见问题

免费证书能用于微信小程序生产环境吗?

可以。小程序只校验证书是否由受信任 CA 签发、域名是否匹配、TLS 是否 ≥1.2,并不区分免费或付费。Let’s Encrypt、ZeroSSL 的 DV 证书完全满足要求,前提是必须做好自动续期——它们只有 90 天有效期,一旦续期失败,小程序会立刻大面积报 request:fail ssl handshake failed。付费证书的优势在于 398 天有效期、商业保险和人工支持。

证书有效期到底是多少天?为什么买不到“一年期”了?

2020-09-01 起 CA/B Forum 规定公开信任证书单张最长 398 天,主流浏览器会拒绝超期证书,因此所有 CA 都改成了 398 天(约 13 个月)。Let’s Encrypt 固定 90 天。行业已确定进一步缩短:2026-03-15 起 200 天、2027-03-15 起 100 天、2029-03-15 起 47 天。无论买哪种证书,都必须部署自动续期与到期监控。

一张证书能同时保护主域名、www 和多个子域名吗?

可以,但要选对类型。多域名证书(SAN)可在一张证书里写入多个 FQDN,例如 example.com、www.example.com、api.example.com。通配符证书 *.example.com 覆盖任意一级子域,但不包含裸域 example.com,也不覆盖 a.b.example.com 这类二级子域,需要额外添加 SAN。

为什么浏览器显示安全,小程序却握手失败?

最常见原因是证书链不完整。桌面浏览器支持 AIA 自动抓取中间证书,所以看起来正常;而小程序、部分安卓机和 iOS 不做自动补链,缺中间证书就直接失败。用 openssl s_client -showcerts 检查是否返回两张以上证书,并把 cat 站点证书 中间证书 > fullchain.pem 后重新加载即可。其次是服务器只开了 TLS 1.0/1.1 或只保留 CBC 套件。

更换证书后需要重启服务器吗?

Nginx 不需要重启,先 nginx -t 校验语法,再 nginx -s reload 平滑加载即可,业务不中断;Apache 用 apachectl -k graceful;IIS 重新绑定证书或重启对应站点即可,不必执行 iisreset 重启整机。切记不要跳过语法检查直接重启,一个配置错误就会导致全站不可用。

私钥泄露了怎么办?

立即吊销并重签:在 CA 控制台提交吊销(走 OCSP/CRL),重新生成一对新密钥和新 CSR 签发证书,然后全量替换服务器配置并 reload。不要复用旧私钥。同时排查泄露路径,常见原因是私钥文件权限过宽(应 chmod 600)、误传到代码仓库或备份目录被公开访问。

内容审核

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