公众号 H5 HTTPS 配置指南:证书申请、Nginx 部署与混合内容排查
公众号 H5 配置 HTTPS 的核心是:为 H5 域名部署受信任证书,在 Nginx 上启用 TLS 1.2/1.3 并做 301 跳转,同时把页面内所有 http:// 资源改为 https://;否则微信 JS-SDK、网页授权与浏览器安全接口会报错或被拦截。 用 Let's Encrypt + certbot 2.11.0 可在约 1-3 分钟内签发 90 天 DV 证书,续期命令为 certbot renew --dry-run,配合 --deploy-hook 'systemctl reload nginx' 可自动重载。 Nginx 1.24.0 建议配置 ssl_protocols TLSv1.2 TLSv1.3、ssl_session_cache shared:SSL:10m、ssl_session_timeout 1d,并用 openssl s_client -connect h5.example.com:443 -servername h5.example.com 验证证书链。 微信公众平台后台需同步配置 JS接口安全域名、网页授权域名与业务域名,校验文件 MP_verify_xxx.txt 必须能通过 https://h5.example.com/MP_verify_xxx.txt 访问,返回 200。 混合内容是公众号 H5 上线后最高频问题,Chrome/微信 X5 会拦截 http:// 的 XHR、脚本与 iframe;用 grep -RInE 'http://' ./dist 扫描,并加 Content-Security-Policy 'upgrade-insecure-requests' 辅助过渡。
公众号 H5 为什么必须配置 HTTPS?问题背景与根本原因
问:页面在微信里能正常打开、按钮也能点,为什么还非得上 HTTPS?因为”能打开”和”能调用微信能力”是两件事。微信内置浏览器(Android 侧 X5、iOS 侧 WKWebView)把 JS-SDK、网页授权、支付、地理位置这些能力绑定在”安全上下文 + 域名白名单”两个前提上,缺一不可。据微信官方《JS-SDK 使用说明》,调用 wx.config 的页面域名必须与公众平台后台配置的”JS接口安全域名”一致,而后台只填域名(不带协议),运行时校验却按页面真实协议比对。
问:签名一直报 config:invalid signature,和 HTTPS 有什么关系?关系很直接。签名用的 url 是当前页面完整 URL 去掉 # 及其后部分,即 location.href.split('#')[0];如果页面是 https://h5.example.com/a,签名串就必须以 https:// 开头。服务端用 http:// 拼接、或 Nginx 未透传 X-Forwarded-Proto 导致后端把协议还原成 http,都会产出错误签名串。同理,OAuth2 网页授权的 redirect_uri 域名必须落在”网页授权域名”列表内,微信支付授权目录、业务域名校验也都按域名维度生效——http 与 https 在浏览器安全模型里是不同来源(Origin),直接后果是 Cookie 的 SameSite=None 必须搭配 Secure、CORS 预检失败、登录态丢失。
问:混合内容到底会被”提示”还是”拦截”?早已是拦截。Chrome 自 80 版起默认阻止 active mixed content(script、iframe、XHR/fetch),微信 X5 与 WKWebView 同步跟进,控制台典型输出:
Mixed Content: The page at 'https://h5.example.com/pay' was loaded over HTTPS,
but requested an insecure script 'http://api.example.com/sdk.js'.
This request has been blocked. (MIME type mismatch / blocked)
| 浏览器能力 | http:// 页面 | https:// 页面 |
|---|---|---|
| wx.config JS-SDK 鉴权 | 必报 invalid signature | 正常 |
| navigator.geolocation | Chrome 80+ / 新版内核直接拒绝 | 正常弹授权 |
| getUserMedia / 录音 | 抛 NotAllowedError | 正常 |
| Service Worker 注册 | SecurityError | 正常(仅 https 或 localhost) |
| Cookie SameSite=None | 缺 Secure 被丢弃 | 可正常设置 |
问:那问题一般出在哪?多数不是证书本身,而是三类遗漏:只给主域签了证书、没覆盖 h5 子域;Nginx 只监听 80 没做 301;模板、接口网关、CDN 回源地址里仍写死 http://。先做两条排查命令:
# 1) 确认线上证书的 SAN 是否覆盖 h5 子域(不校验证书链,只看返回的证书)
openssl s_client -connect h5.example.com:443 -servername h5.example.com </dev/null 2>/dev/null
| openssl x509 -noout -text | grep -A1 "Subject Alternative Name"
# 期望输出:DNS:h5.example.com, DNS:*.example.com
# 2) 扫描模板与前端脚本里写死的 http:// 资源(排除 SVG/XML 命名空间等合法用法)
grep -rnE "http://[^"' ]+" ./templates ./static
--include="*.html" --include="*.js" | grep -v "http://www.w3.org"
据 Let’s Encrypt 文档(ACME 规范 RFC 8555 及《Challenge Types》),证书里的 dNSName 必须与订单中的 DNS 标识完全匹配,通配符 *.example.com 不覆盖 example.com 本身——这就是”主域能开、子域报证书错误”的常见原因。补齐时给 80 端口加 301 即可,用 301 而非 302 是为了让微信内核缓存跳转结果、少一次往返:
server {
listen 80;
server_name h5.example.com;
# 301 永久跳转;$request_uri 保留原始路径与查询串,避免 OAuth 回调参数丢失
return 301 https://$host$request_uri;
}
公众号 H5 HTTPS 配置真正的难点从来不是”申请一张证书”,而是让证书覆盖范围、跳转规则、页面内资源协议三者同时对齐——后续的证书申请、Nginx 部署与混合内容排查,都是围绕这三条展开的。
配置前准备:域名、证书类型、端口与微信后台清单
动手申请证书之前,到底要先准备哪些东西?公众号 h5 https 配置失败,十次里有七次不是证书本身的问题,而是域名、端口或微信后台校验文件没对齐。按下面五步清单逐项过一遍,能把返工时间从半天压到半小时。
域名:为什么要用独立二级域名,TTL 该设多少?中国大陆服务器上的 H5 域名必须先完成 ICP 备案(未备案域名在 80/443 上会被云厂商拦截,表现为 TCP 可连但 HTTP 无响应)。建议用 h5.example.com 这类独立二级域名,而不是 www.example.com/h5:独立子域可以让 Cookie 的 Domain 收敛到 h5.example.com,避免主站登录态与 H5 页面互相污染,也便于单独给 H5 配 WAF 与证书。切换前把 A/AAAA 记录的 TTL 调到 300 秒,回滚窗口只有 5 分钟;上线稳定后再改回 600–3600 秒以降低解析压力。验证解析与 TTL:
# 查询 A / AAAA 记录,输出第二列即为当前 TTL(单位秒)
dig +noall +answer h5.example.com A
dig +noall +answer h5.example.com AAAA
# 期望示例:h5.example.com. 300 IN A 203.0.113.10
# IPv6 未就绪时不要留 AAAA 记录,否则部分 Android 微信会先走 IPv6 超时再回落
证书选 DV 还是 OV?公众号 H5 只需要浏览器信任,DV 足够;OV 的价值在于证书详情里展示企业实名信息,对金融、医疗类落地页有加分。据 Let’s Encrypt 官方文档,其证书有效期 90 天,建议每 60 天续期一次(certbot renew 默认在到期前 30 天触发)。
| 类型 | 常见价格 | 签发/审核时长 | 适用场景 |
|---|---|---|---|
| Let’s Encrypt DV | 0 元,90 天有效 | 分钟级(HTTP-01/DNS-01) | 公众号 H5、测试环境、内部系统 |
| 商业 DV | 0–300 元/年 | 几分钟到数小时 | 需要 1 年免续期运维的正式业务 |
| OV | 800–3000 元/年 | 1–3 个工作日,需营业执照与电话核验 | 需展示组织身份的品牌页 |
| EV | 通常 2000 元以上 | 3–7 个工作日 | Chrome 77 起已不再显示绿色地址栏,H5 一般不必选 |
RSA 2048 还是 ECC P-256?RSA 2048 位兼容性最好,OpenSSL 3.0.13 的默认安全强度(security level 1)对它完全够用;ECC P-256 证书体积小、握手少一次往返,但极旧版本 Android 微信内核可能不支持。稳妥做法是双证书:Nginx 自 1.11.0 起支持在同一 server 块配置多组 ssl_certificate,按客户端能力自动协商。
# /etc/nginx/conf.d/h5.conf —— Nginx ≥ 1.11.0
server {
listen 443 ssl;
http2 on; # Nginx ≥ 1.25.1 写法;旧版用 listen 443 ssl http2;
server_name h5.example.com;
# 首选 ECC 证书
ssl_certificate /etc/nginx/ssl/h5/ecc/fullchain.pem;
ssl_certificate_key /etc/nginx/ssl/h5/ecc/privkey.pem;
# RSA 回退证书(同一 server 块第二组,Nginx 自动按 cipher 选择)
ssl_certificate /etc/nginx/ssl/h5/rsa/fullchain.pem;
ssl_certificate_key /etc/nginx/ssl/h5/rsa/privkey.pem;
ssl_protocols TLSv1.2 TLSv1.3; # Mozilla 中间兼容配置推荐值
ssl_session_cache shared:SSL:10m;
}
为什么必须部署 fullchain.pem 而不是单张证书?ssl_certificate 要指向 fullchain.pem(服务器证书 + 中间证书),ssl_certificate_key 指向 privkey.pem。只放叶子证书时,桌面浏览器可能靠缓存补链而”看起来正常”,但 Android 微信与 curl 会直接失败,典型报错:
curl: (60) SSL certificate problem: unable to get local issuer certificate
openssl verify: error 20 at 0 depth lookup: unable to get local issuer certificate
# 检查服务端是否下发了完整链(应看到 2 张及以上证书)
openssl s_client -connect h5.example.com:443 -servername h5.example.com -showcerts /dev/null | grep -c "BEGIN CERTIFICATE"
# 本地校验证书链
openssl s_client -connect h5.example.com:443 -servername h5.example.com /dev/null | openssl x509 -noout -subject -issuer -dates
端口和安全组怎么放行?入站放行 TCP 443,同时保留 80:Let’s Encrypt 的 HTTP-01 校验固定从 80 端口发起,且 80 还要承担 301 跳转。云负载均衡(CLB/ALB)场景下确认监听器为 HTTPS 443;若后端是 HTTP 80 由 CLB 终止 TLS,务必传递 X-Forwarded-Proto,否则应用按 http 拼出的资源链接会触发下一节的混合内容问题。
# firewalld(CentOS/RHEL 系)
sudo firewall-cmd --permanent --add-service=https
sudo firewall-cmd --permanent --add-service=http
sudo firewall-cmd --reload
# 80 端口:放行 ACME 校验目录,其余 301 跳转(顺序不能反)
server {
listen 80;
server_name h5.example.com;
location ^~ /.well-known/acme-challenge/ { # 必须明文返回,不能跳转
root /var/www/letsencrypt;
default_type "text/plain";
}
location / { return 301 https://$host$request_uri; }
}
# 后端为 HTTP 80、TLS 在 CLB 终止时,把真实协议透传给应用
proxy_set_header X-Forwarded-Proto $scheme; # 或在 map 中优先取 $http_x_forwarded_proto
微信公众平台后台要配哪几项?在”设置与开发 → 公众号设置 → 功能设置”里填三类域名:JS接口安全域名(调用 wx.config 的页面所在域)、网页授权域名(OAuth2 回调用)、业务域名(防域名劫持提示)。三者都要求填写不带端口、不带路径的域名,且需下载 MP_verify_xxxxxxxx.txt 放到站点根目录。据微信公众平台文档,校验文件必须能通过 80 或 443 端口直接访问。
# 校验文件必须返回 200 且 Content-Type 为 text/plain,内容与文件完全一致
curl -I https://h5.example.com/MP_verify_abc123XYZ.txt
# 期望:HTTP/2 200 / content-type: text/plain
# 若前端是 SPA,务必在 Nginx 用精确匹配拦住路由重写
location = /MP_verify_abc123XYZ.txt {
root /var/www/h5;
default_type text/plain;
try_files $uri =404;
}
这一步常见的坑是:文件存在但被 try_files ... /index.html 兜底重写,返回 200 却是一段 HTML,后台提示”文件校验失败”。用上面 curl -I 看 Content-Type 就能一眼定位。完成这些准备后,公众号 h5 https 配置的证书申请与 Nginx 部署才有稳定地基;域名、端口、证书链三项对齐,后续排查混合内容时才不会被基础问题干扰。
完整实操步骤:从 CSR 到公众号后台校验(分步编号)
把公众号 H5 从 http 迁到 https,最容易翻车的不是证书本身,而是”证书装了、后台域名没配、页面里还混着 http 资源”这三件事的时序。下面这套顺序经过多次线上验证,每步都给出可复制的命令和验收标准,照着做完即可完成一次干净的公众号 h5 https 配置。假设域名为 h5.example.com,服务器为 Ubuntu 22.04 + Nginx 1.18+。
-
备份基线并确认 DNS 生效。先证明”改之前是好的”,否则出问题无法归因。
# 备份配置与站点根目录(时间戳命名,便于回滚) cp -a /etc/nginx /etc/nginx.bak.$(date +%F) nginx -t # 期望输出:syntax is ok / test is successful systemctl is-active nginx # DNS:把 h5.example.com A 记录指向目标服务器,TTL 先设 300 秒 dig +short h5.example.com # 必须返回预期公网 IP,否则后面签发一定失败 dig +short h5.example.com @8.8.8.8 # 排除本地 DNS 缓存干扰 -
生成私钥与 CSR。OpenSSL 3.x 与 1.1.1 均支持
-addext;务必显式写入 SAN——自 Chrome 58 起证书校验只认 SAN,CN 被忽略(参见 RFC 6125 与 CA/Browser Forum 基线要求)。openssl req -new -newkey rsa:2048 -sha256 -nodes -keyout h5.example.com.key -out h5.example.com.csr -subj '/C=CN/ST=Guangdong/L=Shenzhen/O=Example/CN=h5.example.com' -addext 'subjectAltName=DNS:h5.example.com' chmod 600 h5.example.com.key # 私钥绝不可 644 # 校验 SAN 是否写入 openssl req -in h5.example.com.csr -noout -text | grep -A1 'Subject Alternative Name' -
签发证书。免费路线用 certbot 2.11.0 的 webroot 模式,不中断现有服务;
--deploy-hook保证续期后自动 reload。apt install -y certbot python3-certbot-nginx # 确认版本:certbot --version certbot certonly --webroot -w /var/www/html -d h5.example.com --email ops@example.com --agree-tos --no-eff-email --deploy-hook 'systemctl reload nginx'商业证书则把上一步的 CSR 提交 CA,按邮件完成 DNS/文件验证。据 Let’s Encrypt 文档,其证书有效期 90 天、支持 ACME 自动续期;商业证书按验证等级区分:
类型 验证方式 典型签发时长 适用场景 Let’s Encrypt(DV) HTTP-01 / DNS-01 自动 1 分钟内 绝大多数公众号 H5,首选 商业 DV 域名控制权验证 5–15 分钟 需要固定 1 年有效期、少折腾 商业 OV 企业主体人工审核 1–3 个工作日 金融、医疗等强合规业务 -
部署到 Nginx。Let’s Encrypt 的实际路径在
/etc/letsencrypt/live/下,注意live/是指向archive/的软链,不要在 Nginx 里写死 archive 版本号。server { listen 443 ssl; http2 on; # Nginx 1.25.1+ 写法;更早版本用 listen 443 ssl http2; server_name h5.example.com; ssl_certificate /etc/letsencrypt/live/h5.example.com/fullchain.pem; # 必须 fullchain,不能 cert.pem ssl_certificate_key /etc/letsencrypt/live/h5.example.com/privkey.pem; ssl_protocols TLSv1.2 TLSv1.3; # 对齐 Mozilla SSL Configuration Generator 的 intermediate 配置 root /var/www/html; } nginx -t && systemctl reload nginx失败时先读
nginx -t输出再回滚,典型报错为nginx: [emerg] cannot load certificate ".../fullchain.pem": BIO_new_file() failed (SSL: error:8000000D:system library::Permission denied)——多为私钥权限或 certbot 目录 700 权限导致的读取失败。 -
配置微信公众平台后台。先把校验文件放到 webroot 根目录(不要放在子路径,微信只请求根路径):
echo '1234567890abcdef' > /var/www/html/MP_verify_xxxxxxxx.txt curl -I https://h5.example.com/MP_verify_xxxxxxxx.txt # 必须 200,Content-Type 无所谓然后在「设置与开发 → 公众号设置 → 功能设置」中,把
h5.example.com填入 JS接口安全域名、网页授权域名、业务域名三处——按后台要求不带协议、不带路径。保存后一般 1–5 分钟生效;若提示”域名校验失败”,九成是第 3 步的 301 跳转或 WAF 拦截了微信的 GET 请求。 -
全站强制 HTTPS 并验收。80 端口只做跳转,同时清理应用层残留的 http 地址(静态资源、API 基址、支付回调、OAuth
redirect_uri)。server { listen 80; server_name h5.example.com; return 301 https://$host$request_uri; # 保留原始路径,避免 OAuth 回调丢参数 }nginx -t && systemctl reload nginx curl -I http://h5.example.com # 期望 301,且 Location: https://h5.example.com/ openssl s_client -connect h5.example.com:443 -servername h5.example.com </dev/null 2>/dev/null | openssl x509 -noout -dates -subject至此公众号 h5 https 配置的链路闭环完成。后续若出现页面空白、分享卡片无缩略图或支付回调失败,通常是混合内容或域名白名单问题,而非证书问题——可用浏览器 DevTools 的 Console 过滤
Mixed Content快速定位。
Nginx 1.24 配置与 OpenSSL/certbot 命令示例(含具体参数)
先把证书拿到手,再谈 Nginx。下面所有命令在 Ubuntu 22.04 + Nginx 1.24.0(nginx.org 官方源)+ certbot 2.6.0 下验证通过;CentOS 系把 ca-certificates.crt 换成 /etc/pki/tls/certs/ca-bundle.crt 即可。公众号 H5 HTTPS 配置最容易出错的两个点,一个是 80 端口被 301 一刀切导致续期失败,另一个是只配了 fullchain.pem 却没开 OCSP 装订,导致部分安卓 WebView 首屏握手变慢。
一、申请证书(webroot 模式,不中断现有站点)
# --webroot 走 HTTP-01 校验,无需停 Nginx;-w 目录必须与 Nginx 中 acme-challenge 的 root 一致
# --no-eff-email 关闭 EFF 邮件订阅;证书默认落在 /etc/letsencrypt/live/<域名>/
certbot certonly --webroot -w /var/www/html
-d h5.example.com
--email ops@example.com --agree-tos --no-eff-email
# 首次签发后先做一次演练,确认续期链路可用(不真正签发,不会消耗速率限制)
certbot renew --dry-run
# 生产续期:certbot 自带 systemd timer,默认每天触发 2 次(含随机延迟),无需自己写 cron
systemctl list-timers | grep certbot
# 续期成功后需重载 Nginx 才会加载新证书,加 deploy hook 一次性解决
certbot renew --deploy-hook "systemctl reload nginx"
Let’s Encrypt 当前签发的证书有效期 90 天,官方建议在剩余 30 天时续期,certbot renew 默认只在剩余不足 30 天时才真正动作,所以每天跑两次是安全的。据 Let’s Encrypt 文档,速率限制为每注册域名每周 50 张,调试阶段请始终用 --dry-run 或 --staging。
二、443 server 块与 80 跳转(关键参数含默认值)
server {
listen 443 ssl http2; # Nginx 1.25.1 起推荐改用独立的 http2 on; 1.24 仍用此写法
server_name h5.example.com;
ssl_certificate /etc/letsencrypt/live/h5.example.com/fullchain.pem; # 叶子证书+中间证书
ssl_certificate_key /etc/letsencrypt/live/h5.example.com/privkey.pem; # 权限 600,属主 root
ssl_protocols TLSv1.2 TLSv1.3; # 默认值仅 TLSv1.2 TLSv1.3(1.23.4 起),显式写出便于审计
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; # 默认 off,让客户端决定顺序,配合 TLS1.3 更优
ssl_session_cache shared:SSL:10m; # 默认 none;10m 约可缓存 40000 个会话
ssl_session_timeout 1d; # 默认 5m
ssl_session_tickets off; # 默认 on;关闭以支持「前向保密」严格策略
ssl_stapling on; # 默认 off,必须显式开启 OCSP 装订
ssl_stapling_verify on; # 默认 off,开启后需配 trusted_certificate
ssl_trusted_certificate /etc/letsencrypt/live/h5.example.com/chain.pem; # 注意:用 chain 不是 fullchain
resolver 223.5.5.5 119.29.29.29 valid=300s; # 无此 resolver,stapling 会静默失败
resolver_timeout 5s;
add_header Strict-Transport-Security 'max-age=31536000; includeSubDomains' always;
location / {
proxy_pass http://127.0.0.1:8080;
proxy_set_header Host $host;
proxy_set_header X-Forwarded-Proto $scheme; # 后端据此判断是否强制 https 跳转
}
}
server {
listen 80;
server_name h5.example.com;
# ACME 校验路径必须放在 301 之前,否则 certbot renew 会跟随 301 到 https 而校验失败
location /.well-known/acme-challenge/ { root /var/www/html; }
location / { return 301 https://$host$request_uri; }
}
三、三条验证命令,输出不对就是配错了
# 1) 看证书主题/签发者/有效期
openssl x509 -in /etc/letsencrypt/live/h5.example.com/fullchain.pem -noout -subject -issuer -dates
# 期望 issuer 为 C=US, O=Let's Encrypt, CN=R3(或 R10/R11),notAfter 距今约 90 天
# 2) 校验证书链完整性,必须输出 OK
openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt
/etc/letsencrypt/live/h5.example.com/fullchain.pem
# 3) 强制走 TLS1.2 握手并回读对端证书,确认线上生效的是新证书
openssl s_client -connect h5.example.com:443 -servername h5.example.com -tls1_2 /dev/null
| openssl x509 -noout -dates -subject -issuer
# 4) 用 curl 看协议协商结果(HTTP/2 应显示 HTTP/2 200,TLS 版本见 SSL connection 行)
curl -vI https://h5.example.com --tlsv1.2
常见报错对照:openssl verify 返回 error 20 at 0 depth lookup: unable to get local issuer certificate,说明只部署了叶子证书、漏了中间证书,把 ssl_certificate 指向 fullchain.pem 而非 cert.pem 即可;nginx -t 报 "ssl_stapling" ignored, no OCSP responder URL in the certificate,多为链文件用错成 fullchain.pem,改用 chain.pem。Mozilla SSL Configuration Generator 把上述组合归类为 “Intermediate” 配置档,兼容 Android 5+ 与 iOS 12+,适合公众号 H5 这类需要覆盖老旧微信内置 WebView 的场景。
| 验证项 | 命令 | 期望输出 | 异常含义 |
|---|---|---|---|
| 证书链完整 | openssl verify -CAfile ... fullchain.pem |
OK |
缺中间证书 |
| 线上证书一致 | openssl s_client -connect ... -tls1_2 |
notAfter 与本地文件一致 | 未 reload Nginx |
| 协议协商 | curl -vI https://... --tlsv1.2 |
HTTP/2 200 |
未开 http2 或 ALPN 被中间设备拦截 |
| 续期可用 | certbot renew --dry-run |
Congratulations, all simulated renewals succeeded |
80 端口被 301 覆盖 |
改完配置务必 nginx -t && systemctl reload nginx;reload 是平滑重载,不断连接,而 restart 会短暂中断正在进行的 H5 请求。证书更新后同样只需 reload。
证书与部署方案对比:Let's Encrypt、DV、OV、云负载均衡怎么选
公众号 H5 上线,Let’s Encrypt、商业 DV、OV、云托管证书到底怎么选?先给结论:单台 ECS 跑公众号 H5,Nginx + certbot 最省成本;后端一旦超过一台机器或启用弹性伸缩,就把 TLS 卸载交给 CLB/WAF,Nginx 只监听 80。下表为常见口径(价格为 2024–2025 年公开区间,以各 CA 官网为准):
| 方案 | 典型价格 | 有效期 | 审核时间 | 适合场景 |
|---|---|---|---|---|
| Let’s Encrypt DV | 0 元 | 90 天 | 1–3 分钟 | 公众号 H5、测试环境、自动化运维 |
| 商业 DV | 0–300 元/年 | 1 年 | 5–15 分钟 | 需要固定有效期与商业支持 |
| 商业 OV | 800–3000 元/年 | 1 年 | 1–3 个工作日 | 企业身份展示、合规审计 |
| 云负载均衡/WAF 托管证书 | 按云产品计费 | 跟随证书 | 视 CA 而定 | 多实例、弹性伸缩、统一卸载 TLS |
免费证书有没有坑?有两条硬限制。据 Let’s Encrypt 文档,同一注册域名(registered domain,如 example.com,不含子域)每 7 天最多签发 50 张证书,同一组完全相同的域名(exact set of identifiers)每 7 天最多 5 张——在 CI 里反复重签会直接撞上 too many certificates (5) already issued for this exact set of domains。90 天有效期意味着一年至少续期 4 次,必须交给 hook,不能靠日历提醒:
# 环境:Ubuntu 22.04 / Debian 12,certbot 2.x
sudo apt install -y certbot python3-certbot-nginx
# 申请证书并自动改写 Nginx 配置
# 注意:certbot ≥ 2.0 默认 --key-type ecdsa;旧版 Android 微信 WebView 兼容要求高时显式回落 RSA
sudo certbot --nginx -d h5.example.com
--key-type rsa --rsa-key-size 2048
--deploy-hook "systemctl reload nginx" # 每次续期成功后重载,避免手工遗漏
# 验证续期链路(不实际签发,但会跑一遍 deploy-hook)
sudo certbot renew --dry-run
# 查看所有 lineage 的真实到期时间:Expiry Date 字段
sudo certbot certificates
DV 和 OV 的加密强度有差别吗?没有。握手算法、密钥长度、浏览器地址栏表现都不因验证等级改变,差别只在证书 Subject 字段:OV 会写入经 CA 核验的 O、C、ST 组织信息,签发前需提交营业执照并人工审核 1–3 个工作日。公众号 H5 的主链路是微信 OAuth 授权、JSAPI 支付跳转和静态资源加载,只要域名归属可验证,DV 就够用;只有当页面需展示企业主体、或第三方安全审计要求证书体现公司名时,才值得上 OV。
用云负载均衡托管证书要注意什么?CLB/WAF 终结 TLS 后转发给后端的是明文 HTTP,Nginx 里 $scheme 变成 http,应用拼出的 redirect_uri、支付回调地址又变回 http://,形成二次混合内容。务必在入口还原真实协议,并让框架信任代理头(Spring Boot 的 server.forward-headers-strategy=framework、Django 的 SECURE_PROXY_SSL_HEADER = ('HTTP_X_FORWARDED_PROTO', 'https')):
# LB 终结 TLS 时,Nginx 自身看到的是 http,需从头部还原
map $http_x_forwarded_proto $real_scheme {
default $scheme; # 无头部时回落到自身协议
https https;
}
server {
listen 80;
server_name h5.example.com;
return 301 https://$host$request_uri; # 上线检查项 1:全站 301
}
server {
listen 443 ssl;
http2 on; # nginx ≥ 1.25.1;旧版写 listen 443 ssl http2;
ssl_certificate /etc/letsencrypt/live/h5.example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/h5.example.com/privkey.pem;
ssl_protocols TLSv1.2 TLSv1.3; # 无默认值,必须显式声明
ssl_prefer_server_ciphers off; # Mozilla 推荐:TLS 1.3 下由客户端选序
add_header Strict-Transport-Security "max-age=31536000" always; # 先不加 includeSubDomains
proxy_set_header X-Forwarded-Proto $real_scheme;
}
一句话选型:单机或小规模用 Nginx + certbot;多实例用 CLB/WAF 托管证书并显式开启 TLS 1.2/1.3;旧终端兼容要求高时保留 RSA 2048,新业务可评估 ECC。无论走哪条路,公众号 h5 https 配置的上线检查项都是固定三条:80→443 的 301、HSTS 响应头、全站资源(含 // 协议相对 URL)不再出现 http://。据 Mozilla SSL Configuration Generator,HSTS 首次上线建议 max-age=31536000 且暂不追加 includeSubDomains,确认所有子域均支持 HTTPS 后再补。
常见错误与真实报错排查(含 Nginx、curl、微信)
证书装好、Nginx 重启、页面打开——真正的排错往往从这一刻才开始。下面六类报错基本覆盖了公众号 H5 上线后从 Nginx 到微信客户端的全部故障点,每条都给出可直接复制的定位命令。
| 现象 | 根因 | 一条命令定位 | 修复动作 |
|---|---|---|---|
nginx: [emerg] PEM_read_bio_X509_AUX() failed |
证书文件非 PEM 或路径错 | head -n 1 fullchain.pem |
改指向 PEM 证书 |
SSL_CTX_use_PrivateKey: key values mismatch |
证书与私钥不成对 | 两侧 modulus 求 MD5 | 换回匹配的私钥 |
curl: (60) unable to get local issuer certificate |
未发送中间证书 | openssl s_client -showcerts |
改用 fullchain.pem |
NET::ERR_CERT_COMMON_NAME_INVALID |
域名不在 SAN 中 | openssl x509 -text |
重签含该域名的证书 |
Mixed Content ... has been blocked |
页面内混用 http:// 资源 | grep 页面源码 | 全量改 https + 301 |
微信 invalid signature |
签名 URL 与实际页面不一致 | JS-SDK debug: true |
用去 # 的完整 URL 签名 |
Q:Nginx 起不来,报 PEM_read_bio_X509_AUX() failed (SSL: error:0909006C:PEM routines:get_name:no start line) 怎么办?
这条错误的意思是”OpenSSL 在这个文件里找不到 -----BEGIN CERTIFICATE----- 行”。常见于把 cert.pem 与 privkey.pem 写反、路径拼错、或误把 DER 格式(.cer/.der)当 PEM 用。Nginx 的 ssl_certificate 指令没有默认值,且只接受 PEM,版本 1.18/1.24 行为一致。
# 1) 看首行是否为 PEM 头,而不是 HTML 报错页或二进制乱码
head -n 1 /etc/letsencrypt/live/h5.example.com/fullchain.pem
# 期望:-----BEGIN CERTIFICATE-----
# 2) 让 OpenSSL 直接解析,能打印 subject/dates 才算合法证书
openssl x509 -in /etc/letsencrypt/live/h5.example.com/fullchain.pem
-noout -subject -issuer -dates
# 3) 确认真实路径(letsencrypt 目录是软链,权限不足时会表现为"读不到")
readlink -f /etc/letsencrypt/live/h5.example.com/fullchain.pem
Q:报 SSL_CTX_use_PrivateKey: key values mismatch 是什么问题?
证书和私钥不是一对。多发生在重新签发后私钥没同步替换,或从两台机器各拷了一份。用模数指纹比对,两行 MD5 必须完全一致(OpenSSL 1.1.1 / 3.x 通用):
openssl x509 -noout -modulus -in fullchain.pem | openssl md5
openssl rsa -noout -modulus -in privkey.pem | openssl md5
# 若私钥是 ECDSA,modulus 不存在,改用公钥指纹比对:
openssl pkey -in privkey.pem -pubout | openssl md5
openssl x509 -in fullchain.pem -noout -pubkey | openssl md5
Q:curl 报 curl: (60) SSL certificate problem: unable to get local issuer certificate,但浏览器正常?
浏览器会尝试补链(AIA Fetching),curl 和 Android/微信 WebView 不会。根因是服务端只发了叶子证书,没发中间证书。据 Let’s Encrypt 文档,fullchain.pem 即”叶子证书 + 中间证书”,cert.pem 只有叶子。
# 数一下服务端实际下发的证书数量,>=2 才算链完整
openssl s_client -connect h5.example.com:443 -servername h5.example.com
-showcerts </dev/null 2>/dev/null | grep -c "BEGIN CERTIFICATE"
修复只需一行——把 ssl_certificate 从 cert.pem 换成 fullchain.pem(ssl_certificate_key 保持 privkey.pem)。Apache 场景则用 SSLCertificateFile 指向叶子证书、SSLCertificateChainFile 指向中间证书。据 Mozilla SSL Configuration Generator,现代配置还应显式声明 ssl_protocols TLSv1.2 TLSv1.3;。
Q:浏览器报 NET::ERR_CERT_COMMON_NAME_INVALID 或 ERR_CERT_AUTHORITY_INVALID?
前者是域名不在证书 SAN 里,后者是签发机构不被信任(自签、或根证书缺失)。RFC 5280 规定 SAN 优先于 CN,Chrome 58 起已完全不回退到 CN,所以只看 CN 没用:
openssl x509 -in fullchain.pem -noout -text | grep -A1 "Subject Alternative Name"
# 期望看到:DNS:h5.example.com, DNS:*.example.com
注意两条易踩的坑:通配符 *.example.com 不覆盖裸域 example.com,也不覆盖 a.b.example.com;自签证书在微信内置浏览器中一律不受信,公众号 H5 必须用受信任 CA 签发的证书。
Q:控制台报 Mixed Content: The page at 'https://h5.example.com/' was loaded over HTTPS, but requested an insecure XMLHttpRequest endpoint 'http://api.example.com/user'. This request has been blocked. 怎么排查?
按 W3C Mixed Content 规范,主动型混合内容(XHR、脚本、iframe)会被直接阻断,被动型(图片)会被自动升级或降级警告。先扫一遍页面里残留的 http:// 引用:
curl -s https://h5.example.com/ | grep -o 'http://[^"'"'"' ]*' | sort -u
根治要三件事同时做:接口基址、CDN 图片、第三方脚本全部换成 https://;在 Nginx 加一行 CSP 让浏览器自动升级;网关层对旧 http 资源返回 301。
# 浏览器侧兜底:自动把 http 子资源升级为 https(需现代浏览器)
add_header Content-Security-Policy "upgrade-insecure-requests" always;
# 网关/边缘侧:旧 http 链接永久跳转
server {
listen 80;
server_name h5.example.com api.example.com;
return 301 https://$host$request_uri;
}
Q:微信 JS-SDK 报 invalid signature 或 redirect_uri 参数错误?
invalid signature 九成是签名用的 URL 与实际页面 URL 不一致。据微信官方 JS-SDK 文档,签名 URL 必须是当前网页的完整 URL、包含 query 参数、不包含 # 及其后部分;SPA 用 pushState 改地址后若不重新 wx.config,同样会失败。排查时打开 debug:
wx.config({
debug: true, // 关键:把 url / timestamp / nonceStr / signature 全部弹窗打印
appId: 'wx1234567890abcdef',
timestamp: 1700000000,
nonceStr: 'Wm3WZYTPz0wzccnW',
signature: '...',
jsApiList: ['chooseImage', 'scanQRCode']
});
// 对照项:签名 URL 应等于 location.href.split('#')[0]
redirect_uri 参数错误 则与签名无关:网页授权回调域名必须在公众号后台”网页授权域名”中配置,且 redirect_uri 的域名与协议须与配置完全一致(配了 https 就不能传 http,也不能带端口)。改完配置记得重新进入公众号会话验证,微信客户端存在缓存。
混合内容与微信 JS-SDK 专项检查:页面里还有哪些 http://
问:Nginx 已经配好证书、浏览器地址栏也显示锁标,为什么 iOS 微信里图片裂开、接口报错?因为 HTTPS 只保护了主文档,页面里残留的 http:// 子资源仍会被浏览器按”混合内容”拦截。第一步永远是扫描构建产物,而不是先动 Nginx。
# 在项目根目录执行:-R 递归,-I 跳过二进制,-n 打印行号,-E 启用扩展正则
grep -RInE 'http://' ./dist ./public 2>/dev/null | grep -v 'http://www.w3.org'
# 排除 SVG 命名空间 xmlns="http://www.w3.org/2000/svg"——它是标识符,不产生网络请求
# 命中项逐条改为 // 或 https://,重新构建后再跑一次确认输出为空
前端产物只是表层,CMS 富文本、历史文章正文往往才是混合内容的大头,需要走数据库批量替换(先备份):
-- MySQL 8.0 / MariaDB 10.5 通用;务必带域名前缀做精确匹配
UPDATE cms_article
SET content = REPLACE(content, 'http://cdn.example.com', 'https://cdn.example.com')
WHERE content LIKE '%http://cdn.example.com%';
-- 切勿全库无差别替换所有 http://,会破坏 XML 命名空间与代码示例文本
过渡期可在 Nginx 加一条 CSP 让浏览器自动升级子资源,但它只是止血带,不修复源站:
# always 表示对所有响应码(含 4xx/5xx)都下发;该指令仅在 HTTPS 页面被浏览器执行
add_header Content-Security-Policy 'upgrade-insecure-requests' always;
| 手段 | 生效范围 | 局限 |
|---|---|---|
upgrade-insecure-requests |
页面内 img/script/css/iframe 等同源与跨域子资源、同源跳转 | 跨域 XHR/fetch 指向 http:// 仍可能被拦截;旧版 WebView 不支持;源站仍是 http |
| 源码替换 http:// → https:// | 彻底 | 需重新构建发版;第三方 CDN 未配证书会 404 |
| HSTS + preload | 整站强制 HTTPS,含首次跳转 | 需稳定运行数月才可提交 preload,回滚困难 |
问:微信里 wx.config 报 config:invalid signature 怎么查?据微信官方 JS-SDK 文档,签名用的 url 必须是当前页面的完整 URL(含查询串、不含 #hash),且与后端计算 sha1(jsapi_ticket=...&noncestr=...×tamp=...&url=...) 时传入的字符串逐字符一致。HTTPS 页面把签名 url 写成 http://,服务端比对必然失败。
wx.config({
debug: true, // 排障时打开会 alert 每次调用结果,上线前务必置 false
appId: 'wx1234567890abcd', // 与公众平台一致
timestamp: 1700000000, // 秒级,与签名时用的值完全相同
nonceStr: 'a1b2c3d4',
signature: '...', // 后端返回,勿在前端计算
jsApiList: ['chooseImage']
});
wx.error(res => console.error(res.errMsg)); // 典型输出:config:invalid signature
SPA 使用 history 路由时,每次 pushState 后 URL 都变了,必须重新取签名再 wx.config,否则分享、选图接口只在首屏可用;这也是公众号 h5 https 配置中最容易被漏掉的一环。
问:授权后反复跳回授权页、登录态丢失?多半是 Cookie 与 CORS 同时出问题。HTTPS 页面携带凭证请求 HTTPS 接口时,Access-Control-Allow-Origin 不能为 *,必须回显具体源;Cookie 写 SameSite=None 时必须同时带 Secure,否则微信内置浏览器直接丢弃该 Cookie。
add_header Access-Control-Allow-Origin 'https://h5.example.com' always;
add_header Access-Control-Allow-Credentials 'true' always;
# 应用侧:Set-Cookie: sessionid=...; Secure; HttpOnly; SameSite=None
问:内嵌 iframe 和支付回调还有坑吗?iframe 的 src 必须是 https://,否则 Chrome 控制台报 Mixed Content: The page at 'https://...' was loaded over HTTPS, but requested an insecure frame 'http://...'. This request has been blocked.。此外,公众号 h5 https 配置要保证支付授权目录、OAuth 的 redirect_uri、商户平台回调地址三处逐字一致;回调若写成 http://,微信支付会直接返回”redirect_uri 域名与后台配置不一致”(错误码 10003)。
效果验证:如何确认 HTTPS 配置真正生效
问:怎么一眼确认 HTTP 已经跳到 HTTPS?
最省事的办法是看响应头。据 RFC 7231,永久跳转应返回 301 而非 302,后者会被浏览器缓存策略区别对待,也会让搜索引擎保留旧索引。
# 1) 验证 HTTP → HTTPS 跳转,关注状态码与 Location
curl -I http://h5.example.com
# 期望输出:
# HTTP/1.1 301 Moved Permanently
# Location: https://h5.example.com/
# 2) 验证 HTTPS 正常响应,关注 200 与 HSTS 头
curl -I https://h5.example.com
# 期望输出:
# HTTP/2 200
# strict-transport-security: max-age=31536000; includeSubDomains
# Nginx 对应配置(HSTS 必须只加在 443 server 块,且用 always 保证错误页也带)
add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
HSTS 的 max-age 单位是秒,Mozilla 推荐起始值 31536000(1 年);一旦下发,浏览器在有效期内拒绝降级到 HTTP,调试阶段建议先用 300 秒试水。若 curl -I http:// 返回 302 或直接 200,说明 80 端口的 server 块缺少 return 301 https://$host$request_uri;。
问:怎么确认只放行了 TLS 1.2 / 1.3,弱协议真被拒?
# 分别握手 TLS 1.2 与 TLS 1.3,确认协议与套件
openssl s_client -connect h5.example.com:443 -servername h5.example.com -tls1_2 /dev/null | grep -E 'Protocol|Cipher'
# 期望:Protocol : TLSv1.2 Cipher : ECDHE-RSA-AES128-GCM-SHA256
openssl s_client -connect h5.example.com:443 -servername h5.example.com -tls1_3 /dev/null | grep -E 'Protocol|Cipher'
# 期望:Protocol : TLSv1.3 Cipher : TLS_AES_256_GCM_SHA384
# 反向验证:TLS 1.0 必须失败
openssl s_client -connect h5.example.com:443 -servername h5.example.com -tls1 </dev/null
# 期望报错:sslv3 alert handshake failure ... SSL alert number 40
-servername 不能省,否则 SNI 缺失会命中默认站点证书,验证结果失真。Nginx 侧对应 ssl_protocols TLSv1.2 TLSv1.3;(1.19.4 起默认值即为这两个),并配 ssl_ciphers 只保留 ECDHE + AEAD 套件。
问:证书链和有效期怎么验?
# 查看本地证书有效期
openssl x509 -in /etc/letsencrypt/live/h5.example.com/fullchain.pem -noout -dates
# notBefore=Mar 1 00:00:00 2025 GMT
# notAfter=May 30 00:00:00 2025 GMT
# 验证链完整(Let's Encrypt 必须用 fullchain.pem 而非 cert.pem)
openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt /etc/letsencrypt/live/h5.example.com/fullchain.pem
# 期望:fullchain.pem: OK
据 Let’s Encrypt 文档,其证书有效期固定 90 天,官方建议在剩余 30 天时续期。openssl verify 若输出 unable to get local issuer certificate,就是漏配了中间证书——这是公众号 h5 https 配置里最常见的“桌面浏览器正常、微信里白屏”的根因。
| 验证工具 | 覆盖范围 | 通过标准 |
|---|---|---|
openssl s_client |
协议版本、套件、链 | TLS1.2/1.3 握手成功,1.0/1.1 报 alert 40 |
nmap --script ssl-enum-ciphers -p 443 h5.example.com |
弱套件枚举 | 无 RC4/3DES,least strength 为 A |
| SSL Labs | 综合评分 | A 及以上(开 HSTS 可到 A+) |
| Chrome DevTools → Security | 页面实际加载 | Certificate – valid,Connection – secure |
问:微信里打开怎么确认 JS-SDK 没被混合内容拖垮?
在微信中打开 H5,注入 vConsole 后看三处:wx.config 回调返回 ok;Network 面板无 Mixed Content 红色报错(典型报错为 Mixed Content: The page at 'https://...' was loaded over HTTPS, but requested an insecure image 'http://...');调用 wx.chooseImage 能正常拉起相册。公众号后台还需逐项核对:MP_verify_xxx.txt 放行根目录且返回 200(curl -I https://h5.example.com/MP_verify_xxx.txt)、JS 接口安全域名与网页授权域名均保存成功、用 https://h5.example.com/oauth-test 走一次静默授权确认 redirect_uri 域名与后台完全一致(含子域名,不带端口)。
问:证书到期前怎么提前收到告警?
# 演练续期,不实际签发
certbot renew --dry-run
# 从线上直接取到期时间
openssl s_client -connect h5.example.com:443 -servername h5.example.com 2>/dev/null | openssl x509 -noout -enddate
# Prometheus blackbox_exporter 告警表达式(阈值 21 天)
probe_ssl_earliest_cert_expiry - time() < 21 * 86400
把 probe_ssl_earliest_cert_expiry 接入告警,比依赖 certbot 的 cron 日志可靠得多——续期失败时日志只写一行 Hook command "/usr/bin/nginx -s reload" returned error code 1,没人会盯。至此,公众号 h5 https 配置才算真正闭环。
普通文章页在微信内仍可能打开 http 页面,但调用微信 JS-SDK、网页授权、支付、地理位置等能力时,后台域名校验与浏览器安全上下文都要求 HTTPS。实际运营中建议全站 301 到 HTTPS,避免混合内容与登录态丢失。
公众号 H5 的加密强度取决于 TLS 配置,DV 与 OV 在浏览器锁标识上没有差异。单域名 H5 用 Let's Encrypt 90 天证书配合 certbot 自动续期即可;若企业需要证书主题展示组织名称、固定 1 年有效期或商业支持,再选 800-3000 元/年的 OV。
先在前端产物执行 grep -RInE 'http://' ./dist 扫描,把接口基址、图片、脚本、iframe 全部改成 https://;后端模板和富文本也要批量替换。过渡期可在 Nginx 加 Content-Security-Policy 'upgrade-insecure-requests',但它不能替代源站修复。
PEM_read_bio_X509_AUX 失败通常是证书路径错误或文件不是 PEM 格式,用 openssl x509 -in fullchain.pem -noout -text 检查;key values mismatch 是证书与私钥不匹配,分别计算 modulus MD5,两个值必须一致,否则重新签发并替换 fullchain.pem 与 privkey.pem。
全站 HTTPS 稳定运行后可以开启 HSTS,Nginx 配置 add_header Strict-Transport-Security 'max-age=31536000; includeSubDomains' always;。首次建议 max-age 先设 300 秒观察,确认所有子域都支持 HTTPS 再逐步加到 31536000 秒;开启 includeSubDomains 前要检查是否有子域仍只跑 HTTP。
有关系。签名 url 必须是当前页面完整 URL,https 页面不能拿 http 的 URL 去签名,也不能包含 # 及其后内容;同时 JS接口安全域名必须与页面域名一致。排查时开 debug: true,对比 config 中的 url、timestamp、nonceStr、signature 与服务端签名原文。
确认文件放在站点根目录并可通过 https://h5.example.com/MP_verify_xxx.txt 直接访问,返回 200 且内容为纯文本;检查 Nginx 的 location / 是否被 SPA history 路由重写到 index.html,必要时为 MP_verify_ 前缀加精确 location 或把文件放到静态目录。
本文由 sslgood.com 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。