网站 HTTPS CA 证书配置实战:通配符 SSL、泛解析与全站加密
问题背景与根因:全站 HTTPS 不只是装一张证书
很多站点把 HTTPS 理解为“买一张 CA 证书装到 Nginx”,实际故障往往出在域名覆盖、证书链、DNS 泛解析和续期。所谓 HTTP 加密,实际是 HTTP over TLS,即 HTTPS;TLS 负责传输加密和身份认证,HTTP 报文本身没有独立加密层。HTTP 明文会被代理篡改,浏览器对登录、支付、表单页面标记不安全;小程序、公众号网页授权、APP 接口通常要求可信 CA 签发的 HTTPS 证书,自签名证书会被拒绝。
根因有三类:一是证书只覆盖申请时写入的域名,*.example.com 只匹配一级子域,不覆盖 example.com,也不覆盖 a.b.example.com;二是通配符证书必须用 DNS-01 验证,HTTP-01 无法签发通配符;三是公开信任 TLS 证书最长有效期已缩短到 398 天,Let’s Encrypt 为 90 天,手工续期必然过期。排查先用 curl -I http://example.com 看是否 301,再用 openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 看证书链和 SAN。若返回 SSL_ERROR_BAD_CERT_DOMAIN,优先检查 SAN 是否包含当前访问域名,而不是先改加密套件。
证书选型与泛解析域名规划
先规划域名,再申请证书。假设主域 example.com,需要 www.example.com、api.example.com、static.example.com 以及任意新增子域,DNS 侧配置泛解析:*.example.com A 203.0.113.10,主域单独一条 example.com A 203.0.113.10。证书侧申请 -d example.com -d '*.example.com',这样主域和一级子域都覆盖;若还要 *.api.example.com,需再加一张或多张通配符 SAN。注意 *.example.com 不覆盖 a.b.example.com,也不自动覆盖裸域。
申请前用 dig +short A www.example.com、dig +short TXT _acme-challenge.example.com、dig CAA example.com 检查解析和 CAA 是否允许 Let’s Encrypt 或指定 CA。泛解析只解决 DNS 指向,不等于证书覆盖;证书只解决身份认证,不等于 HTTP 自动跳转。生产环境建议主域和泛域名放同一张 SAN 证书,减少 SNI 选错证书的概率。若使用 CDN 或负载均衡,要确认证书部署在边缘还是源站,并保证回源域名也在 SAN 内。
完整实操:acme.sh 签发通配符证书
以 acme.sh 和 Cloudflare DNS API 为例,签发 Let’s Encrypt 通配符证书。安装并设置默认 CA:curl https://get.acme.sh | sh -s email=ops@example.com,source ~/.bashrc,acme.sh --set-default-ca --server letsencrypt。导出只允许编辑 DNS 的 API Token:export CF_Token='...'、export CF_Account_ID='...'。签发命令:acme.sh --issue --dns dns_cf -d example.com -d '*.example.com' --keylength ec-256。
DNS-01 会自动写入 _acme-challenge.example.com TXT 记录,等待传播后完成验证;若用手动 DNS,加 --dns 和 --yes-I-know-dns-manual-mode-enough-go-ahead-please,按提示添加 TXT 后执行 --renew。签发后安装到固定路径:acme.sh --install-cert -d example.com --ecc --key-file /etc/nginx/ssl/example.com.key --fullchain-file /etc/nginx/ssl/example.com.fullchain.pem --reloadcmd 'systemctl reload nginx'。权限设为 chmod 600,私钥不要放 Web 根目录。Let’s Encrypt 有效期 90 天,acme.sh 默认自动续期;公开 CA 证书最长 398 天,不要照旧教程配置两年证书。
Nginx 全站 HTTPS 配置示例
Nginx 要同时处理 80 跳转和 443 证书选择。示例:server { listen 80; server_name example.com *.example.com; return 301 https://$host$request_uri; }。443 配置:server { listen 443 ssl http2; server_name example.com *.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'; ssl_prefer_server_ciphers off; ssl_session_cache shared:SSL:10m; add_header Strict-Transport-Security 'max-age=31536000; includeSubDomains' always; location / { root /var/www/html; index index.html; } }。
server_name 中的 *.example.com 只匹配一级子域,和证书通配符规则一致;新增 a.b.example.com 要单独 server 块和对应证书。改完执行 nginx -t,再 systemctl reload nginx。若页面仍提示混合内容,检查 HTML 中 http:// 的图片、脚本、接口,改用相对协议或 HTTPS,必要时加 Content-Security-Policy: upgrade-insecure-requests。HSTS 先短 max-age 灰度,确认全站 HTTPS 后再加 includeSubDomains。
Apache、负载均衡与小程序 APP 接入要点
Apache 示例:<VirtualHost *:443> ServerName example.com ServerAlias *.example.com SSLEngine on SSLCertificateFile /etc/httpd/ssl/example.com.fullchain.pem SSLCertificateKeyFile /etc/httpd/ssl/example.com.key SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1 Header always set Strict-Transport-Security 'max-age=31536000' </VirtualHost>,执行 apachectl configtest 后 reload。注意 SSLCertificateFile 必须指向包含中间证书的 fullchain,SSLCertificateKeyFile 指向私钥;若只给叶证书,部分安卓和 Java 客户端会报 unable to find valid certification path。
云负载均衡要上传 fullchain.pem 和私钥,监听 443 并开启 SNI;后端可继续 HTTP,但安全组只允许 LB 访问。小程序、公众号网页和 APP 接口要求可信 CA、域名与证书 SAN 一致、TLS 1.2 及以上;不要用自签名证书,也不要在 APP 中关闭证书校验。若 APP 做证书固定,续期换证书会导致旧版本失败,需预留双证书或版本兼容。CDN 场景要确认回源协议、证书部署在 CDN 边缘还是源站,避免边缘正常但源站证书过期。
对比表格:证书类型、验证方式与有效期
下表用于选型,不把泛解析和通配符证书混为一谈。泛解析是 DNS 记录,通配符证书是 TLS 证书的 SAN 能力。
| 类型 | 覆盖范围 | 验证方式 | 有效期与续期 | 适用场景 |
|---|---|---|---|---|
| 单域名 DV | example.com | HTTP-01 或 DNS-01 | 公开 CA 最长 398 天;Let’s Encrypt 90 天 | 单站、测试转生产 |
| 多域名 SAN | example.com、www、api 等固定列表 | HTTP-01 或 DNS-01 | 同上,需自动续期 | 子域数量固定 |
| 通配符 DV | *.example.com,可加主域 SAN | 必须 DNS-01 | 同上,TXT 记录需可自动写入 | 子域多、HTTPS 泛解析 |
| OV 证书 | 指定域名,含组织信息 | 组织验证加域名验证 | 同上 | 企业门户、合规展示 |
| 自签名证书 | 任意域名 | 无公共 CA 验证 | 自定义 | 仅内网测试,不可用于小程序 |
关键限制:*.example.com 只覆盖一级子域;*.api.example.com 要单独申请;HTTP-01 不能签发通配符;公开 CA 证书有效期上限 398 天,Let’s Encrypt 为 90 天。若业务需要多级泛域名,应拆成多张证书或使用支持多通配符 SAN 的付费证书,并在 Nginx 中按 server_name 精确匹配。
常见错误排查:真实报错与修复命令
1. 域名不匹配。浏览器报 NET::ERR_CERT_COMMON_NAME_INVALID,Firefox 报 SSL_ERROR_BAD_CERT_DOMAIN。执行 openssl x509 -noout -ext subjectAltName -in cert.pem 检查 SAN,确认访问域名在列表内;通配符不覆盖裸域和多级子域。
- 代购 SSL 证书 · DigiCert / GeoTrust / RapidSSL 单域名与通配符
- SSL证书申请 · SSL证书购买 · SSL证书安装配置
- SSL域名证书申请 · 小程序证书 · 国外SSL证书
2. 证书链不完整。curl: (60) SSL certificate problem: unable to get local issuer certificate。Nginx 的 ssl_certificate 应指向 fullchain.pem,而不是只含叶证书的 cert.pem;可用 openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 查看是否返回中间证书。
3. 私钥与证书不匹配。Nginx 报 SSL_CTX_use_PrivateKey_file(...) failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch)。分别执行 openssl x509 -noout -modulus -in cert.pem | openssl md5 和 openssl rsa -noout -modulus -in key.pem | openssl md5,两个值必须一致。
4. 443 未配置证书。Nginx 报 no ssl_certificate is defined for the listen ... ssl directive。在对应 server 块补 ssl_certificate 与 ssl_certificate_key,再执行 nginx -t。
5. ACME 验证失败。报 Verify error:Invalid response from http://.../.well-known/acme-challenge/...: 404 时,检查 80 端口、重定向和 Web 根目录;通配符改用 DNS-01。报 DNS problem: NXDOMAIN looking up TXT for _acme-challenge.example.com 时,用 dig +short TXT _acme-challenge.example.com 等待传播。报 too many certificates already issued for exact set of domains 时,先用 --server letsencrypt_test 做测试,避免触发正式环境速率限制。
效果验证与续期监控
配置完成后先验证跳转和证书链:curl -I http://example.com 应返回 301 到 https;curl -I https://example.com 应返回 200 且包含 strict-transport-security。再用 curl -sS -o /dev/null -w '%{http_code} %{ssl_verify_result}n' https://example.com,期望输出 200 0,其中 0 表示证书校验通过。
检查证书详情:openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | openssl x509 -noout -subject -issuer -dates -ext subjectAltName。批量检查子域:for h in example.com www.example.com api.example.com; do echo | openssl s_client -connect $h:443 -servername $h 2>/dev/null | openssl x509 -noout -subject -dates; done。剩余有效期可用 openssl x509 -checkend 2592000 -noout -in example.com.fullchain.pem,返回 0 表示 30 天内不过期。
续期监控执行 acme.sh --list 查看下次续期时间,crontab -l | grep acme 确认定时任务存在。生产环境建议加到期告警:证书剩余 30 天、14 天、7 天分别通知;每季度用 SSL Labs 或 openssl s_client 抽查 TLS 1.2/1.3、证书链和 HSTS。若使用 CDN 或负载均衡,边缘和源站都要检查,避免只验证了其中一层。
常见问题
不能。*.example.com 只匹配一级子域,如 www.example.com,不匹配裸域 example.com,也不匹配 a.b.example.com。需要把主域加入同一张证书的 SAN,或单独签发主域证书。
不是。泛解析是 DNS 的 *.example.com A 记录,负责把子域指向服务器;通配符证书是 TLS 证书的 *.example.com SAN,负责身份认证。两者要分别配置,缺一不可。
90 天,建议在到期前 30 天自动续期。公开信任 TLS 证书最长有效期为 398 天,旧教程中的两年证书已不符合规范。
HTTP-01 只能验证具体主机名,无法证明申请者控制整个通配符域;DNS-01 通过 _acme-challenge TXT 记录验证域名控制权,因此通配符必须走 DNS-01。
浏览器可能正常,但 curl、Java、部分安卓会报 unable to get local issuer certificate 或 unable to find valid certification path。Nginx 的 ssl_certificate 应指向包含中间证书的 fullchain.pem。
通常不要求。小程序要求可信 CA 签发、域名与证书一致、TLS 1.2 及以上;DV 证书也可用。关键是不要自签名、不要关闭证书校验。