跳到主要内容
HTTPS小程序证书

SSL 证书与 HTTPS 全流程配置指南:398 天有效期、Nginx 部署与小程序强制 HTTPS 落地

SSL 证书与 HTTPS 全流程配置指南:398 天有效期、Nginx 部署与小程序强制 HTTPS 落地 — SSL 证书与 HTTPS 全流程配置指南:398 天有效期、Nginx 部署与小程序强制 HTTPS 落地

一、问题背景与根因:明文 HTTP 到底输在哪

HTTP 协议本身既不加密,也不校验通信双方身份,请求和响应会以明文经过每一跳路由。攻击者或中间设备可以在任意节点完成三类操作:监听(抓取账号密码、Cookie、身份证号)、篡改(插入广告、替换下载包、注入 JS)、劫持(DNS 污染或 302 跳转把用户带到仿冒站)。这类问题在公共 Wi-Fi、老旧运营商链路和境外回源路径上尤其常见,仅靠前端 JS 加密无法解决,因为密钥同样以明文传输。

第二个根因是信任缺失。Chrome、Firefox、Edge 会对 http:// 页面在地址栏标注「不安全」,用户在看到登录框之前就已经流失。第三个根因是平台硬性要求:微信小程序的 wx.request 与 wx.uploadFile 只允许 https:// 请求,且域名必须在「服务器域名」白名单内、完成 ICP 备案、证书由受信任 CA 签发、TLS 版本不低于 1.2;支付宝小程序、快应用、iOS ATS 同样默认阻断明文请求。

因此,「装个证书」并不等于完成 HTTPS 改造。真实故障往往出在四件事:只部署了叶子证书、没有带上中间证书;80 端口没有做 301 跳转;页面里残留 http 资源造成混合内容;证书到期未续。下面按选型、签发、部署、加固、排错、验证的顺序,给出可直接执行的步骤。

二、证书选型与有效期:398 天、90 天与三种验证级别

先纠正两个常见的过时认知。第一,公开信任的 TLS 证书单张有效期上限为 398 天(CA/Browser Forum 基线要求,2020 年 9 月起生效),并非早期的 2 年或 3 年;超过 398 天的证书会被 Chrome、Safari 直接判为不合规。第二,Let’s Encrypt 的证书有效期固定为 90 天,官方推荐到期前 30 天自动续期,由 certbot 定时任务完成,不需要手工一年一换。

验证级别决定审核成本:DV 只校验域名控制权,签发通常几分钟,适合大多数站点和小程序后端;OV 额外核验企业营业执照与电话,证书详情里显示组织名;EV 审核最严,但主流浏览器自 2019 年起已取消绿色地址栏和公司名展示,所谓「绿色小锁显示企业名称」的说法已经过时,EV 现在只在证书信息面板中体现,除非有合规硬要求,否则不必为此多付费用。

覆盖范围要按域名结构选:单域名证书只保护一个 FQDN;多域名(SAN)证书可在一张证书里放多个域名,适合 example.com、www.example.com、api.example.com 这类组合;通配符 *.example.com 只覆盖一级子域,不覆盖 example.com 本身,也不覆盖 a.b.example.com。

类型 验证内容 典型签发时长 有效期 适用场景
DV 单域名 域名控制权 1-10 分钟 90-398 天 博客、测试环境、小程序 API
DV 通配符 DNS 记录 10 分钟-1 小时 90-398 天 子域多、需要批量扩容
OV 多域名 域名+企业资质 1-3 个工作日 最长 398 天 企业官网、支付回调
EV 扩展人工审核 3-7 个工作日 最长 398 天 金融、强合规行业

选型结论:绝大多数业务选 DV 或 OV 即可;子域超过 5 个优先选通配符;无论选哪种,都要把自动续期与到期监控写进上线清单。

三、实操:生成私钥与 CSR(可直接执行)

CSR(证书签名请求)包含公钥和主体信息,私钥必须留在自己服务器上,任何情况下都不要发给 CA。推荐使用 2048 位 RSA 或 P-256 ECDSA:前者兼容性最好,后者握手更快、证书更小。

# 1. 生成 RSA 私钥(2048 位,兼容性优先)
openssl genpkey -algorithm RSA -pkeyopt rsa_keygen_bits:2048 -out example.com.key

# 或生成 ECDSA P-256 私钥(性能优先,需确认客户端支持)
openssl ecparam -genkey -name prime256v1 -out example.com.key

# 2. 收紧权限,私钥只允许 root 读取
chmod 600 example.com.key
chmod 700 /etc/nginx/ssl

# 3. 生成 CSR,SAN 必须一次性写全,www 与主域都要有
openssl req -new -key example.com.key -out example.com.csr 
  -subj '/C=CN/ST=Zhejiang/L=Hangzhou/O=Example Co.,Ltd/CN=example.com' 
  -addext 'subjectAltName=DNS:example.com,DNS:www.example.com,DNS:api.example.com'

# 4. 校验 CSR:确认 SAN 列表与公钥算法
openssl req -in example.com.csr -noout -text | grep -A2 'Subject Alternative Name'
openssl req -in example.com.csr -noout -verify

常见坑:CN 字段现代浏览器已忽略,真正生效的是 SAN,漏写 www 会直接导致 www 域名报证书名称不匹配;-subj 里的 O 字段含逗号时必须转义,否则 CSR 主体会被截断;生成 CSR 后不要重新生成私钥,否则证书与私钥不匹配。CSR 本身可以公开,但私钥一旦泄露只能吊销重签。

四、实操:签发、部署与自动续期

免费路线用 Let’s Encrypt 加 certbot,商业证书则把 CA 返回的 fullchain 与私钥上传到服务器。两种路线的部署文件一致:证书链文件必须是「服务器证书 + 中间证书」的拼接顺序,不能只放叶子证书。

# Debian/Ubuntu 安装 certbot 及 nginx 插件
apt update
apt install -y certbot python3-certbot-nginx

# 一键签发并自动改写 nginx 配置、添加 80 到 443 跳转
certbot --nginx -d example.com -d www.example.com 
  --agree-tos -m ops@example.com --redirect

# 仅签发不修改配置(webroot 模式,适合已有自定义配置)
certbot certonly --webroot -w /var/www/html -d example.com

# 演练续期,确认定时任务可用
certbot renew --dry-run

续期后的 reload 钩子必须显式写,否则新证书落盘但 nginx 仍用旧证书:

# /etc/letsencrypt/renewal-hooks/deploy/reload-nginx.sh
#!/bin/sh
nginx -t && systemctl reload nginx
# chmod +x 该脚本后生效

商业证书部署时把 fullchain.pem(含中间证书)、example.com.key 放到 /etc/nginx/ssl/,权限 600。证书到期前 30 天必须完成续签,398 天不是可以拖到最后一天的理由;Let’s Encrypt 的 90 天证书一旦错过续期窗口,小程序端会立刻出现 handshake 失败。

五、配置示例:Nginx 的 HTTPS、跳转与 HSTS

下面是一份可直接落地的最小配置,包含 80 跳转、TLS 1.2/1.3、会话复用、OCSP 装订与 HSTS。

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/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/chain.pem;

    add_header Strict-Transport-Security 'max-age=31536000; includeSubDomains' always;
    add_header X-Content-Type-Options nosniff always;

    root /var/www/html;
    index index.html;
}

生效前先语法检查再 reload,避免把线上打挂:

nginx -t && systemctl reload nginx

三个细节决定成败:第一,HSTS 首次上线建议先用 max-age=300 观察,确认全站子域都支持 HTTPS 后再加到一年,否则子域里的 http 服务会被浏览器直接阻断;第二,TLS 1.0/1.1 必须关闭,小程序与主流浏览器均已不兼容;第三,OCSP 装订需要 chain.pem 指向中间证书,路径写错会导致 ssl_stapling 静默失效。CDN 或负载均衡场景,证书应上传到 SLB/CDN 侧,并在回源层同样开启 HTTPS,否则回源段仍是明文。

六、小程序、APP 与 CDN 侧的关键配置

微信小程序不是「有证书就能通」。在公众平台后台进入开发、开发管理、开发设置、服务器域名,把 https://api.example.com 加入 request 合法域名;域名不能带端口、不能是 IP、不能带路径,且必须已完成 ICP 备案。业务域名还需下载校验文件放到站点根目录。该列表修改次数按自然月受限,上线前要一次性规划好。

小程序运行环境不接受用户手动信任证书,因此证书链必须完整,TLS 版本必须不低于 1.2。iOS 端 ATS 默认要求 TLS 1.2+ 与 SHA-256 签名证书,Android 7.0 以下老机型对 ECDSA 证书兼容性较差,面向存量设备多的业务建议使用 RSA 2048。

# 检查 CAA 记录,避免 CA 签发被域名策略拦截
dig +short CAA example.com

# 检查是否还有 http 资源引用(混合内容根因)
curl -s https://example.com | grep -o 'http://[^ ]*' | head

防劫持加固不止于证书:配置 CAA 记录限定可签发 CA,开启 DNSSEC 降低 DNS 劫持风险,全站 301 到 HTTPS 并启用 HSTS,站内所有静态资源、接口、WebSocket 一律改用 https/wss。APP 侧还要在 Android 的 network_security_config 中关闭明文流量,iOS 保持 ATS 默认开启。CDN 场景下记得同时开启强制 HTTPS 跳转与 HTTPS 回源,只做前者等于源站仍可被绕过。

七、常见错误排查:真实报错与修复动作

curl: (60) SSL certificate problem: unable to get local issuer certificate:服务端只发了叶子证书,缺中间证书。修复:把 CA 提供的中间证书拼到服务器证书之后生成 fullchain.pem,顺序为叶子在前、中间在后,不要包含根证书。

nginx: [emerg] SSL_CTX_use_PrivateKey_file(…) failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch):证书与私钥不是一对。用模数比对确认:

openssl x509 -noout -modulus -in fullchain.pem | openssl md5
openssl rsa -noout -modulus -in example.com.key | openssl md5

两行输出必须一致,不一致就重新用当前私钥生成 CSR 并重签。

浏览器 NET::ERR_CERT_COMMON_NAME_INVALID 或 SSL_ERROR_BAD_CERT_DOMAIN:访问的域名不在证书 SAN 中,典型情况是只签了 example.com,却用 www.example.com 访问。修复:重签时把两个域名都写入 SAN。

NET::ERR_CERT_DATE_INVALID:证书过期,或服务器时间偏差超出容忍范围,先校时再查续期任务。

小程序报错 request:fail ssl handshake error 或提示 TLS 版本必须大于等于 1.2:多为协议版本过低或证书链不完整,用 openssl s_client 复现,确认协商出的协议版本与 Verify return code。

Mixed Content: The page at https://… was loaded over HTTPS, but requested an insecure resource http://…:页面内仍有 http 图片、脚本或接口,浏览器会拦截。修复:全量替换为 https 或使用协议相对路径,并在 CSP 中加 upgrade-insecure-requests。

排查顺序建议固定为:DNS 解析是否正确、443 是否放行、证书链是否完整、域名是否匹配、协议版本、应用层混合内容。

八、效果验证:从命令行到小程序真机

部署完成后按下面四步验证,任何一步不通过都不要上线。

# 1. 跳转是否生效:应返回 301 且 Location 为 https
curl -sI http://example.com | head -5

# 2. 证书主体、签发者与到期时间
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null 
  | openssl x509 -noout -subject -issuer -dates

# 3. 证书链校验:必须看到 Verify return code: 0 (ok)
echo | openssl s_client -connect example.com:443 -servername example.com 
  -CAfile /etc/ssl/certs/ca-certificates.crt 2>&1 | grep 'Verify return code'

# 4. 剩余有效期不足 30 天时返回非 0,可接入监控
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null 
  | openssl x509 -noout -checkend 2592000

在线侧用 SSL Labs 跑一次完整评估,目标 A 及以上;重点看 Certificate chain complete、TLS 1.0/1.1 是否关闭、HSTS 是否生效。协议与套件可用 nmap –script ssl-enum-ciphers -p 443 example.com 复核。

最后是小程序真机验证:开发者工具勾选「不校验合法域名」只能用于本地调试,必须用真机预览走一遍登录、下单、上传三条主链路,观察 Network 面板中每个请求是否均为 https 且无证书警告。APP 侧用 Charles 或抓包工具确认无明文请求。监控上建议对到期时间、握手失败率、301 覆盖率三项设告警,证书类故障 90% 都能被这三项提前发现。

常见问题

免费 Let’s Encrypt 证书能用于微信小程序吗?

可以。小程序要求的是受信任 CA 签发、TLS 不低于 1.2、证书链完整,并不区分免费或付费。但 Let’s Encrypt 有效期只有 90 天,必须配置 certbot 自动续期与 reload 钩子,否则到期当天小程序会直接 handshake 失败。

证书最长 398 天,是不是一年换一次就行?

398 天是公开信任证书的有效期上限,不是建议值。实际部署建议直接用 90 天证书加自动续期,缩短私钥泄露后的暴露窗口;如果使用商业证书,也要在到期前 30 天完成续签并更新监控。

通配符证书能覆盖哪些域名?

*.example.com 覆盖 a.example.com、b.example.com 等一级子域,不覆盖 example.com 本身,也不覆盖 a.b.example.com。需要主域时把 example.com 作为 SAN 一起签,需要多级子域则要单独签 *.b.example.com。

已经装了证书,浏览器为什么还提示不安全?

常见原因有四类:页面存在 http 资源导致混合内容、证书链缺中间证书、访问域名不在 SAN 中、证书已过期。用开发者工具 Security 面板与 openssl s_client 的 Verify return code 可以逐项定位。

HTTP/2 和 HTTPS 是什么关系?

浏览器只在 TLS 之上实现 HTTP/2,因此必须先把站点升级到 HTTPS 才能启用 h2。Nginx 1.25.1 及以上用 http2 on; 开启,旧版本写在 listen 443 ssl http2; 中,启用后用 curl -I –http2 https://example.com 确认返回 HTTP/2。

多个域名必须买多张证书吗?

不一定。可以用一张多域名(SAN)证书覆盖多个 FQDN,也可以用通配符覆盖同域下的一级子域;域名分属不同主域且数量多时,分开管理更利于续期和故障隔离。

内容审核

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