GoDaddy 通配符 SSL 证书实战:子域名 HTTPS 配置、验证与排错
问题背景与根因:为什么要用通配符 SSL 证书
很多业务会把登录、API、静态资源、测试环境分别放在 a.example.com、b.example.com、api.example.com、static.example.com 等同一级子域名下。若每个子域名单独购买单域名证书,证书数量、CSR、验证邮件、续期提醒和 Nginx/Apache/IIS 绑定都会碎片化,最容易出现的故障是 SNI 绑定错证书、证书链缺失、某个子域名忘记续期。通配符 SSL 证书的核心价值是用一张证书覆盖 *.example.com 下同一级子域名,减少证书数量和部署面,但它不是原文所说的无限二级子域名,准确表述是同一级子域名数量不限,且不跨级。
根因在于浏览器和客户端匹配证书时看的是 subjectAltName(SAN),不是只看 CN。通配符只匹配一级标签,*.example.com 可匹配 www.example.com、api.example.com,不匹配 a.b.example.com,也不自动包含主域名 example.com。GoDaddy 通配符订单通常会在 SAN 中包含 example.com 和 *.example.com,但必须以订单和最终证书的 SAN 为准。另一个过时点是有效期:2020-09-01 后公共信任 TLS 证书单张有效期上限为 398 天,Let’s Encrypt 通配符证书为 90 天,购买多年期也需按 CA 规则重签或续签。
上线前先用命令确认当前证书覆盖范围和证书链:
openssl s_client -connect example.com:443 -servername example.com -showcerts
openssl s_client -connect api.example.com:443 -servername api.example.com -showcerts
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null | openssl x509 -noout -subject -issuer -dates -ext subjectAltName
如果输出中 SAN 不含目标子域名,或出现 unable to get local issuer certificate,说明不是换服务器的问题,而是证书覆盖范围或中间证书链问题。通配符证书解决的是同一级子域名批量加密,不解决混合内容、程序写死 http://、CDN 不回源 HTTPS 等问题,这些要单独排查。
覆盖范围与有效期事实修正:无限二级子域名要准确理解
通配符证书的匹配规则可以用一张表说明。*.example.com 匹配 www.example.com、api.example.com、a.example.com;不匹配 a.b.example.com;不匹配 example.com,除非证书 SAN 同时包含 example.com;不匹配 other.com。若业务有多级子域名,例如 a.b.example.com,需要单独申请 *.b.example.com 或把 a.b.example.com 放入 SAN,不能指望一张 *.example.com 全部覆盖。原文的无限二级子域名应修正为同一级子域名数量不限,但层级固定。
| 访问域名 | *.example.com 是否匹配 | 说明 |
|---|---|---|
| www.example.com | 是 | 一级子域名 |
| api.example.com | 是 | 一级子域名 |
| a.b.example.com | 否 | 二级子域名,需 *.b.example.com 或单独 SAN |
| example.com | 看 SAN | 订单通常包含主域名,必须核对 |
| other.com | 否 | 不同主域,不能共用 |
有效期方面,公共信任证书单张最长 398 天,这是 Apple 和 Chrome 等生态推动后的硬限制;Let’s Encrypt 通配符证书有效期 90 天,且通配符必须使用 DNS-01 验证,不能只用 HTTP-01 文件验证。GoDaddy 通配符证书的验证方式通常是 DNS TXT 记录或域名关联邮箱,包括 whois 联系人邮箱、admin@example.com、root@example.com,具体以订单页面为准。CSR 中的 CN 建议写 *.example.com,同时 SAN 必须包含 DNS:*.example.com,DNS:example.com,否则主域名访问会报域名不匹配。
验证 CSR 是否写对:
openssl req -in example.com.csr -noout -text | grep -E 'Subject:|DNS:'
输出应能看到 CN=*.example.com 以及 DNS:*.example.com、DNS:example.com。若只看到 CN 没有 SAN,现代浏览器和 curl 可能报 NET::ERR_CERT_COMMON_NAME_INVALID 或 SSL_ERROR_BAD_CERT_DOMAIN。不要用旧教程只填 CN,SAN 是必须检查项。
完整实操步骤:从 CSR 到签发,私钥绝不外发
第一步在本地或服务器生成私钥和 CSR。私钥必须留在自己手里,只把 CSR 提交给 GoDaddy 或服务商。原文提到把包含 CSR 和私钥的文本文件发给客服,这是高风险做法,应修正为只提交 CSR 部分,私钥文件权限设为 600 并备份。命令如下,OpenSSL 1.1.1 及以上支持 -addext:
openssl req -new -newkey rsa:2048 -nodes -keyout example.com.key -out example.com.csr -subj '/C=CN/ST=Shanghai/L=Shanghai/O=Example/CN=*.example.com' -addext 'subjectAltName=DNS:*.example.com,DNS:example.com'
chmod 600 example.com.key
openssl req -in example.com.csr -noout -text | grep -E 'Subject:|DNS:'
openssl rsa -in example.com.key -check
第二步在 GoDaddy 下单通配符 SSL 证书,提交 CSR。订单中确认域名是 example.com,产品为 Wildcard SSL,SAN 包含 example.com 和 *.example.com。第三步完成域名控制权验证:按订单选择 DNS TXT 或邮箱验证。第四步等待 CA 签发,下载证书包。GoDaddy 通常给主证书 .crt、中间证书 gd_bundle-g2-g1.crt 和私钥 .key,也可能给 PFX。第五步合并 fullchain,Nginx 必须用 fullchain,Apache 用主证书加 SSLCertificateChainFile,IIS 导入包含私钥和证书链的 PFX。
cat example.com.crt gd_bundle-g2-g1.crt > fullchain.crt
openssl x509 -in fullchain.crt -noout -subject -issuer -dates -ext subjectAltName
openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt fullchain.crt
openssl pkcs12 -export -out example.com.pfx -inkey example.com.key -in fullchain.crt
如果证书包里的主证书文件名是随机串,不要紧,看 SAN 和颁发者即可。重装系统或换服务器后证书可继续使用,但私钥丢失无法恢复,只能重签。备份时应同时保存 .key、fullchain.crt、PFX 和订单信息,并限制访问权限。
DNS 验证与 GoDaddy 订单提交:TXT 记录怎么写、怎么查
通配符证书最常见卡点是 DNS 验证。GoDaddy 订单可能要求在域名 DNS 中添加 TXT 记录,主机记录通常为 _dnsauth 或订单指定的随机前缀,记录值为 CA 提供的一长串令牌。若使用第三方 DNS,注意不要多加域名后缀。例如订单要求 _dnsauth.example.com,主机记录填 _dnsauth,类型 TXT,值填订单令牌,TTL 设 300 到 600 秒。若控制台要求完整主机名,则填 _dnsauth.example.com。邮箱验证则检查 whois 联系人邮箱、admin@example.com、root@example.com,必要时在域名邮箱中创建对应别名。
| 记录类型 | 主机记录 | 记录值 | 用途 |
|---|---|---|---|
| TXT | _dnsauth | 订单提供的随机令牌 | 通配符 DNS-01 验证 |
| TXT | _dnsauth.example.com | 订单提供的随机令牌 | 部分 DNS 控制台要求完整名 |
| MX/邮箱 | admin@example.com | 可收信邮箱 | 邮箱验证备选 |
添加后用命令确认传播:
dig TXT _dnsauth.example.com +short
nslookup -type=TXT _dnsauth.example.com
openssl s_client -connect example.com:443 -servername example.com -showcerts
如果 GoDaddy 报 DNS problem: NXDOMAIN looking up TXT for _dnsauth.example.com – check that a DNS record exists for this domain.,先确认记录名没有写成 _dnsauth.example.com.example.com,再等 TTL 过期。若报 DNS problem: SERVFAIL looking up TXT,检查权威 DNS 是否可用、是否存在 CNAME 冲突。验证通过后 CA 才会签发。不要在上线前删除 TXT,部分 CA 续签还会复查。证书签发后核对 SAN 是否包含 example.com 和 *.example.com,再进入配置。
配置示例:Nginx、Apache、IIS 直接可套用
Nginx 配置的关键是 ssl_certificate 指向 fullchain.crt,ssl_certificate_key 指向私钥,server_name 同时写主域名和通配符。TLS 只保留 1.2 和 1.3,避免旧协议。HSTS 建议先小范围测试再加 includeSubDomains。配置后必须 nginx -t 再 reload。
server {
listen 80;
server_name example.com *.example.com;
return 301 https://$host$request_uri;
}
server {
listen 443 ssl;
server_name example.com *.example.com;
ssl_certificate /etc/nginx/ssl/example.com/fullchain.crt;
ssl_certificate_key /etc/nginx/ssl/example.com/example.com.key;
ssl_protocols TLSv1.2 TLSv1.3;
ssl_ciphers 'ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256';
add_header Strict-Transport-Security max-age=31536000 always;
location / { try_files $uri $uri/ =404; }
}
Apache 配置中 SSLCertificateFile 放主证书,SSLCertificateChainFile 放中间证书,私钥单独放。改完执行 apachectl configtest 或 httpd -t,再 reload。IIS 则用 certlm.msc 导入 PFX,站点绑定 https 443,勾选 SNI,主机名填 example.com;通配符绑定可在主机名留空或按站点规划。IIS 6/7 同 IP 同端口只能装一个证书,IIS 8 及 Windows Server 2012 以上支持 SNI 多证书。若多个不同主域共用一台服务器,优先用 SNI 加多证书或多域名 SAN 证书。
<VirtualHost *:443>
ServerName example.com
ServerAlias *.example.com
SSLEngine on
SSLCertificateFile /etc/httpd/ssl/example.com/example.com.crt
SSLCertificateKeyFile /etc/httpd/ssl/example.com/example.com.key
SSLCertificateChainFile /etc/httpd/ssl/example.com/gd_bundle-g2-g1.crt
</VirtualHost>
配置完成后先在本机 curl 检查,不要直接全量切流量。Nginx 常见错误是 ssl_certificate 只配主证书导致 Android 和 Java 客户端不信任;Apache 常见错误是漏配 ChainFile;IIS 常见错误是 PFX 导入时未包含私钥或绑定未勾 SNI。国内部分虚拟主机和 CDN 不支持自定义证书或 SNI,购买前要确认控制台可上传证书和私钥,否则通配符证书也无法落地。
单域名、多域名、通配符证书对比表格
选择证书类型时不要只看价格,要看域名结构和运维成本。单域名 DV 适合一个确定域名;多域名 SAN 适合 example.com、example.net、api.example.com 等不规律组合;通配符适合同一主域下大量一级子域名。OV 和 EV 主要体现组织验证,浏览器对 EV 不再显示绿色地址栏,通配符 OV/EV 产品较少。公共信任证书单张有效期上限 398 天,Let’s Encrypt 为 90 天,GoDaddy 多年期订单也需要按 CA 规则重签。
| 对比项 | 单域名 DV | 多域名 SAN | 通配符证书 |
|---|---|---|---|
| 覆盖范围 | 一个 FQDN | 多个指定域名或子域名 | *.example.com 同一级子域名,通常含主域名 |
| 是否跨级 | 不涉及 | 按 SAN 逐个列出 | 不跨级,a.b.example.com 不匹配 |
| 验证方式 | HTTP-01、DNS-01 或邮箱 | 按域名逐个验证 | 通常 DNS TXT 或邮箱,LE 强制 DNS-01 |
| 有效期 | 最长 398 天 | 最长 398 天 | 最长 398 天,LE 为 90 天 |
| 适用场景 | 单站点 | 多主域或不规律子域 | 同一主域大量一级子域 |
如果只有 www 和主域名,单域名加 SAN 可能更便宜;如果有几十个一级子域名且经常新增,通配符证书的部署和续期成本更低。若子域名跨多个层级,建议拆分为 *.example.com 加 *.sub.example.com,或把关键多级域名加入 SAN。不要为了省一张证书把不同主域硬塞进同一张证书,后续验证和私钥权限都会变复杂。
常见错误排查:真实报错与处理命令
第一类报错是域名不匹配。浏览器显示 NET::ERR_CERT_COMMON_NAME_INVALID 或 Firefox 显示 SSL_ERROR_BAD_CERT_DOMAIN,常见原因是访问 a.b.example.com 但证书只有 *.example.com,或访问 example.com 但 SAN 未包含主域名。处理:用 openssl x509 -in fullchain.crt -noout -text 检查 SAN,必要时重签并加入对应域名。第二类是证书链缺失,curl 报 curl: (60) SSL certificate problem: unable to get local issuer certificate,Android 或 Java 客户端不信任。处理:Nginx 改用 fullchain.crt,Apache 配置 SSLCertificateChainFile,IIS 重新导入含链 PFX。
openssl x509 -in fullchain.crt -noout -subject -issuer -dates -ext subjectAltName
openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt fullchain.crt
curl -I https://example.com
curl -I https://a.example.com
第三类是混合内容。控制台报 Mixed Content: The page at https://… was loaded over HTTPS, but requested an insecure resource http://…,页面变形、图片缺失、登录失败多由此引起。处理:把模板中的 http:// 改为 https:// 或协议相对 URL,检查 CSS、JS、图片、字体和接口地址。第四类是 Nginx 启动报 [emerg] cannot load certificate … PEM_read_bio_X509_AUX() failed,多为路径错误、证书文件不是 PEM 或权限不足,用 nginx -t 和 ls -l 排查。第五类是 Apache 报 AH02032: Hostname example.com provided via SNI and hostname www.example.com provided via SNI have different SSL virtual hosts,说明 SNI 虚拟主机配置冲突,应合并 ServerAlias 或拆分独立 VirtualHost。
第六类是 IIS 报 HTTP 错误 403.4 – 禁止访问:需要使用 SSL,检查站点绑定是否启用了 https 和证书。若证书过期,curl 报 SSL certificate problem: certificate has expired,检查 notAfter 并续签。若 DNS 验证失败,报 DNS problem: NXDOMAIN looking up TXT for _dnsauth.example.com,检查 TXT 主机记录和 TTL。排查顺序建议:先看 SAN 和有效期,再看链,再看 SNI 绑定,最后看页面资源。不要一上来重装服务器,多数问题在证书文件和配置层。
效果验证与上线检查清单
配置完成后按清单验证。第一,检查 443 监听和进程:ss -lntp | grep :443。第二,检查 Nginx 或 Apache 配置语法:nginx -t、apachectl configtest。第三,检查主域名和关键子域名的证书链与 SAN:openssl s_client -connect example.com:443 -servername example.com -showcerts;openssl s_client -connect api.example.com:443 -servername api.example.com -showcerts。第四,用 curl 检查状态码和重定向:curl -I http://example.com 应为 301 到 https,curl -I https://example.com 应为 200 或业务正常状态。第五,浏览器打开控制台确认无 Mixed Content,地址栏显示锁图标。
nginx -t
systemctl reload nginx
apachectl configtest
systemctl reload httpd
ss -lntp | grep :443
curl -I http://example.com
curl -I https://example.com
curl -I https://api.example.com
openssl s_client -connect example.com:443 -servername example.com -tls1_2
openssl s_client -connect example.com:443 -servername example.com -tls1_3
第六,用 SSL Labs 或类似工具跑一次,目标 A 或 A+,重点看证书链是否完整、是否支持 TLS 1.2/1.3、是否有弱加密套件。第七,检查 HSTS 是否只加在 HTTPS 站点,首次上线不要贸然加 includeSubDomains 和 preload,避免旧子域名未上 HTTPS 被锁死。第八,检查证书到期时间并设置提醒,398 天证书建议提前 30 天续签,Let’s Encrypt 90 天证书建议自动续期并监控。第九,备份私钥和 fullchain,权限 600,禁止放入公开仓库。
如果验证时主域名正常但某个子域名报错,优先确认该子域名 DNS 是否解析到当前服务器、SNI 是否命中正确 server 块、CDN 是否回源 HTTPS。若页面能打开但图片缺失,查浏览器控制台和页面源码中的 http:// 资源。全部通过后再切流量,保留回滚配置。
常见问题
通配符证书能保护多少个子域名,真的无限二级子域名吗?
准确说法是同一级子域名数量不限,例如 *.example.com 可覆盖 www、api、static、a 等一级子域名,但不覆盖 a.b.example.com 这种二级子域名,也不自动覆盖 example.com,除非证书 SAN 同时包含主域名。购买时务必核对订单 SAN,不要按无限二级子域名的旧说法规划多级业务。
更换服务器或重装系统后证书还能继续用吗?
可以,证书和私钥不绑定服务器。把 .key、fullchain.crt 和 PFX 备份好,在新服务器重新配置即可。但私钥丢失无法找回,只能重新签发;重装前先备份 /etc/nginx/ssl 或 IIS 证书导出文件,并限制私钥权限为 600。
GoDaddy 通配符证书有效期多久,为什么不是多年?
公共信任 TLS 证书单张有效期上限为 398 天,这是 CA/B Forum 和浏览器生态的硬限制。GoDaddy 多年期订单通常通过续签或重签实现,不是一张证书连续多年有效。Let’s Encrypt 通配符证书有效期为 90 天,必须用 DNS-01 验证并配置自动续期。
为什么安装后浏览器仍提示不安全或页面变形?
常见原因有证书 SAN 不含当前域名、证书链缺失、SNI 绑定错证书、页面加载 http:// 资源导致 Mixed Content、程序写死 http 接口。先用 openssl s_client 检查 SAN 和链,再看浏览器控制台 Mixed Content 报错,逐项替换资源地址。
通配符证书必须用 DNS 验证吗?
Let’s Encrypt 通配符证书强制使用 DNS-01 验证,不能只用 HTTP-01 文件验证。GoDaddy 通配符订单通常要求 DNS TXT 记录或域名关联邮箱验证,包括 whois 邮箱、admin@example.com、root@example.com。以订单页面提示为准,TXT 记录添加后等 TTL 生效再点验证。
证书会被吊销吗,吊销后能退款吗?
正常情况下不会吊销,但私钥泄露、域名控制权丢失、网站存在违法违规内容、CA 错误签发或违反 CA 协议时可能被吊销。吊销后通常不予退款。私钥不要发给客服或上传公开仓库,只提交 CSR,并做好备份和权限控制。