跳到主要内容
ssl证书按装

HTTPS SSL 泛域名证书长期配置实战:CA 证书申请、安装与虚拟主机/VPS 部署

HTTPS SSL 泛域名证书长期配置实战:CA 证书申请、安装与虚拟主机/VPS 部署 — HTTPS SSL 泛域名证书长期配置实战:CA 证书申请、安装与虚拟主机/VPS 部署

问题背景与根因:泛域名证书为什么装上了还不生效

很多站点在虚拟主机或 VPS 上部署 HTTPS 时,把“泛域名证书”理解成一张证书覆盖所有子域,结果访问 a.example.com 正常,访问 a.b.example.com 却报证书不匹配。根因通常不是证书没装,而是泛域名只覆盖一级:*.example.com 匹配 a.example.com,不匹配 a.b.example.com,也不自动包含 example.com;申请时必须把 -d example.com 和 -d ‘*.example.com’ 一起写入 SAN。另一个高频根因是只上传了叶子证书,没有部署中间证书链,浏览器报 NET::ERR_CERT_AUTHORITY_INVALID 或 curl 报 unable to get local issuer certificate。还要注意公开可信 TLS 证书没有“永久”:2026-03-15 起 CA/B Forum 将最长有效期降至 200 天(此前 398 天),Let’s Encrypt 仍为 90 天,所谓长期 CA 证书应理解为稳定的根/中间证书体系,不是服务器证书永久有效。

排查先看证书实际 SAN 和有效期:

openssl x509 -in /etc/nginx/ssl/example.com.fullchain.pem -noout -subject -issuer -dates -ext subjectAltName

如果输出里没有 DNS:example.com 或 DNS:*.example.com,或者 notAfter 已过期,就不是 Nginx 配置问题,而是证书申请/续期问题。虚拟主机环境还要确认面板是否启用 SNI、是否把证书绑定到正确站点、是否强制 301 到 HTTPS 后仍加载了旧证书。

申请前准备:域名、DNS 权限、CSR 与 CA 证书选择

泛域名证书必须走 DNS-01 验证,因为 CA 要确认你控制 example.com 的 DNS。准备三样东西:可修改 DNS 的账号、目标域名清单、服务器上的私钥保存目录。若用商业 CA,通常要生成 CSR;若用 Let’s Encrypt/acme.sh,工具会自动生成私钥和 CSR,不需要手工提交。手工 CSR 命令如下,-addext 在 OpenSSL 1.1.1+ 可用:

mkdir -p /etc/nginx/ssl
openssl req -new -newkey rsa:2048 -nodes -keyout /etc/nginx/ssl/example.com.key -out /etc/nginx/ssl/example.com.csr -subj '/CN=example.com' -addext 'subjectAltName=DNS:example.com,DNS:*.example.com'

选择 CA 时看三点:是否支持泛域名、是否提供中间证书链、续期方式是否可自动化。DV 泛域名证书只验证域名控制权,适合大多数网站;OV/EV 需要组织验证,但浏览器 UI 差异已很小。不要购买所谓“永久证书”,公开信任证书有效期受 CA/B Forum 限制;Let’s Encrypt 泛域名证书 90 天有效,必须自动续期。虚拟主机用户要确认面板支持上传 fullchain 和私钥,VPS 用户要确认 80/443 端口、DNS API Token 权限和系统时间准确,时间偏差会导致 ACME 签名失败。

实操一:用 acme.sh 申请 Let’s Encrypt 泛域名证书(DNS-01)

以 Cloudflare DNS 为例,先在 Cloudflare 创建仅限 Zone:DNS:Edit 的 API Token,再在服务器执行。acme.sh 默认使用 Let’s Encrypt,证书有效期 90 天,续期由 cron 自动完成。命令中的 CF_Token 只放环境变量,不要写进仓库:

curl https://get.acme.sh | sh -s email=admin@example.com
source ~/.bashrc
export CF_Token='你的Cloudflare_Token'
export CF_Account_ID='你的Account_ID'
~/.acme.sh/acme.sh --set-default-ca --server letsencrypt
~/.acme.sh/acme.sh --issue --dns dns_cf -d example.com -d '*.example.com' --keylength ec-256

如果不用 DNS API,可手动模式:先执行 –issue –dns -d example.com -d ‘*.example.com’,按提示在 _acme-challenge.example.com 添加 TXT 记录,等待 DNS 生效后执行 –renew。注意 TXT 名称不要写成 _acme-challenge.*.example.com;通配符和主域名通常需要两条 TXT 值。申请成功后证书在 ~/.acme.sh/example.com_ecc/ 下,fullchain.cer 是叶子证书加中间证书。不要直接把 root CA 拼进 fullchain,服务器只需叶子证书和中间证书链。若报 too many failed authorizations recently,是 LE 失败次数限流,换 staging 或等待后再试。

实操二:证书安装到 Nginx/Apache 虚拟主机与 VPS

申请成功不等于部署完成,建议用 –install-cert 把证书复制到固定目录并绑定 reload 命令,这样续期后自动生效。ECC 证书要加 –ecc,RSA 证书不要加。目录权限建议私钥 600、证书 644:

mkdir -p /etc/nginx/ssl
~/.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 'systemctl reload nginx'
chmod 600 /etc/nginx/ssl/example.com.key
chmod 644 /etc/nginx/ssl/example.com.fullchain.pem

虚拟主机面板通常要求分别上传证书和私钥,证书栏粘贴 fullchain.pem 全文,私钥栏粘贴 key 文件全文;如果面板还有 CA 证书/中间证书栏,粘贴中间证书,不要粘贴根证书。Apache 2.4.8+ 可把 fullchain 放进 SSLCertificateFile;老版本用 SSLCertificateFile 放叶子证书、SSLCertificateChainFile 放中间证书。VPS 上要确认 Nginx 的 ssl_certificate 指向 fullchain,而不是只指向 leaf.crt;否则部分安卓和 Java 客户端会报证书链不完整。部署后先 nginx -t 再 reload,避免配置错误导致 443 全站不可用。

配置示例:Nginx、Apache 与 HTTPS 跳转的最小可用配置

Nginx 站点建议把 80 和 443 分开写,443 使用 fullchain 和私钥,TLS 只开 1.2/1.3,并加 HSTS。server_name 同时写主域名和泛域名,但泛域名不会匹配二级子域:

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_session_cache shared:SSL:10m;
add_header Strict-Transport-Security 'max-age=31536000' always;
root /var/www/example;
}

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
</VirtualHost>

配置后执行 nginx -t 或 apachectl configtest。若使用 CDN,源站证书和 CDN 边缘证书是两套:CDN 回源要信任源站证书,边缘证书要在 CDN 控制台绑定泛域名;否则用户看到的是 CDN 证书,不是 VPS 上的证书。

对比表格:泛域名证书、单域名证书、多域名证书与长期 CA 证书

选型时不要只看价格,要看覆盖层级、验证方式、续期成本和证书链。下表把常见类型放在一起对比:

类型 覆盖范围 验证方式 有效期/续期 适用场景
单域名 DV example.com 或 www.example.com HTTP-01/DNS-01 公开信任证书最长 200 天;LE 90 天 单站点、测试环境
泛域名 DV *.example.com,不含 example.com 和二级子域 必须 DNS-01 同上,建议自动续期 多子域 SaaS、虚拟主机多站点
多域名 SAN 列出的多个域名,可混合主域和子域 HTTP-01/DNS-01 同上 域名数量少且固定
CA 根/中间证书 不直接覆盖站点,用于构建信任链 CA 体系签发 根证书可长期,中间证书有生命周期 服务器部署中间链、客户端信任库

结论:需要无限一级子域时选泛域名;只有固定几个域名时多域名 SAN 更易管理;所谓“长期 CA 证书”不能替代服务器证书续期。泛域名证书必须把主域名单独加入 SAN,否则 https://example.com 仍会报错。

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

报错 1:Nginx 启动失败,日志出现 SSL_CTX_use_PrivateKey_file(…) failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch)。说明证书和私钥不匹配,用 modulus 比对:

openssl x509 -noout -modulus -in /etc/nginx/ssl/example.com.fullchain.pem | openssl md5
openssl rsa -noout -modulus -in /etc/nginx/ssl/example.com.key | openssl md5

报错 2:curl 返回 SSL: no alternative certificate subject name matches target host name。检查 SAN 是否包含当前域名,泛域名不覆盖二级子域。报错 3:浏览器 NET::ERR_CERT_AUTHORITY_INVALID,通常是 fullchain 只放了叶子证书,用 openssl s_client 看链:

openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null

报错 4:acme.sh 提示 Error add txt for domain:_acme-challenge.example.com,检查 DNS API Token 是否有 Zone:DNS:Edit 权限、Zone ID 是否正确。报错 5:too many failed authorizations recently,是 Let’s Encrypt 对失败验证的限流,不要连续重试,修正 DNS 后等待。报错 6:虚拟主机面板提示证书格式错误,确认粘贴的是 PEM 文本,包含 BEGIN CERTIFICATE 和 END CERTIFICATE,不要上传 DER 或 PFX。

效果验证:浏览器、curl、openssl 与自动续期检查

部署后先做四层验证。第一层配置语法:nginx -t;第二层本机回环:curl -I https://example.com;第三层证书链和 SNI:openssl s_client;第四层外部工具:浏览器锁标、SSL Labs。命令如下:

nginx -t
curl -I https://example.com
curl -I http://example.com
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null | openssl x509 -noout -subject -issuer -dates -ext subjectAltName
~/.acme.sh/acme.sh --list

预期结果:http 返回 301 到 https;证书 subject 的 CN 或 SAN 包含 example.com 和 *.example.com;issuer 是可信 CA;notAfter 未过期;s_client 输出能看到 leaf 和 intermediate 两级证书。若页面能打开但浏览器提示混合内容,检查 HTML 中是否有 http:// 图片、JS、CSS,把资源改成相对协议或 https。自动续期要确认 cron 存在:crontab -l 应看到 acme.sh –cron;也可手动执行 ~/.acme.sh/acme.sh –cron –home ~/.acme.sh 观察日志。续期后 –reloadcmd 会重载 Nginx,若没生效,检查 reload 命令权限和证书路径是否被面板覆盖。

常见问题

不能。*.example.com 只匹配 a.example.com 一级,不匹配 a.b.example.com;也不自动包含 example.com,申请时把 -d example.com 和 -d ‘*.example.com’ 一起写进 SAN。需要二级子域就单独签发或使用多域名证书。

90 天。建议用 acme.sh 的 DNS-01 自动续期,安装时用 –install-cert 绑定 reloadcmd,cron 会每天检查;不要手工续期,否则容易过期。公开信任证书最长有效期也受 CA/B Forum 限制,不是永久。

把 fullchain.pem 部署到 ssl_certificate,内容应为叶子证书加中间证书,不要只放 leaf.crt,也不要拼根证书;Apache 老版本用 SSLCertificateChainFile 指定中间证书。用 openssl s_client -showcerts 检查是否返回两级以上证书。

证书栏粘贴 fullchain.pem 全文,私钥栏粘贴 key 全文;若面板只接受单证书,先确认是否会自动补中间链,否则换支持 fullchain 的面板或改用 VPS。不要上传 PFX 到 PEM 栏,格式会报错。

CA 要验证你控制整个域名,HTTP-01 只能验证单个主机名,无法证明 *.example.com 的所有子域。DNS-01 通过在 _acme-challenge.example.com 添加 TXT 记录完成验证,因此需要 DNS API 或手动改解析。

398 天是旧上限。2026-03-15 起 CA/B Forum 将公开信任 TLS 证书最长有效期降至 200 天,后续还会继续缩短;Let’s Encrypt 仍为 90 天。因此必须自动化续期,不能按“长期证书”思路管理。

内容审核

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