跳到主要内容
ssl证书按装

网站 HTTPS CA 证书配置实战:通配符 SSL、泛解析与全站加密

网站 HTTPS CA 证书配置实战:通配符 SSL、泛解析与全站加密 — 网站 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,确认访问域名在列表内;通配符不覆盖裸域和多级子域。

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 证书也可用。关键是不要自签名、不要关闭证书校验。

内容审核

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