跳到主要内容
ssl证书按装

微信小程序 HTTPS 证书申请与 Nginx SSL 配置实战指南

微信小程序 HTTPS 证书申请与 Nginx SSL 配置实战指南 — 微信小程序 HTTPS 证书申请与 Nginx SSL 配置实战指南

问题背景与根因:小程序为什么必须配置 HTTPS

微信小程序从上线起就要求网络请求使用 HTTPS,服务端证书必须由受信任 CA 签发,TLS 版本建议 TLS 1.2 及以上。很多站点不是不会写 Nginx 配置,而是证书链不完整、证书过期、域名与证书 SAN 不匹配、ECS 安全组 443 未放行、SNI 未命中、HTTP 301 跳转被小程序直接请求、页面混合内容等原因导致 https 配置失败。小程序后台的 request 合法域名必须填写 https://example.com 这类域名,不能填 IP、localhost、带端口或带路径的地址;使用中国大陆服务器时通常还要求域名完成 ICP 备案。苹果 ATS 与防广告劫持场景同样偏好完整、可信的 TLS 链路。需要注意:公开信任 TLS 证书单张最长有效期为 398 天,Let’s Encrypt 免费证书有效期为 90 天,旧文章中默认一年有效期的说法已经过时。生产环境要把证书到期监控、自动续期和 443 端口开放纳入上线检查清单。

证书类型与选型:DV、OV、EV 与域名覆盖范围

小程序配置证书常用 DV 域名型证书,几分钟即可签发,适合个人站点、API 域名、iOS 下载页和大多数业务系统。OV 企业型需要 3 至 5 个工作日审核,证书主题包含企业信息;EV 增强型审核更严,浏览器展示策略已与早期不同,不必为地址栏公司名盲目加预算。按域名覆盖范围分为单域名、多域名和通配符:单域名只保护一个 FQDN;多域名通过 SAN 保护多个不同域名;通配符 *.example.com 只覆盖一级子域名,不覆盖主域名 example.com,也不覆盖 a.b.example.com。证书支持 Nginx、Apache、IIS、Tomcat 等服务端,但不同服务端对证书链文件格式要求不同,Nginx 使用 fullchain.pem 加 privkey.pem 最稳妥。证书属于特殊商品,购买前应确认域名、服务器数量和部署方式,避免因域名填错造成退换困难。

类型 审核速度 适用场景 注意事项
DV 几分钟到数小时 小程序 API、个人站、测试转生产 只验证域名控制权,最常见
OV 3 至 5 个工作日 企业门户、SaaS、合作方验收 需企业资料,证书含组织信息
EV 更长 金融、电商、强合规场景 价格高,不必用于普通小程序
覆盖方式 示例 是否覆盖
单域名 api.example.com 仅该域名
多域名 SAN api.example.com、www.example.com 列出的域名
通配符 *.example.com a.example.com,不覆盖 example.com 和 a.b.example.com

申请前准备与 CSR 生成:域名、TXT 与 OpenSSL 命令

申请前准备三项:一是要申请证书的域名清单;二是域名管理权限,按 CA 要求添加 TXT 解析记录完成域名验证;三是 Web 服务器操作系统版本与 Nginx、Apache、IIS、Tomcat 版本。云上 ECS 还要确认安全组和系统防火墙放行 443。生成 CSR 时私钥必须留在自己服务器,不能发给 CA。下面命令可直接执行,把 example.com 替换为真实域名;多域名用 SAN 一次写全,通配符把 CN 改为 *.example.com,并在 SAN 中同时写 DNS:*.example.com 和 DNS:example.com。

openssl req -new -newkey rsa:2048 -sha256 -nodes -keyout example.com.key -out example.com.csr -subj /C=CN/O=Example/CN=example.com -addext subjectAltName=DNS:example.com,DNS:www.example.com
openssl req -in example.com.csr -noout -text
openssl rsa -in example.com.key -check

检查 CSR 中的 Subject、SAN 和公钥算法,确认没有多空格、错域名或漏写 www。CA 签发后通常得到站点证书 cert.pem 和中间链 chain.pem,Nginx 要合并为 fullchain.pem,顺序是站点证书在前、中间 CA 在后。私钥权限建议 600,属主 root。若使用 Let’s Encrypt,可直接用 certbot 申请,证书有效期 90 天,必须配置自动续期;商业证书同样受 398 天上限约束,提前 30 天续期更安全。

Nginx SSL 配置示例:443、301 跳转与 TLS 参数

Nginx 证书配置的核心是 listen 443 ssl、ssl_certificate 指向 fullchain.pem、ssl_certificate_key 指向私钥,并保留 80 端口免费 HTTP 301 跳转到 HTTPS。TLS 只启用 TLSv1.2 和 TLSv1.3,关闭老旧的 SSLv3、TLSv1.0、TLSv1.1。Nginx 1.25.1 及以上使用 http2 on;旧版本可写 listen 443 ssl http2。若站点在云负载均衡、CDN 或 WAF 后面,证书应上传到云证书服务,并确保回源协议为 HTTPS。

server {
    listen 80;
    server_name example.com www.example.com;
    return 301 https://$host$request_uri;
}
server {
    listen 443 ssl;
    http2 on;
    server_name example.com www.example.com;
    ssl_certificate /etc/nginx/ssl/fullchain.pem;
    ssl_certificate_key /etc/nginx/ssl/privkey.pem;
    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_ciphers HIGH:!aNULL:!MD5;
    ssl_prefer_server_ciphers off;
    ssl_session_cache shared:SSL:10m;
    ssl_session_timeout 1d;
    add_header Strict-Transport-Security max-age=31536000;
    location / {
        root /var/www/html;
        index index.html;
    }
}

小程序请求域名应直接使用 https,不要依赖 301 跳转完成协议切换;合法域名不能带路径和端口。HSTS 首次上线建议先用较短 max-age,确认全站 HTTPS 和子域策略后再加长。若出现重定向循环,检查 CDN 回源协议、X-Forwarded-Proto 和 Nginx 的 80 跳转规则是否重复。

证书安装、权限与平滑重载

把 CA 下发的 fullchain.pem 和私钥上传到 /etc/nginx/ssl,不要放在网站根目录。证书文件可 644,私钥必须 600 且属主 root。每次改完先执行 nginx -t,通过后再 reload,避免直接 restart 造成连接中断。下面命令可直接执行:

sudo mkdir -p /etc/nginx/ssl
sudo install -m 644 fullchain.pem /etc/nginx/ssl/fullchain.pem
sudo install -m 600 privkey.pem /etc/nginx/ssl/privkey.pem
sudo nginx -t
sudo systemctl reload nginx
sudo ss -lntp | grep :443

Let’s Encrypt 可用 certbot –nginx -d example.com -d www.example.com 申请并自动改写配置,随后用 systemctl list-timers | grep certbot 检查续期定时器。商业证书在 398 天有效期内也要建立到期提醒。云上 SSL 证书配置若使用 SLB、CDN、WAF,要确认证书绑定域名、监听端口 443、后端协议和 SNI 设置一致;只更新 ECS 上的 Nginx 而忘记云产品证书,仍会出现小程序 HTTPS 握手失败。

部署方式对比:手动证书、Certbot 与云证书托管

手动上传适合 OV、EV 或域名固定的商业证书,可控性强但依赖人工续期;Certbot 适合 DV 和 Let’s Encrypt,90 天有效期必须自动续期;云证书托管适合 SLB、CDN、WAF 和多台 ECS 场景,能集中管理但要注意回源和监听配置。选择时不要只看价格,还要看域名数量、是否通配符、是否多台服务器、是否能自动续期、是否有到期告警。小程序 API 域名通常建议 DV 加自动续期,企业门户再考虑 OV。下表给出对比。

方式 有效期 续期方式 适用场景 主要风险
手动商业证书 最长 398 天 人工上传 OV、EV、固定域名 忘记续期、私钥散落
Certbot 90 天 定时任务自动续期 DV、单域名、多域名 验证失败、定时器未启用
云证书托管 按 CA 签发 云平台续期或重新上传 SLB、CDN、WAF、多 ECS 只改源站未改云产品

无论哪种方式,都要保留私钥备份和证书链文件,记录域名、签发时间、到期时间、部署节点。多台 ECS 建议用配置管理或对象存储分发,避免只更新一台导致负载均衡轮询时报错。证书到期前 30 天完成续期和回归测试,比到期当天排查更可靠。

常见错误排查:真实报错与定位命令

下面报错在 Nginx SSL 配置中很常见,先按错误定位,不要盲目重装证书。

  • nginx: [emerg] cannot load certificate ... No such file or directory:路径写错、文件未上传或权限不足,检查 ssl_certificate 绝对路径。
  • SSL_CTX_use_PrivateKey ... key values mismatch:证书与私钥不匹配,用 openssl x509 -noout -modulus -in fullchain.pem | openssl md5 与 openssl rsa -noout -modulus -in privkey.pem | openssl md5 对比。
  • curl: (60) SSL certificate problem: unable to get local issuer certificate:缺中间 CA,Nginx 应配 fullchain.pem,而不是只配站点证书。
  • 小程序 request:fail ssl handshake error:检查 TLS 1.2、SNI、证书域名、443 安全组、系统防火墙和云负载均衡监听。
  • nginx: [warn] the “ssl” directive is deprecated:删除 ssl on,改为 listen 443 ssl。

定位命令:openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 查看返回链;openssl verify -CAfile chain.pem cert.pem 验证证书链;curl -I https://example.com 看 HTTP 状态和证书错误。301 循环时检查 CDN 回源协议与 X-Forwarded-Proto;443 超时先看安全组、ufw、firewalld 和 ss -lntp 是否有监听。

效果验证与到期监控

配置完成后至少做四层验证:Nginx 语法、端口监听、TLS 握手、业务请求。先执行 curl -I https://example.com 应返回 200 或业务正常状态;再用 openssl s_client 查看证书主题、签发者、有效期和证书链。微信开发者工具和真机都要测试 request 合法域名,确认没有 mixed content,页面内图片、脚本、接口全部为 HTTPS。

curl -I https://example.com
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null
openssl x509 -in /etc/nginx/ssl/fullchain.pem -noout -subject -issuer -dates
openssl x509 -in /etc/nginx/ssl/fullchain.pem -noout -checkend 2592000

checkend 2592000 表示检查 30 天内是否到期,返回 not expired 才安全。可把该命令写入监控脚本,配合 cron 或云监控告警。浏览器地址栏应显示锁标识,openssl s_client -tls1_2 可验证 TLS 1.2 握手,TLS 1.3 站点也可单独测试。最后检查 HSTS 是否只对 HTTPS 生效、301 是否只跳一次、证书链是否完整;若使用 CDN,刷新缓存后再次验证边缘节点证书。

常见问题

小程序一定要用 EV 证书吗?

不需要。大多数小程序使用受信任 CA 签发的 DV 证书即可,关键是 HTTPS 可访问、TLS 1.2 及以上、证书域名匹配、证书链完整,并按平台要求配置 request 合法域名;中国大陆服务器通常还需域名备案。

SSL 证书最长有效期是多少?

公开信任 TLS 证书单张最长有效期为 398 天,Let’s Encrypt 免费证书有效期为 90 天。无论商业证书还是免费证书,都应提前 30 天续期并配置到期监控。

通配符证书能覆盖主域名和三级域名吗?

*.example.com 只覆盖 a.example.com 这类一级子域名,不覆盖 example.com,也不覆盖 a.b.example.com。需要主域名时在 SAN 中追加 DNS:example.com,三级域名要单独列 SAN 或另配证书。

Nginx 只配 cert.pem 为什么浏览器和小程序报证书链错误?

因为缺少中间 CA。Nginx 的 ssl_certificate 应指向 fullchain.pem,顺序为站点证书在前、中间 CA 在后;私钥仍指向 privkey.pem,修改后执行 nginx -t 和 systemctl reload nginx。

安全组已放行 443 仍超时怎么办?

继续检查系统防火墙 ufw 或 firewalld、Nginx 是否 listen 443、云负载均衡监听和回源协议、CDN 回源端口、IPv6 解析以及 SNI 是否命中。用 ss -lntp | grep :443 和 curl -v 可快速定位。

HTTP 301 到 HTTPS 后小程序还报错?

小程序请求域名应直接写 https,不要依赖 301 跳转;合法域名不能带路径和端口。还要确认证书 SAN 包含该域名、443 可达、证书链完整,并检查页面是否存在 HTTP 混合内容。

内容审核

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