跳到主要内容
HTTPS安装配置

SSL证书申请续费安装与HTTPS通配符多域名防劫持实战指南

SSL证书申请续费安装与HTTPS通配符多域名防劫持实战指南 — SSL证书申请续费安装与HTTPS通配符多域名防劫持实战指南

问题背景与根因:证书申请、续费、安装为何频繁失败

SSL/TLS 证书不是买完就结束,它包含域名验证、CSR/私钥、证书链、服务器安装、续费和监控五个环节。原文把有效期写成一年的做法已经过时:公共 CA 签发的 TLS 服务器证书当前最长有效期为 398 天,Let’s Encrypt 免费证书有效期为 90 天,续费必须自动化。最常见的根因有:一是域名验证失败,通配符证书必须走 DNS-01,需要在 _acme-challenge.example.com 写入 TXT,DNS 未生效或 API Token 权限不足就会失败;二是证书链不完整,Nginx 的 ssl_certificate 必须指向 fullchain.pem,否则部分 Android、Java 客户端报 unable to get local issuer certificate;三是私钥与证书不匹配,常见于复制错文件或续费后只替换了证书没替换 key;四是对通配符覆盖范围误解,*.example.com 只匹配一级子域,不匹配 example.com,也不匹配 a.b.example.com;五是续费后没有 reload,旧进程仍加载旧证书;六是 HSTS 配置过早,includeSubDomains 打开后某个子域没有 HTTPS 会导致整站无法访问。

排查时先用 openssl s_client 看实际链和 SAN:

openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | openssl x509 -noout -subject -issuer -dates -ext subjectAltName

如果输出的 subjectAltName 不包含当前访问域名,问题在证书申请阶段;如果包含但浏览器仍报错,优先查 fullchain、私钥匹配和 SNI 配置。多域名服务器证书使用 SAN 扩展承载多个域名,部署时每个域名都要在 SAN 列表中,不能只写 CN。防劫持方面,HTTPS 只能防传输篡改,不能单独防 DNS 劫持、BGP 劫持和错误签发,需要配合 HSTS、CAA、DNSSEC 与证书透明日志监控。

申请前准备:域名、CSR、DNS-01 与多域名 SAN 规划

先列清单:主域名 example.com、需要覆盖的一级子域 api.example.com、是否要通配符 *.example.com、是否有多级子域 a.b.example.com。通配符证书只覆盖一级,多级子域要单独写入 SAN 或另申请。若使用 ACME 自动签发,一般不需要手工 CSR;若企业 CA 或云厂商要求 CSR,可用以下命令生成 RSA 2048 私钥和 CSR:

openssl req -new -newkey rsa:2048 -nodes -keyout example.com.key -out example.com.csr -subj '/CN=example.com/O=Example/C=CN'

检查 CSR 的 SAN 和密钥长度:

openssl req -in example.com.csr -noout -text | grep -E 'Subject:|DNS:|Public-Key'

通配符必须用 DNS-01 验证。以 Cloudflare 为例,API Token 需要 Zone.DNS 编辑权限,先导出环境变量,再检查 TXT 是否生效:

export CF_Token='你的Token'
export CF_Account_ID='你的AccountID'
dig TXT _acme-challenge.example.com +short

DNS-01 的 TXT 名称是 _acme-challenge.example.com,通配符和裸域同时申请时会出现多个 TXT 值,必须全部保留,等待 TTL 生效。多域名证书规划时把裸域、www、api、通配符都写进 -d 参数,例如 -d example.com -d ‘*.example.com’ -d api.example.com。注意通配符不自动包含裸域,所以裸域要单独加。私钥权限设为 600,属主为 root 或运行 Web 服务的用户,避免被普通用户读取。若服务器在负载均衡后面,确认 80/443 回源和 SNI 透传,否则 HTTP-01 和 TLS 握手都会异常。申请前还要检查域名是否被 CAA 记录限制,dig CAA example.com 若只允许某 CA,换 CA 会失败。

完整实操:acme.sh 申请通配符与多域名证书并自动续费

以下命令可直接在 root 或具备 sudo 的机器执行。先安装 acme.sh 并创建证书目录:

curl https://get.acme.sh | sh -s email=admin@example.com
source ~/.bashrc
mkdir -p /etc/nginx/ssl

配置 Cloudflare DNS API 后申请证书。通配符必须用 dns_cf,多域名 SAN 直接追加 -d。首次建议加 –staging 测试,避免触发正式环境速率限制:

export CF_Token='你的Token'
export CF_Account_ID='你的AccountID'
~/.acme.sh/acme.sh --issue --dns dns_cf -d example.com -d '*.example.com' -d api.example.com --keylength ec-256 --staging

测试通过后去掉 –staging 重新签发。安装证书时用 fullchain,不要只装域名证书:

~/.acme.sh/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 -s reload'

acme.sh 安装后会写入 cron 自动续期,Let’s Encrypt 证书 90 天有效,默认在到期前约 30 天续期。检查任务和证书列表:

crontab -l | grep acme.sh
~/.acme.sh/acme.sh --list

需要手动验证续期流程时可执行 –renew –force,但不要频繁 force,正式环境有速率限制。续期成功后 –reloadcmd 会自动 reload Nginx;如果使用 Apache 改成 ‘systemctl reload httpd’,使用 Tomcat 则要重新导出 PKCS12 并重启 Connector。多域名服务器证书续期时 SAN 列表必须保持一致,新增域名要重新 –issue 并更新安装路径。证书文件权限建议 chmod 600 key,fullchain 可 644。若使用 ECDSA 证书,Nginx 和客户端需支持 TLS 1.2/1.3;老客户端多时可用 RSA 2048 或双证书。最后用 –install-cert 的 –reloadcmd 做一次 nginx -t 前置检查更稳妥。

安装配置示例:Nginx、Apache、Tomcat 与证书链

Nginx 最小可用配置如下,80 端口强制跳转,443 使用 fullchain 和私钥,TLS 只开 1.2/1.3。server_name 同时写裸域和通配符,因为 *.example.com 不匹配 example.com:

server {
 listen 80;
 server_name example.com *.example.com;
 return 301 https://$host$request_uri;
}
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 HIGH:!aNULL:!MD5;
 ssl_session_cache shared:SSL:10m;
 add_header Strict-Transport-Security 'max-age=31536000; includeSubDomains' always;
}

执行 nginx -t 后再 reload。HSTS 的 includeSubDomains 必须确认所有子域都已 HTTPS,否则不要加。Apache 需要 mod_ssl 和 mod_headers:

<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
 Header always set Strict-Transport-Security 'max-age=31536000; includeSubDomains'
</VirtualHost>

执行 apachectl configtest 后 systemctl reload httpd。Tomcat 不直接读 PEM,需要把 fullchain 和 key 导出为 PKCS12:

openssl pkcs12 -export -out example.com.p12 -inkey example.com.key -in example.com.fullchain.pem -name tomcat -passout pass:'***'

Connector 示例:

<Connector port='8443' protocol='org.apache.coyote.http11.Http11NioProtocol' SSLEnabled='true' scheme='https' secure='true' keystoreFile='/opt/tomcat/conf/example.com.p12' keystoreType='PKCS12' keystorePass='***' />

三个服务的共同点是证书文件必须包含中间证书,私钥不能带密码或要在服务配置中提供密码。多域名服务器证书只需一份 fullchain 即可覆盖 SAN 中的域名,但每个域名都要解析到该服务并正确发送 SNI。若前面有 CDN 或负载均衡,证书要同步上传到边缘节点,否则回源证书正确但用户仍看到旧证书。

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

原文把 EV 描述为浏览器地址栏显示公司名称,这一点已过时:主流浏览器已取消 EV 绿色公司名展示,EV 的价值主要在合规审核和证书策略,不再靠地址栏标识。当前选型先看验证级别,再看覆盖范围。公共 CA 的 TLS 服务器证书最长有效期 398 天,Let’s Encrypt 为 90 天,任何方案都必须自动续费。

类型 验证方式 签发时长 浏览器表现 适用场景 有效期
DV DNS/HTTP 域名控制 几分钟 锁图标 博客、API、内部测试 最长 398 天,LE 90 天
OV 企业资料审核 1-5 工作日 锁图标,需点开看企业信息 企业官网、SaaS 最长 398 天
EV 严格企业审核 3-7 工作日 主流浏览器不再显示绿色公司名 金融、电商合规 最长 398 天
覆盖类型 示例 覆盖范围 注意
单域名 api.example.com 仅一个 FQDN 换域名需重签
多域名 SAN example.com、api.example.com、shop.example.net 多个指定域名 域名数量受 CA 限制,续费保持 SAN 一致
通配符 *.example.com 仅一级子域 不覆盖 example.com,不覆盖 a.b.example.com

部署方案上,Nginx/Apache 适合自建机房,Tomcat 需 PKCS12,云负载均衡要上传 fullchain 和 key 并开启 SNI。多域名服务器证书适合一台入口承载多个业务域名;通配符适合子域数量多且都是一级的场景,但私钥共享范围大,泄露影响面大。个人站点选 DV 即可,企业门户选 OV,金融电商按合规选 EV,但不要期待 EV 带来绿色地址栏。

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

下面报错在 Nginx/Apache/Tomcat 和 ACME 续费中很常见。先看服务日志和证书内容,不要盲目重签。

nginx: [emerg] cannot load certificate '/etc/nginx/ssl/example.com.fullchain.pem': PEM_read_bio_X509_AUX() failed (SSL: error:... No such file or directory)

原因:路径错、文件为空、权限不足或证书不是 PEM。修复:ls -l /etc/nginx/ssl,确认 fullchain 首行是 —–BEGIN CERTIFICATE—–,执行 nginx -t。

NET::ERR_CERT_COMMON_NAME_INVALID 或 SSL_ERROR_BAD_CERT_DOMAIN

原因:访问域名不在 SAN,或通配符不覆盖多级子域。修复:openssl x509 -noout -ext subjectAltName -in fullchain.pem,把缺失域名加入 -d 重新签发。

curl: (60) SSL certificate problem: unable to get local issuer certificate

原因:缺中间证书。Nginx 的 ssl_certificate 必须用 fullchain.pem,Apache 的 SSLCertificateFile 也要指向 fullchain。用 openssl verify -CAfile chain.pem cert.pem 验证。

nginx: [emerg] SSL_CTX_use_PrivateKey() failed (SSL: error:... key values mismatch)

原因:私钥与证书不匹配。对比模数:openssl x509 -noout -modulus -in fullchain.pem | openssl md5 与 openssl rsa -noout -modulus -in example.com.key | openssl md5,值必须一致。

Failed to renew certificate example.com with error: DNS problem: NXDOMAIN looking up TXT for _acme-challenge.example.com

原因:TXT 未生效或 DNS API 权限不足。修复:dig TXT _acme-challenge.example.com +short,等待 TTL,检查 CF_Token 是否具备 Zone.DNS 编辑权限。

Invalid response from http://example.com/.well-known/acme-challenge/...

原因:HTTP-01 被防火墙拦截、301 跳转错误或 Web 根目录不可写。修复:放行 80 端口,为 /.well-known/acme-challenge/ 配置单独 location,或改用 DNS-01。Tomcat 报 keystore password was incorrect 时检查 keystorePass 与导出 p12 时的密码是否一致。

效果验证与防劫持监控

安装完成后按四层验证:HTTP 跳转、TLS 链、SAN/有效期、HSTS 和 CAA。先看 80 是否 301 到 HTTPS,再看 443 实际返回:

curl -I http://example.com
curl -I https://example.com
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | openssl x509 -noout -subject -issuer -dates -ext subjectAltName

输出中 notAfter 应覆盖预期周期,subjectAltName 应包含裸域、通配符和所有多域名 SAN。检查 HSTS 头:

curl -sI https://example.com | grep -i strict-transport-security

防劫持不能只靠 HTTPS。建议配置 CAA 限制可签发 CA,例如 0 issue ‘letsencrypt.org’,并检查:

dig +short CAA example.com

同时开启 DNSSEC、证书透明日志监控和到期告警。HSTS 的 includeSubDomains 要谨慎,开启后所有子域必须能 HTTPS,否则子域会无法访问;preload 更不要随意提交。不要使用已废弃的 HPKP 证书固定,容易造成全站不可用。多域名服务器证书要分别监控每个 SAN 域名的解析和握手,避免只监控主域。可用 testssl.sh 做快速检查:

./testssl.sh --fast https://example.com
ss -lntp | grep :443
crontab -l | grep acme.sh

最后模拟续期:~/.acme.sh/acme.sh –renew -d example.com –ecc –force,观察 reloadcmd 是否执行、证书日期是否更新。生产环境不建议频繁 force,可先在 staging 环境演练。若前面有 CDN,用 curl 分别测边缘和回源,确认两边证书一致。防劫持的底线是:全站 HTTPS、HSTS 逐步启用、CAA 收紧、DNS 权限最小化、私钥 600 权限、续费自动化和到期告警。

常见问题

不能。*.example.com 只匹配一级子域,如 api.example.com,不匹配 a.b.example.com,也不自动包含裸域 example.com。裸域和多级子域要单独写入 SAN,或分别申请证书。

公共 CA 签发的 TLS 服务器证书当前最长有效期为 398 天,Let’s Encrypt 免费证书为 90 天。必须用 acme.sh 或 certbot 自动续期,并在续期后 reload Nginx/Apache/Tomcat,否则会出现证书过期告警。

先确认安装的是新 fullchain 和 key,再执行 nginx -t 与 nginx -s reload;Apache 用 systemctl reload httpd,Tomcat 要重新导出 PKCS12 并重启。若前面有 CDN/负载均衡,还要同步上传新证书。用 openssl s_client 看 notAfter 是否更新。

常见报错是 curl: (60) SSL certificate problem: unable to get local issuer certificate,部分 Android 或 Java 客户端也会握手失败。Nginx 的 ssl_certificate 要用 fullchain.pem,Apache 的 SSLCertificateFile 指向 fullchain,Tomcat 的 PKCS12 必须包含完整链。

不够。HTTPS 防传输篡改,但防不了 DNS 劫持、BGP 劫持和错误签发。应配合 HSTS、CAA 限制签发、DNSSEC、证书透明日志监控和到期告警。HSTS 的 includeSubDomains 要确认所有子域都支持 HTTPS 后再开启。

内容审核

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