跳到主要内容
HTTPS小程序证书

通配符 SSL 证书实战:DNS-01 签发、Nginx/Apache 安装与 HTTPS 加锁排错

通配符 SSL 证书实战:DNS-01 签发、Nginx/Apache 安装与 HTTPS 加锁排错 — 通配符 SSL 证书实战:DNS-01 签发、Nginx/Apache 安装与 HTTPS 加锁排错

很多站长把通配符 SSL 证书和地址栏加绿锁混为一谈。通配符证书的核心是 SAN 中的 DNS 名称 *.example.com,它只匹配同一级子域:a.example.com 可以,a.b.example.com 不行,example.com 本身也不在匹配范围内,除非签发时把根域作为独立 SAN 一起写入。现代浏览器早已取消 EV 证书显示公司名称的绿色地址栏,Chrome、Edge、Firefox 只显示锁形或站点信息图标,锁只代表 TLS 连接已建立且证书链通过校验,不代表企业实名展示。另一个常见根因是有效期基线变化:CA/B Forum 要求公开信任 TLS 证书最长有效期 398 天,Let’s Encrypt 通配符证书有效期 90 天,必须自动续期。部署后仍报错通常来自证书链不完整、SAN 不匹配、私钥与证书不配对、混合内容或 TLS 版本过旧。可用 openssl x509 -in fullchain.pem -noout -subject -dates -ext subjectAltName 先核对证书本身,再查服务端配置。通配符签发必须使用 DNS-01,因为 CA 需要验证 _acme-challenge.example.com 的 TXT 记录控制权,HTTP-01 无法覆盖通配符。

签发前准备:域名、DNS API、CSR 与有效期基线

签发前先确定覆盖范围:需要 example.com 和 *.example.com 就同时写入 SAN,不能只写通配符。准备一个具备 DNS 编辑权限的 API Token,例如 Cloudflare 需要 Zone.DNS 编辑权限,并在环境变量中只暴露最小权限。先检查解析是否生效:dig +short TXT _acme-challenge.example.com,返回为空说明尚未添加记录,返回多条 TXT 时 acme.sh 会自动处理。若走商业 CA,可先生成 CSR:openssl req -new -newkey rsa:2048 -nodes -keyout example.com.key -out example.com.csr -subj ‘/CN=*.example.com’ -addext ‘subjectAltName=DNS:*.example.com,DNS:example.com’,其中 -addext 需要 OpenSSL 1.1.1 及以上。CSR 只包含公钥和主题信息,私钥 example.com.key 必须保存在服务器并限制权限 chmod 600。安装 acme.sh 客户端:curl https://get.acme.sh | sh -s email=ops@example.com,然后执行 source ~/.bashrc 和 acme.sh –version 确认版本。有效期基线要记牢:商业 DV、OV、EV 公开信任证书最长 398 天,Let’s Encrypt 为 90 天,因此不要手工一年一换,必须配置自动续期和续期后 reload。DNS API 的 Token 不要写入仓库,建议放在 /root/.acme.sh/account.conf 并 chmod 600。

完整实操:用 acme.sh 通过 DNS-01 签发通配符证书

以 Cloudflare DNS 为例,先导出最小权限变量:export CF_Token=’你的Token’,export CF_Account_ID=’你的AccountID’。签发命令必须同时写根域和通配符,否则 example.com 访问会报 SAN 不匹配:acme.sh –issue –dns dns_cf -d example.com -d ‘*.example.com’ –keylength ec-256。执行后 acme.sh 会自动创建 _acme-challenge.example.com 的 TXT 记录,等待传播并回调 CA;若使用阿里云 DNS,把 –dns dns_cf 换成 –dns dns_ali 并设置 Ali_Key、Ali_Secret。签发成功后可看到证书目录,通常为 /root/.acme.sh/example.com_ecc/。接着安装到 Nginx 路径并绑定续期 reload: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 ‘nginx -t && systemctl reload nginx’。注意 fullchain 必须包含服务器证书和中间证书,不能只拷贝域名证书。检查自动任务:crontab -l | grep acme.sh,正常应看到每日检查任务;也可执行 acme.sh –list 查看续期时间。测试续期用 acme.sh –renew -d example.com –ecc –force,然后重新执行 openssl x509 -in /etc/nginx/ssl/example.com.fullchain.pem -noout -dates 确认 notAfter 已更新。Let’s Encrypt 90 天有效期下,建议提前 30 天续期并保留 reload 日志。

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

把 HTTP 强制跳转 HTTPS,并在 443 上同时匹配根域和通配符。Nginx 1.25.1 及以上使用 http2 on; 旧版可写 listen 443 ssl http2;。示例配置如下:

server {
 listen 80;
 server_name example.com *.example.com;
 return 301 https://$host$request_uri;
}
server {
 listen 443 ssl;
 http2 on;
 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:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305';
 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;
 resolver 223.5.5.5 1.1.1.1 valid=300s;
 add_header Strict-Transport-Security 'max-age=31536000; includeSubDomains' always;
 root /var/www/html;
 location / { try_files $uri $uri/ =404; }
}

执行 nginx -t && systemctl reload nginx 使配置生效。若站点有混合内容,浏览器仍可能显示不安全,需要在页面中把 http:// 资源改为 https:// 或使用 Content-Security-Policy: upgrade-insecure-requests。HSTS 的 includeSubDomains 会覆盖所有子域,启用前确认所有子域都能 HTTPS,否则不要加该参数。OCSP Stapling 依赖 resolver 和完整证书链,若证书链缺中间证书,ssl_stapling 会报错但不一定阻断访问,仍应修复 fullchain。

Apache 配置示例与证书链合并

Apache 2.4 建议把 fullchain 直接给 SSLCertificateFile,SSLCertificateKeyFile 指向私钥。Debian/Ubuntu 先执行 a2enmod ssl headers,CentOS/RHEL 确认 mod_ssl 已启用。虚拟主机示例:

<VirtualHost *:80>
 ServerName example.com
 ServerAlias *.example.com
 Redirect permanent / https://example.com/
</VirtualHost>
<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
 SSLCipherSuite HIGH:!aNULL:!MD5:!3DES
 SSLHonorCipherOrder off
 Header always set Strict-Transport-Security 'max-age=31536000'
</VirtualHost>

保存后执行 apachectl configtest 或 httpd -t,返回 Syntax OK 再执行 systemctl reload httpd 或 systemctl reload apache2。若商业 CA 给的是 cert.pem、ca-bundle.pem 两个文件,需要合并:cat cert.pem ca-bundle.pem > example.com.fullchain.pem,顺序不能反,服务器证书在前、中间证书在后。Apache 2.4.8 之前可用 SSLCertificateChainFile 指向中间证书,新版本优先 fullchain。私钥权限设为 chmod 600,属主为 root。若使用 SNI 多站点,每个 VirtualHost 都要配置对应证书,不能只给默认站点配置通配符证书。

证书类型与部署方式对比表

通配符证书不是越贵越好,而是看验证级别、有效期和自动化能力。DV 通配符只验证域名控制权,适合个人站和内部子域;OV 通配符增加组织验证,适合企业官网;EV 通配符虽然验证更严,但现代浏览器不再展示绿色公司名称,不能把加绿锁当作 EV 卖点。Let’s Encrypt 通配符免费、90 天、适合自动化;商业 CA 最长 398 天,减少续期频率但必须监控到期。对比表如下:

方案 验证方式 典型有效期 浏览器显示 适用场景
DV 通配符 Let’s Encrypt DNS-01 TXT 90 天 锁标志,无公司名 个人站、自动化子域
DV 通配符商业 CA DNS-01 或 CNAME 委托 最长 398 天 锁标志,无公司名 企业多子域、减少续期
OV 通配符 组织验证加 DNS 控制权 最长 398 天 锁标志,不显示公司 企业官网、合规采购
EV 通配符 扩展验证加 DNS 控制权 最长 398 天 锁标志,不再显示绿色公司 高信任场景但 UI 无差异
多域名 SAN 证书 每个域名分别验证 最长 398 天 锁标志 域名少且跨主域
CDN 托管证书 平台自动验证 90 天或 398 天 锁标志 云上快速启用 HTTPS

选择时还要看私钥部署位置:同一张通配符证书可安装在多台服务器,但私钥复制越多风险越大,建议用配置管理分发并限制读取权限。

常见错误排查:真实报错与修复命令

浏览器报 NET::ERR_CERT_COMMON_NAME_INVALID 时,先查 SAN 是否包含当前主机名:openssl x509 -in /etc/nginx/ssl/example.com.fullchain.pem -noout -ext subjectAltName。若只看到 *.example.com 而访问 example.com,需要重新签发并加 -d example.com。报 NET::ERR_CERT_AUTHORITY_INVALID 多为证书链不完整,执行 openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt /etc/nginx/ssl/example.com.fullchain.pem,若返回 unable to get local issuer certificate,说明缺中间证书,改用 fullchain。报 SSL_ERROR_NO_CYPHER_OVERLAP 时检查 ssl_protocols 是否禁用了客户端支持的 TLS 版本,用 openssl s_client -connect example.com:443 -servername example.com -tls1_2 测试。acme.sh 报 DNS problem: NXDOMAIN looking up TXT for _acme-challenge.example.com,先执行 dig +short TXT _acme-challenge.example.com,确认 API Token 有 DNS 编辑权限并等待 TTL 传播。Nginx 报 cannot load certificate PEM_read_bio_X509 时检查文件路径和格式,执行 file fullchain.pem 与 head -n 1 fullchain.pem。Apache 报 AH02565 Certificate and private key do not match 时核对模数:openssl x509 -noout -modulus -in cert.pem | openssl md5 与 openssl rsa -noout -modulus -in key.pem | openssl md5 必须一致。修改后统一执行 nginx -t 或 apachectl configtest,再 reload,不要直接 restart 生产服务。

效果验证:openssl、curl 与浏览器检查

部署后先验证证书链和 SAN:echo | openssl s_client -connect example.com:443 -servername example.com -showcerts 2>/dev/null | openssl x509 -noout -subject -issuer -dates -ext subjectAltName。再用子域验证通配符匹配:echo | openssl s_client -connect example.com:443 -servername a.example.com 2>/dev/null | openssl x509 -noout -subject。HTTP 跳转检查:curl -I http://example.com,应返回 301 且 Location 为 https://example.com/。HTTPS 状态与证书校验:curl -sS -o /dev/null -w ‘%{http_code} %{ssl_verify_result}’ https://example.com,ssl_verify_result 为 0 表示证书校验通过。HSTS 检查:curl -sI https://example.com | grep -i ‘strict-transport-security’。TLS 版本检查可分别执行 openssl s_client -connect example.com:443 -servername example.com -tls1_2 和 -tls1_3,确认握手成功且没有旧协议。浏览器端打开开发者工具 Security 面板,确认 Certificate 显示有效、无混合内容警告。生产环境建议加 testssl.sh –fast example.com 或 ssllabs 扫描,重点看证书链、协议、 cipher 和到期时间。最后用 acme.sh –list 和 openssl x509 -noout -enddate 双重确认续期任务与到期日。

常见问题

通配符证书能覆盖 example.com 和 a.b.example.com 吗?

不能。*.example.com 只匹配一级子域,例如 a.example.com;example.com 需要单独写入 SAN,a.b.example.com 属于二级子域,也不匹配。签发时使用 -d example.com -d ‘*.example.com’,并用 openssl x509 -noout -ext subjectAltName 核对。

为什么地址栏不再显示绿色公司名称?

主流浏览器已移除 EV 证书的公司名称展示,锁标志只表示 TLS 连接和证书链有效,不再区分 DV、OV、EV 的绿色地址栏。加绿锁应理解为启用 HTTPS,而不是显示企业实名。

Let’s Encrypt 通配符证书有效期多久?

90 天。商业公开信任证书最长 398 天。两者都必须自动续期,Let’s Encrypt 建议提前 30 天续期,并在续期后执行 nginx -t && systemctl reload nginx 或 apachectl configtest 后 reload。

一张通配符证书能安装在多台服务器吗?

技术上可以,同一证书和私钥可部署到多台服务器,但私钥副本越多泄露风险越大。商业 CA 许可条款可能限制服务器数量,部署前确认授权;技术上建议用配置管理分发并设置 chmod 600。

申请时报 DNS problem NXDOMAIN 怎么办?

先执行 dig +short TXT _acme-challenge.example.com 检查 TXT 是否发布,确认 DNS API Token 有编辑权限、没有写错主域、没有代理开关干扰。等待 TTL 传播后重试,仍失败可加 –debug 查看 acme.sh 创建的记录名。

部署后 Chrome 报 ERR_CERT_AUTHORITY_INVALID 怎么排查?

通常是证书链不完整。执行 openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt fullchain.pem,若报 unable to get local issuer certificate,把中间证书合并到 fullchain,确保服务器证书在前、中间证书在后,再 reload。

内容审核

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