跳到主要内容
SSL 证书付费服务

网站 HTTPS 证书安装与 TLS 1.2 配置实战:从 Let’s Encrypt 申请到 SSL Labs A 级

网站 HTTPS 证书安装与 TLS 1.2 配置实战:从 Let's Encrypt 申请到 SSL Labs A 级 — 网站 HTTPS 证书安装与 TLS 1.2 配置实战:从 Let's Encrypt 申请到 SSL Labs A 级

一、问题背景与根因:小程序为什么必须 HTTPS + TLS 1.2

微信小程序通过 wx.request、wx.uploadFile 请求第三方服务器时有几条硬性约束:域名必须已完成工信部备案;域名不能带端口(https://www.example.com:8443 会被直接拒绝);不能使用 localhost 或 127.0.0.1;服务器必须支持 TLS 1.2 及以上,同时禁用 SSLv3、TLS 1.0、TLS 1.1。任何一条不满足,控制台就会抛出 request:fail ssl hand shake error 或 errCode 600001。

实际排障中,根因集中在四类:

  • 证书链不完整:只部署了服务器证书 cert.pem,缺少中间证书。PC 浏览器有时“能打开”,但 Android 微信、iOS 微信、curl 会直接握手失败。
  • 协议版本过低:服务器仍启用 TLS 1.0/1.1,甚至残留 SSLv3,小程序握手被拒。
  • 域名与证书不匹配:证书 SAN 里只有 example.com,却用 www.example.com 访问。
  • 证书过期:这是目前最高频的原因。CA/Browser Forum 规定自 2020-09-01 起,公开信任的 TLS 证书最长有效期不得超过 398 天;Let’s Encrypt 免费证书有效期固定为 90 天。原文“有效期一年、到期免费续期”的说法已过时,必须落地自动续期。

动手前先用一条命令确认现状:

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

输出里的 notAfter 即到期时间;若 verify return code 为 20(unable to get local issuer certificate)或 21,说明证书链有问题,需要先补全中间证书再谈其他优化。

二、准备工作:备案域名、DNS 解析、私钥与 CSR

动手前把下面五项确认完,可以省掉大量返工:

  1. 域名已完成 ICP 备案,A 记录指向服务器公网 IP:dig +short www.example.com 应返回目标 IP。
  2. 安全组与系统防火墙放行 80、443。HTTP-01 验证要求 80 端口可被公网访问;80 被封时改用 DNS-01。
  3. Web 服务已能通过 HTTP 正常访问,且没有强制跳转到带端口的地址。
  4. 准备一个长期有效的运维邮箱,用于接收证书到期通知。
  5. 确认 Web 服务类型(Nginx / Apache / IIS / Tomcat),后续配置路径完全不同。

若购买商业 DV/OV 证书,需要在服务器上生成私钥与 CSR 后提交给 CA:

mkdir -p /etc/nginx/ssl
openssl req -new -newkey rsa:2048 -nodes 
  -keyout /etc/nginx/ssl/example.com.key 
  -out /etc/nginx/ssl/example.com.csr 
  -subj "/C=CN/ST=Beijing/L=Beijing/O=Example/CN=example.com" 
  -addext "subjectAltName=DNS:example.com,DNS:www.example.com"
chmod 600 /etc/nginx/ssl/example.com.key
openssl req -in /etc/nginx/ssl/example.com.csr -noout -text | grep -A1 "Subject Alternative Name"

要点:CN 只写主域名,所有备用域名必须写进 SAN(subjectAltName),现代浏览器和微信只认 SAN,不认 CN。私钥权限必须是 600 且属主为 root,严禁通过邮件或聊天工具传输私钥。

三、实操:用 Let’s Encrypt 申请 90 天证书并自动续期

Nginx 环境首选 certbot,webroot 方式不影响现有站点:

apt update && apt install -y certbot python3-certbot-nginx
certbot certonly --webroot -w /var/www/html 
  -d example.com -d www.example.com 
  --email ops@example.com --agree-tos --no-eff-email

证书落在 /etc/letsencrypt/live/example.com/ 下,四个文件务必分清:fullchain.pem(服务器证书 + 中间证书,Web 配置里必须用它)、privkey.pem(私钥)、cert.pem(仅服务器证书,单独使用会导致链不完整)、chain.pem(中间证书,用于 OCSP Stapling)。

需要通配符 *.example.com 时只能走 DNS-01,用 acme.sh 配合 DNS 服务商 API:

curl https://get.acme.sh | sh -s email=ops@example.com
export Ali_Key="LTAI5t****" Ali_Secret="****"
~/.acme.sh/acme.sh --issue --dns dns_ali -d example.com -d "*.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 "systemctl reload nginx"

续期演练是必做项:certbot renew --dry-run 必须成功;systemd 环境下 certbot 自带 timer(systemctl list-timers | grep certbot),acme.sh 会写入 crontab。90 天有效期意味着续期一旦失败,两个月内全站就会报证书错误,因此再加一条巡检:

echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null 
 | openssl x509 -noout -checkend 1209600 || echo "证书将在14天内过期"

四、配置示例:Nginx 的 TLS 1.2/1.3、HSTS 与 OCSP Stapling

先做 80 到 443 的 301 跳转,再配置 443 站点:

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/letsencrypt/live/example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;

    ssl_protocols TLSv1.2 TLSv1.3;   # 明确禁用 SSLv3/TLSv1.0/TLSv1.1
    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;

    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/letsencrypt/live/example.com/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.php index.html;
}

校验并生效:nginx -t && systemctl reload nginx。三个高频坑:ssl_certificate 必须指向 fullchain;HSTS 首次上线建议先用 max-age=300 观察一天,再调到 31536000,因为一旦下发 includeSubDomains,所有子域都必须有有效证书,否则整片子域不可访问;nginx 1.25.1 之前没有 http2 on; 指令,照抄会报 unknown directive “http2″。

五、Apache、IIS 配置要点与混合内容(Mixed Content)修复

Apache 先启用模块 a2enmod ssl headers,再写虚拟主机:

<VirtualHost *:443>
    ServerName example.com
    SSLEngine on
    SSLCertificateFile      /etc/letsencrypt/live/example.com/fullchain.pem
    SSLCertificateKeyFile   /etc/letsencrypt/live/example.com/privkey.pem
    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>

执行 apachectl configtest 返回 Syntax OK 后再 systemctl reload apache2。

IIS 的做法是导入包含中间证书的 .pfx(导入时勾选“允许导出”),在站点绑定中添加 https/443,再用 IISCrypto 或注册表 HKLMSYSTEMCurrentControlSetControlSecurityProvidersSCHANNELProtocols 关闭 TLS 1.0/1.1。

证书装好后页面仍可能小锁带感叹号,控制台报:

Mixed Content: The page at 'https://example.com/' was loaded over HTTPS,
but requested an insecure resource 'http://cdn.example.com/a.js'.
This request has been blocked.

处理方式:把模板里的绝对地址 http:// 改为 // 或 https://;对暂时改不了的老资源,加一条 CSP 让浏览器自动升级:add_header Content-Security-Policy "upgrade-insecure-requests" always;。第三方组件确实不支持 HTTPS 的,只能替换或下线,这一步无法靠配置绕过。

六、方案对比:证书类型、验证方式与协议配置

选型先看有效期与自动化能力,再看品牌:

方案 有效期 验证方式 覆盖范围 适用场景
Let’s Encrypt DV 90 天 HTTP-01 / DNS-01 单域名或多域名 绝大多数网站,必须自动续期
Let’s Encrypt 通配符 90 天 仅 DNS-01 *.example.com 子域多、80 端口不可用
商业 DV 最长 398 天 DNS / 文件 / 邮件 单域名或通配符 无自动化运维能力
商业 OV / EV 最长 398 天 企业实名核验 单域名 / 多域名 金融、政企需展示主体信息
自签名 自定义 无 任意 仅内网测试,小程序一律拒绝

验证方式的选择同样关键:

维度 HTTP-01 DNS-01
端口依赖 80 必须公网可达 无要求
通配符 不支持 支持
自动化 certbot –webroot 一条命令 需 DNS 服务商 API Key
典型失败 防火墙拦截、301 跳转导致校验失败 TXT 记录未生效、API 权限不足

结论:单域名站点用 Let’s Encrypt + HTTP-01 最省事;有通配符需求或 80 被运营商封禁时,直接上 acme.sh + DNS-01。不要为了“看起来专业”去买一年期商业证书却不做到期监控,398 天过期造成的故障和 90 天过期没有任何区别。

七、常见错误排查:从真实报错到根因

1)curl: (60) SSL certificate problem: unable to get local issuer certificate
根因:证书链不完整。修复:配置改用 fullchain.pem。验证:openssl s_client -showcerts -connect example.com:443 -servername example.com </dev/null,正常应输出 2 张及以上证书。

2)nginx: [emerg] SSL_CTX_use_PrivateKey_file(“/etc/nginx/ssl/example.com.key”) 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 privkey.pem  | openssl md5

3)小程序报 request:fail ssl hand shake error / errCode: 600001
根因:TLS 版本过低或证书链不全。用 openssl s_client -connect example.com:443 -servername example.com -tls1_2 </dev/null 测试,若报 handshake failure 说明服务端未开 TLS 1.2。

4)浏览器 NET::ERR_CERT_COMMON_NAME_INVALID / SSL_ERROR_BAD_CERT_DOMAIN
根因:SAN 不含当前访问域名。检查:openssl x509 -noout -text -in fullchain.pem | grep -A1 "Subject Alternative Name"。

5)certbot 报 Timeout during connect (likely firewall problem) 或 Could not bind TCP port 80
根因:80 未放行或被 Nginx 占用。可临时停 Nginx 用 --standalone,或直接切 DNS-01。

6)开发者工具能请求,真机报 request:fail
根因:工具里勾选了“不校验合法域名、web-view 域名、TLS 版本以及 HTTPS 证书”。真机严格校验,必须是可信 CA 签发的有效证书 + 已备案域名 + 443 端口。

八、效果验证:从命令行到 SSL Labs A 级

部署完成后按顺序做四层验证。第一层,协议与证书信息:

openssl s_client -connect example.com:443 -servername example.com -tls1_2 </dev/null | head -20
curl -sI https://example.com | head -5
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null 
  | openssl x509 -noout -issuer -subject -dates

确认 Protocol 为 TLSv1.2 或 TLSv1.3、verify return code 为 0、notAfter 在预期时间内。第二层,确认旧协议已关闭:openssl s_client -connect example.com:443 -tls1 </dev/null 应当失败,返回 unsupported protocol 或 handshake failure。

第三层,用 Qualys SSL Server Test(https://www.ssllabs.com/ssltest/)跑完整评分,目标是 A 或 A+。达不到 A 的常见扣分项:启用了 TLS 1.0/1.1、使用 RC4/3DES 弱套件、缺少 HSTS、证书链冗余或顺序错误。A+ 还需满足 HSTS max-age 不少于 6 个月。

第四层,业务侧验证:微信开发者工具关闭“不校验合法域名”后再请求一次;真机扫码测试;浏览器 F12 检查 Console 无 Mixed Content 报错、Network 中所有资源均为 https。最后把巡检脚本挂到 crontab,每天 9 点检查一次剩余有效期,剩余不足 14 天即告警:

0 9 * * * echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null | openssl x509 -noout -checkend 1209600 || echo "证书即将过期" | mail -s "SSL告警" ops@example.com

常见问题

Let’s Encrypt 证书是不是一年有效期?

不是。Let’s Encrypt 签发的证书有效期固定为 90 天,且官方支持通过 ACME 协议自动续期。同时,CA/Browser Forum 规定自 2020-09-01 起,所有公开信任的 TLS 证书最长有效期不得超过 398 天,市面上“两年期证书”实际是分两次签发或由 CA 托管续期,并非单张证书有效期两年。

通配符证书能覆盖 a.b.example.com 这样的二级子域吗?

不能。*.example.com 只匹配一级子域,如 www.example.com、api.example.com,不匹配 a.b.example.com。如果需要多级覆盖,必须分别申请 *.example.com 与 *.b.example.com,或把这些域名逐个写进 SAN。

证书装好后网站打不开或出现重定向循环怎么办?

先确认反向代理链路:若前面有 CDN 或负载均衡,回源协议要设为 HTTPS,并在 Nginx 中补 proxy_set_header X-Forwarded-Proto $scheme;;应用侧(如 WordPress、Spring Boot)若判断 request.isSecure() 为 false 会再次跳转,导致无限 301。排查用 curl -I -L https://example.com 观察跳转链路即可定位。

80 端口必须一直对外开放吗?

取决于验证方式。使用 HTTP-01 续期时 80 必须可达,否则 certbot renew 会失败;改用 DNS-01 或 TLS-ALPN-01 后可以只保留 443。不过仍建议保留 80 并做 301 跳转,避免用户手动输入域名时访问失败。

私钥疑似泄露该如何处理?

立即吊销并重签,不要等证书自然到期。certbot 用 certbot revoke --cert-path /etc/letsencrypt/live/example.com/cert.pem,acme.sh 用 acme.sh --revoke -d example.com,随后删除旧私钥并重新签发部署。吊销后记得清理备份与 CI 变量中的旧私钥。

小程序是否强制要求 SSL Labs 达到 A 级?

不强制。微信的硬性要求只有三条:域名已备案且不带端口、证书由受信任 CA 签发且域名匹配、服务端支持 TLS 1.2 及以上。A 级评分是安全加固目标,属于加分项而非准入门槛。

内容审核

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