跳到主要内容
ssl证书按装

SSL证书配置与域名HTTPS安全加固实战:单域名、泛域名及微信小程序支持

SSL证书配置与域名HTTPS安全加固实战:单域名、泛域名及微信小程序支持 — SSL证书配置与域名HTTPS安全加固实战:单域名、泛域名及微信小程序支持

问题背景与根因:证书装上了为什么还报 HTTPS 错误

微信小程序、公众号、APP、支付回调以及苹果 ATS 都要求服务端使用 HTTPS;搜索引擎也会优先抓取 HTTPS 页面。但实际故障往往不是“没有证书”,而是证书链、域名匹配或 TLS 协商失败。常见根因包括:只部署了站点证书,缺少中间 CA 导致 Android 旧版本和微信报证书不受信任;证书 SAN 未包含 www 或根域名;泛域名 *.example.com 只覆盖一级子域,不覆盖 example.com 和 a.b.example.com;服务器未开启 SNI,多域名共用 443 时返回错误证书;TLS 1.0/1.1 或弱套件被客户端拒绝;服务器时间偏差导致 notBefore/notAfter 校验失败;CDN 已换证但源站仍旧证书。另需注意,公共可信 TLS 证书单次有效期最长 398 天,Let’s Encrypt 为 90 天,必须建立续期与 reload 机制,否则到期当天会出现 NET::ERR_CERT_DATE_INVALID。

完整实操步骤:CSR、签发、部署与重载

先确认域名解析和 80/443 放行。单域名或多域名可用 OpenSSL 生成私钥与 CSR,并把所有需要覆盖的域名写入 SAN:

openssl req -new -newkey rsa:2048 -nodes -keyout example.com.key -out example.com.csr -subj '/C=CN/ST=Beijing/L=Beijing/O=Example/CN=example.com' -addext 'subjectAltName=DNS:example.com,DNS:www.example.com'
openssl req -in example.com.csr -noout -text | grep -A2 'Subject Alternative Name'

Let’s Encrypt 单域名/多域名使用 HTTP-01:

certbot certonly --webroot -w /var/www/html -d example.com -d www.example.com
acme.sh --issue --webroot /var/www/html -d example.com -d www.example.com

泛域名必须用 DNS-01,因为 CA 无法对 *.example.com 做 HTTP 文件校验:

certbot certonly --manual --preferred-challenges dns -d '*.example.com' -d example.com
acme.sh --issue --dns dns_ali -d example.com -d '*.example.com'
dig +short TXT _acme-challenge.example.com

签发后部署 fullchain 与私钥,私钥权限 600,先测试再 reload:

install -m 600 example.com.key /etc/nginx/ssl/example.com.key
install -m 644 fullchain.pem /etc/nginx/ssl/example.com.fullchain.pem
nginx -t && systemctl reload nginx

配置示例:Nginx 与 Apache 最小可用 HTTPS 配置

Nginx 必须让 ssl_certificate 指向 fullchain,而不是单独站点证书;HTTP 统一 301 到 HTTPS,TLS 只保留 1.2/1.3:

server {
    listen 80;
    server_name example.com www.example.com;
    return 301 https://$host$request_uri;
}
server {
    listen 443 ssl http2;
    server_name example.com www.example.com;
    ssl_certificate /etc/nginx/ssl/example.com.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 off;
    ssl_session_cache shared:SSL:10m;
    ssl_session_timeout 1d;
    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 https;
    }
}

Apache 需同时配置证书、私钥和中间证书链,并禁用 SSLv3/TLS1.0/TLS1.1:

<VirtualHost *:443>
SSLEngine on
SSLCertificateFile /etc/httpd/ssl/example.com.crt
SSLCertificateKeyFile /etc/httpd/ssl/example.com.key
SSLCertificateChainFile /etc/httpd/ssl/example.com.ca-bundle
SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1
</VirtualHost>

HSTS 只能在所有子域均已 HTTPS 后开启;includeSubDomains 会强制浏览器后续只走 HTTPS。

泛域名、通配符域名与微信小程序域名白名单

通配符证书只匹配一个 DNS 标签:*.example.com 覆盖 api.example.com、www.example.com,不覆盖 example.com,也不覆盖 a.b.example.com。因此申请时通常写成 -d example.com -d ‘*.example.com’,把根域名放入 SAN。Nginx 可用 server_name example.com *.example.com; 但证书是否匹配仍以 SAN 为准。微信小程序后台配置 request 合法域名时,必须使用已备案且受信任的 HTTPS 域名,不能填 IP、localhost 或带非标准端口;TLS 建议 1.2 及以上,证书链必须完整。验证命令:

curl -I https://api.example.com
openssl s_client -connect api.example.com:443 -servername api.example.com -showcerts </dev/null
openssl s_client -connect api.example.com:443 -servername api.example.com -tls1_2 -verify_return_error </dev/null

如果小程序报 request:fail ssl hand shake error,先在服务器本机执行上述命令,再在开发者工具关闭“不校验合法域名”复测;仍失败时重点查中间证书、SNI、系统时间和 CDN 回源证书。

单域名、多域名 SAN、通配符证书对比与选型

类型 覆盖范围 校验方式 有效期 适用场景 注意点
单域名 example.com 或 www.example.com HTTP-01/DNS-01 公共 CA 最长 398 天;Let’s Encrypt 90 天 官网、单接口域名 www 与根域名算两个名字,需分别写入
多域名 SAN 最多按 CA 限制容纳多个域名 HTTP-01/DNS-01 同上 多品牌、多业务域名 新增域名需重签,注意 SAN 列表
通配符 *.example.com 仅一级子域 必须 DNS-01 同上 大量同级子域、小程序 API 集群 不覆盖根域名和二级以上子域,需加 SAN
免费 Let’s Encrypt 单域名/多域名/通配符 HTTP-01/DNS-01 90 天 自动化运维、测试与生产 必须配置自动续期和 reload

选型原则:域名少且固定选单域名或多域名 SAN;子域数量多且层级固定选通配符;根域名必须单独加入 SAN。不要用自签证书替代小程序生产证书,否则微信和浏览器均不信任。

SSL 域名安全加固:HSTS、OCSP、密钥权限与自动续期

证书部署后还要做加固。私钥只允许 root 读取;开启 OCSP Stapling 可减少客户端回源校验;HSTS 要谨慎,先确认所有子域都支持 HTTPS。Nginx 可追加:

chmod 600 /etc/nginx/ssl/example.com.key
chown root:root /etc/nginx/ssl/example.com.key
ssl_stapling on;
ssl_stapling_verify on;
ssl_trusted_certificate /etc/nginx/ssl/example.com.fullchain.pem;
resolver 223.5.5.5 1.1.1.1 valid=300s;
add_header Strict-Transport-Security 'max-age=31536000; includeSubDomains' always;

续期必须演练:Certbot 执行 certbot renew –dry-run;acme.sh 执行 acme.sh –cron –home /root/.acme.sh,并在 renew-hook 中 nginx -t && systemctl reload nginx。检查证书时间和主体:openssl x509 -in /etc/nginx/ssl/example.com.fullchain.pem -noout -dates -subject -issuer。若使用 CDN,源站和 CDN 证书都要更新;否则会出现边缘证书正常、回源 443 校验失败。

常见错误排查:从真实报错定位证书链与域名匹配

1)curl: (60) SSL certificate problem: unable to get local issuer certificate。多数是未部署中间证书,ssl_certificate 应指向 fullchain.pem;用 openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 查看返回链是否完整。2)浏览器 NET::ERR_CERT_COMMON_NAME_INVALID。证书 SAN 不含当前域名,检查是否漏了 www、根域名或二级子域。3)nginx: [emerg] cannot load certificate … PEM_read_bio_X509_AUX() failed。路径错误、文件不是 PEM 或权限不足,先 openssl x509 -in 文件 -noout -subject 验证。4)SSL_CTX_use_PrivateKey: key values mismatch。证书与私钥不匹配,用 openssl x509 -noout -modulus -in cert.pem | openssl md5 与 openssl rsa -noout -modulus -in key.pem | openssl md5 对比。5)微信 request:fail ssl hand shake error。查 TLS 1.2、SNI、系统时间、中间证书和 CDN 回源。修改后统一执行 nginx -t && systemctl reload nginx,并用 curl -vI https://example.com 复测。

效果验证:curl、openssl 与微信开发者工具复测

部署完成后按三层验证。第一层看 HTTP 跳转和 HSTS:curl -sI http://example.com 应返回 301;curl -sI https://example.com | grep -i strict-transport-security 应看到 max-age。第二层看证书链与有效期:openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null,确认返回站点证书和中间 CA;openssl s_client -connect example.com:443 -servername example.com -tls1_2 -verify_return_error </dev/null 应输出 Verify return code: 0 (ok)。第三层看协议与套件:nmap –script ssl-enum-ciphers -p443 example.com,或使用 SSL Labs 检测,确保不支持 TLS 1.0/1.1、无弱套件、证书链完整。微信小程序在开发者工具关闭“不校验合法域名”后发起 request,再真机预览;若真机失败而工具正常,重点查手机系统时间、根证书和 CDN 节点。最后执行 certbot renew –dry-run 或 acme.sh –cron,确认自动续期后能自动 reload。

常见问题

不能。*.example.com 只匹配一级子域,不匹配 example.com,也不匹配 a.b.example.com。申请时要把根域名 example.com 单独加入 SAN,例如 -d example.com -d ‘*.example.com’,否则访问裸域仍会报证书名称不匹配。


是。小程序 request 合法域名必须为 HTTPS,证书需受系统信任,不能使用 IP、localhost 或自签证书;TLS 建议 1.2 及以上。中国大陆域名通常还需完成 ICP 备案,并在微信后台配置 request 域名。


公共可信 TLS 证书单次有效期最长 398 天,Let’s Encrypt 免费证书为 90 天。建议用 Certbot 或 acme.sh 自动续期,并在续期后执行 nginx -t 和 reload,避免到期出现 NET::ERR_CERT_DATE_INVALID。


因为 HTTP-01 需要为每个具体域名放置验证文件,而 *.example.com 不是可访问的主机名,CA 无法完成 HTTP 文件校验。泛域名通常使用 DNS-01,在 _acme-challenge.example.com 添加 TXT 记录完成验证。


依次检查 SNI、系统时间、证书 SAN、TLS 版本、CDN 与源站是否都部署新证书。用 openssl s_client -connect 域名:443 -servername 域名 -showcerts 查看返回链,并确认 ssl_certificate 指向 fullchain 而非单站点证书。

内容审核

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