跳到主要内容
ssl证书按装

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

网站 HTTPS 证书配置实战:单域名、通配符证书与 HTTPS 泛解析全站加密 — 网站 HTTPS 证书配置实战:单域名、通配符证书与 HTTPS 泛解析全站加密

很多站点把“申请证书”当成全部工作,上线后仍会遇到证书不受信任、子域不匹配、HTTP 资源混合加载。本文围绕 CA 证书、单域名与通配符 SSL 证书、HTTPS 泛解析和全站加密,给出可直接执行的命令、配置示例与排错方法。

一、问题背景与根因:HTTP 明文、证书链与泛解析误区

浏览器校验 HTTPS 时看的是完整信任链:根证书在系统或浏览器信任库,中间证书由服务端随叶子证书下发,叶子证书必须匹配访问域名。常见根因包括:只部署叶子证书导致链不完整;证书 SAN 未包含实际访问域名;把通配符证书误认为可覆盖多级子域;页面仍引用 http:// 图片、脚本形成混合内容。另一个高频误区是把 DNS 泛解析当成 HTTPS 泛解析:*.example.com 的 A 记录只解决解析,TLS 通配符证书只匹配一级子域,a.b.example.com 必须单独加入 SAN 或另发 *.a.example.com。排查先看证书本身:

openssl x509 -in fullchain.pem -noout -subject -issuer -dates -ext subjectAltName

公网受信任 TLS 证书最长有效期 398 天,Let’s Encrypt 免费证书为 90 天,必须配置自动续期。使用 CDN 或 WAF 时,边缘证书与回源证书要分别配置;多域名虚拟主机还要确认 SNI 返回的是对应域名证书,而不是默认站点证书。

二、准备阶段:确认域名、服务器与证书类型

先列出需要覆盖的主机名,例如 example.com、www.example.com、api.example.com、*.example.com。确认 DNS 管理权限、服务器 80/443 端口、Nginx 或 Apache 版本,以及是否经过 CDN。基础检查命令:

dig +short example.com
dig +short api.example.com
curl -I http://example.com
openssl version
nginx -V
apachectl -v

证书类型按覆盖范围选:单域名适合一个主机名;通配符适合同一级下大量子域;多域名 SAN 适合品牌域名和跨域业务。DV 只验证域名控制权,签发快;OV 需要组织资料审核,适合企业对外服务。公网证书有效期上限 398 天,商业 CA 通常按 1 年签发,Let’s Encrypt 为 90 天。创建私钥目录并收紧权限:

install -d -m 700 /etc/ssl/private/example.com
chmod 600 /etc/ssl/private/example.com/*.key

如果使用泛解析,先确认 *.example.com 已解析到目标 IP,但不要认为解析生效就等于证书匹配;证书必须包含对应 SAN。生产环境不建议长期使用自签证书,自签仅用于内网测试或上线前验证配置。

三、实操一:OpenSSL 生成 CSR 与自签测试证书

向 CA 申请证书需要 CSR。现代公共 CA 主要校验 SAN,不再依赖 CN,因此 CSR 配置中要写清 subjectAltName。先生成配置文件:

cat > example.com.cnf <<'EOF'
[req]
distinguished_name=dn
req_extensions=req_ext
prompt=no
[dn]
CN=*.example.com
[req_ext]
subjectAltName=@alt_names
[alt_names]
DNS.1=*.example.com
DNS.2=example.com
EOF

生成私钥与 CSR:

openssl req -new -newkey rsa:2048 -sha256 -nodes 
-keyout example.com.key -out example.com.csr -config example.com.cnf
openssl req -in example.com.csr -noout -text | grep -A2 'Subject Alternative Name'

如果只是本地验证 Nginx 配置,可生成自签证书,但浏览器不会信任:

openssl req -x509 -nodes -days 365 -newkey rsa:2048 
-keyout self.key -out self.crt -subj '/CN=*.example.com' 
-addext 'subjectAltName=DNS:*.example.com,DNS:example.com'
chmod 600 example.com.key self.key

注意:自签证书天数可设 365 天,但公网受信任证书最长 398 天。CSR 中的 SAN 必须覆盖实际访问域名,通配符只写 *.example.com 时不会自动包含根域 example.com,通常要同时加入 DNS.2=example.com。

四、实操二:申请通配符证书(DNS-01 与 CA 选择)

公共 CA 签发通配符证书必须使用 DNS-01 验证,因为 HTTP-01 无法证明对整级子域的控制。用 Certbot 手动申请时,命令中的星号要加引号,防止被 shell 展开:

certbot certonly --manual --preferred-challenges dns 
-d '*.example.com' -d example.com

按提示在 DNS 中添加 TXT 记录 _acme-challenge.example.com,等待传播后验证:

dig +short TXT _acme-challenge.example.com @8.8.8.8
dig +short TXT _acme-challenge.example.com @1.1.1.1

如果 DNS 托管在 Cloudflare,可安装插件后自动续期:

apt install python3-certbot-dns-cloudflare
certbot certonly --dns-cloudflare 
--dns-cloudflare-credentials /root/.secrets/cloudflare.ini 
-d '*.example.com' -d example.com

商业 CA 流程类似:提交 CSR,选择 DNS TXT 或 CNAME 验证,审核通过后下载 fullchain 与私钥。通配符证书只覆盖一级子域,a.b.example.com 需要额外 SAN 或单独申请 *.a.example.com。续期测试与自动 reload:

certbot renew --dry-run
certbot renew --deploy-hook 'systemctl reload nginx'

五、配置示例:Nginx 与 Apache 部署证书及 HTTP 跳转

Nginx 必须让 ssl_certificate 指向 fullchain.pem,否则缺少中间证书。示例同时覆盖根域和一级子域,并把 HTTP 301 到 HTTPS:

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/letsencrypt/live/example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
    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;
    ssl_session_timeout 1d;
    add_header Strict-Transport-Security 'max-age=31536000' always;
}

Apache 2.4.8 及以上使用 fullchain 后不要再重复配置 SSLCertificateChainFile:

<VirtualHost *:443>
ServerName example.com
ServerAlias *.example.com
SSLEngine on
SSLCertificateFile /etc/letsencrypt/live/example.com/fullchain.pem
SSLCertificateKeyFile /etc/letsencrypt/live/example.com/privkey.pem
SSLProtocol -all +TLSv1.2 +TLSv1.3
</VirtualHost>

应用配置前先语法检查:nginx -t 与 apachectl configtest。HSTS 的 includeSubDomains 要谨慎,只有所有子域都已 HTTPS 才能加,否则会把未加密子域锁死。

六、对比表格:单域名、通配符、多域名与 DV/OV 选择

选证书不要只看价格,要看覆盖范围、验证方式和续期成本。下表按常见场景对比:

证书类型 覆盖范围 典型有效期 验证方式 适用场景
单域名 DV example.com 或 www.example.com 一个主机名 90 天或不超过 398 天 HTTP-01 或 DNS-01 单站点、博客、测试环境
通配符 DV *.example.com,可附加根域 SAN 90 天或不超过 398 天 必须 DNS-01 多子域、SaaS 租户、统一入口
多域名 SAN 多个不同域名或子域写进同一张证书 不超过 398 天 HTTP-01 或 DNS-01 多品牌、多业务域名
OV 企业型 单域名、通配符或多域名 不超过 398 天 组织资料审核加域名验证 企业官网、对外 API
EV 扩展验证 单域名或多域名为主 不超过 398 天 严格身份审核 金融、合规展示场景

关键结论:HTTPS 泛解析通常指 DNS 泛解析加通配符证书,二者缺一不可;通配符证书只覆盖一级子域;多级子域要么加 SAN,要么为下一级单独申请。Let’s Encrypt 适合自动化程度高的团队,商业 OV 适合需要组织身份背书的场景。无论选哪种,都要把自动续期和 reload 钩子纳入监控。

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

浏览器报 NET::ERR_CERT_COMMON_NAME_INVALID 或 SSL_ERROR_BAD_CERT_DOMAIN,通常是 SAN 不匹配或通配符层级不对。先查 SAN:openssl x509 -in fullchain.pem -noout -ext subjectAltName。若访问 a.b.example.com 而证书只有 *.example.com,必须补 SAN。curl 报 curl: (60) SSL certificate problem: unable to get local issuer certificate,说明中间证书缺失,应部署 fullchain.pem,并用 openssl s_client -connect example.com:443 -servername example.com -showcerts 检查返回链。

Nginx 启动报 SSL_CTX_use_PrivateKey_file failed,error:0B080074:X509_check_private_key:key values mismatch,是证书与私钥不配对。分别计算模数:openssl x509 -noout -modulus -in fullchain.pem | openssl md5 与 openssl rsa -noout -modulus -in privkey.pem | openssl md5,结果必须一致。Certbot 报 DNS problem: NXDOMAIN looking up TXT for _acme-challenge.example.com,检查 TXT 是否添加在正确域名、是否等待 TTL 传播,并用 dig +short TXT _acme-challenge.example.com @8.8.8.8 复核。

报 Problem binding to port 80: Could not bind to IPv4 or IPv6,说明 80 端口被占用;通配符 DNS-01 不依赖 80 端口,可改用 DNS 插件。报 too many certificates already issued,是触发 CA 速率限制,测试时加 –staging。页面仍显示不安全,检查混合内容:浏览器控制台会列出 http:// 资源,可先用 Content-Security-Policy: upgrade-insecure-requests 过渡,再逐项替换为 https://。

八、效果验证:openssl、curl、浏览器与 SSL Labs

部署后不要只看浏览器绿锁,要从命令行验证证书链、域名匹配和跳转。查看服务端证书:

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

验证 HTTP 跳转和响应头:

curl -sSI http://example.com | grep -i location
curl -sSI https://example.com | head
curl -vI https://api.example.com 2>&1 | grep -E 'SSL certificate|subject:|issuer:'

检查到期时间与自动续期:

echo | openssl s_client -servername example.com -connect example.com:443 2>/dev/null | openssl x509 -noout -enddate
systemctl list-timers | grep certbot
certbot renew --dry-run

浏览器开发者工具的 Security 面板应显示有效证书和 TLS 1.2/1.3;再用 SSL Labs 测试,目标至少 A,若追求 A+ 需启用 HSTS、禁用弱套件并保持证书链完整。最后抽查多个子域,确认泛解析域名都返回同一张通配符证书,且没有混合内容。

常见问题

不能。*.example.com 只匹配 api.example.com 这一级,不匹配 a.b.example.com。多级子域要把具体域名加入 SAN,或为下一级单独申请 *.a.example.com;申请前用 openssl x509 -ext subjectAltName 核对覆盖范围。

不是。泛解析是 DNS 把 *.example.com 解析到同一 IP;通配符证书是 TLS 证书覆盖一级子域。二者要配合使用,但 DNS 生效不代表证书匹配,证书匹配也不代表 DNS 已配置。

公网受信任 TLS 证书最长 398 天,Let’s Encrypt 免费证书为 90 天。应配置自动续期,并在到期前 30 天检查 certbot renew –dry-run 与 reload 钩子是否正常。

部署时 ssl_certificate 要指向 fullchain.pem,而不是仅叶子证书。用 openssl s_client -showcerts 检查是否返回中间证书;Apache 2.4.8 以上使用 fullchain 后不要再重复配置 SSLCertificateChainFile。

证书与私钥不配对,常见于复制错文件或续期后未 reload。分别计算模数:openssl x509 -noout -modulus -in fullchain.pem | openssl md5 与 openssl rsa -noout -modulus -in privkey.pem | openssl md5,两者必须一致。

公网 CA 的通配符证书必须用 DNS-01 验证,因为 HTTP-01 无法证明对整级子域的控制。用 certbot 时加 –preferred-challenges dns,并确保 _acme-challenge.example.com 的 TXT 记录已传播。

内容审核

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