跳到主要内容
基础知识

SSL证书包含www吗?从SAN、CSR到Nginx的完整排查与配置指南

ssl证书包含www吗 — SSL证书包含www吗?从SAN、CSR到Nginx的完整排查与配置指南
核心结论

1)不一定:SSL证书是否包含www取决于SAN是否写入DNS:www.example.com,只有CN=example.com的单域名证书不覆盖www,Chrome 58起不再回退检查CN。2)用OpenSSL 3.0生成CSR时加-addext 'subjectAltName=DNS:example.com,DNS:www.example.com',再用openssl req -text核对SAN。3)Let's Encrypt用certbot certonly --webroot -d example.com -d www.example.com --cert-name example.com,证书90天有效,续期用certbot renew --dry-run。4)验证命令openssl s_client -connect www.example.com:443 -servername www.example.com应返回Verify return code: 0 (ok)且SAN含www。5)通配符*.example.com覆盖www.example.com但不覆盖example.com,商业DV单域名约¥0-300/年,OV约¥800-3000/年。

为什么访问www会提示证书不匹配?根因在SAN而不是CN

用户搜索“ssl证书包含www吗”,最常见的触发场景就是浏览器地址栏报出 NET::ERR_CERT_COMMON_NAME_INVALID,或者 curl 直接返回:

curl: (60) SSL: no alternative certificate subject name matches target host name 'www.example.com'

这条报错里的关键词是 alternative certificate subject name,它已经点明了根因:现代 TLS 客户端判断“这张证书是否属于该主机名”时,依据的是 X.509 v3 扩展 subjectAltName(SAN),而不是 Subject 字段里的 CN(Common Name)。据 RFC 6125 第 6.4.4 节,证书使用者应优先用 SAN 中的 dNSName 做主机名匹配,CN 仅作为历史兼容字段;CA/Browser Forum Baseline Requirements 更是要求所有公开信任的证书必须包含 SAN 扩展。因此,如果一张证书的 SAN 列表里没有写目标域名,那么即使 CN 写对了,也依然会被判为不匹配。

从 DNS 角度看,example.com 与 www.example.com 是两个完全独立的 FQDN,各自有独立的 A/AAAA/CNAME 记录;证书校验属于“逐个主机名比对”的精确匹配,不存在父域自动覆盖子域的逻辑。只申请 example.com 的单域名证书,SAN 里只有 DNS:example.com,访问 https://www.example.com 必然失败。浏览器侧也没有回退机制:Chrome 自 58 版(2017 年 4 月)起彻底取消了对 CN 的匹配回退,Firefox 和 Safari 同样以 SAN 为唯一依据,所以“CN 写了 example.com 就能顺带覆盖 www”在今天的浏览器中完全不成立。

排查的第一步永远是查看线上实际下发的证书里到底有哪些 SAN,而不是只看订单页:

# 取回服务端真实下发的证书并只打印 SAN 扩展(OpenSSL 1.1.1+ 支持 -ext)
echo | openssl s_client -connect www.example.com:443 -servername www.example.com 2>/dev/null 
  | openssl x509 -noout -ext subjectAltName
# 典型输出(只有裸域,缺 www,于是报不匹配)
# X509v3 Subject Alternative Name:
#     DNS:example.com

# 本地证书文件同理;-A1 用于带出下一行的取值
openssl x509 -in /etc/letsencrypt/live/example.com/cert.pem -noout -text 
  | grep -A1 "Subject Alternative Name"

如果确认缺 www,那么最省事的做法就是在同一张证书里补一个 SAN。通配符 *.example.com 能覆盖 www.example.com、blog.example.com 等恰好一级的子域,但不覆盖裸域 example.com,也不覆盖 a.b.example.com(RFC 6125 与 CA/B BR 均规定通配符只匹配最左一个标签)。要用 Let’s Encrypt 同时覆盖裸域和 www,就必须显式写两个 -d;据 Let’s Encrypt 文档,certbot 中每多一个 -d 就多一条 SAN 条目,且它不会自动帮你加上 www:

# 关键:两个 -d 各对应一条 SAN;只写 -d example.com 不会覆盖 www
sudo certbot --nginx -d example.com -d www.example.com
# 证书默认有效期 90 天,建议先 --dry-run 验证,再靠 renew 钩子自动续期
sudo certbot renew --dry-run
证书类型 SAN 内容 覆盖 example.com 覆盖 www.example.com 覆盖 a.b.example.com
单域名 DNS:example.com 是 否 否
多 SAN(推荐) DNS:example.com, DNS:www.example.com 是 是 否
纯通配符 DNS:*.example.com 否 是 否
通配符 + 裸域 DNS:*.example.com, DNS:example.com 是 是 否

还有一种常见误判:证书 SAN 齐全但仍报错,此时问题多半出在 Nginx 的 server_name 未包含 www,导致请求落到了默认 server 块并下发了另一张证书——这时需要检查的是 SNI 分流与 ssl_certificate 指令所在的 server 块,而非证书本身。

完整实操步骤:从确认DNS到Nginx重载(编号1-6)

前面几节已经说明「SSL 证书包含 www 吗」取决于 SAN 扩展,而不是 CN 字段。下面这 6 步是按实际顺序排列的完整流程:每一步都给出命令和判断标准;如果某一步检查不通过,就不要继续下一步,因为证书签发失败后,Let’s Encrypt 的失败验证次数会计入速率限制(据 Let’s Encrypt 文档,failed validation 限制为每账户每主机名每小时 5 次)。

  1. 步骤 1:先确认 DNS 真的把两个名字指向同一台机器

    # 两个命令必须返回同一个公网 IP(示例为 203.0.113.10)
    dig +short A example.com
    dig +short A www.example.com
    
    # 顺便看 TTL,签发前建议压到 300-600 秒
    dig +noall +answer A www.example.com
    # www.example.com. 600 IN A 203.0.113.10

    如果 www 是 CNAME 指向 CDN,而源站才是你的 Nginx,那么 HTTP-01 校验会打到 CDN 节点上并失败。此时要么切回直连解析,要么改用 DNS-01 验证。TTL 若仍是 86400,改动解析后要等旧记录过期,否则 CA 可能读到旧 IP,出现 Fetching http://www.example.com/.well-known/acme-challenge/...: Connection refused 这类报错。

  2. 步骤 2:生成私钥与 CSR,并把 www 写进 SAN

    # OpenSSL 1.1.1 及以上支持 -addext(1.0.2 不支持,需改用配置文件)
    openssl req -new -newkey rsa:2048 -sha256 -nodes 
      -keyout example.com.key -out example.com.csr 
      -subj '/CN=example.com' 
      -addext 'subjectAltName=DNS:example.com,DNS:www.example.com'
    
    chmod 600 example.com.key   # 私钥权限,推荐 600,属主 root

    现代 CA 完全忽略 CN,只读 SAN(RFC 6125 第 6.4.4 节明确不建议再用 CN 匹配主机名)。所以 -addext 这一行才是决定「SSL 证书包含 www 吗」的关键;-subj '/CN=...' 只是为了兼容旧工具链。

  3. 步骤 3:提交前核对 CSR,别把缺 www 的请求发给 CA

    openssl req -in example.com.csr -noout -text | grep -A1 'Subject Alternative Name'
    # 期望输出:
    #   X509v3 Subject Alternative Name:
    #       DNS:example.com, DNS:www.example.com

    只看到 DNS:example.com 就说明 -addext 没生效(常见于 OpenSSL 1.0.2 或参数被 shell 吞掉)。此时不要提交,否则签出来的证书会让浏览器在访问 www 时抛出 NET::ERR_CERT_COMMON_NAME_INVALID。

  4. 步骤 4:签发证书(Let’s Encrypt 或商业 CA)

    # certbot 2.x,webroot 方式,两个 -d 各代表一个 SAN 条目
    certbot certonly --webroot -w /var/www/html 
      -d example.com -d www.example.com 
      --cert-name example.com --expand
    
    # 验证文件目录必须能被公网访问(HTTP-01 走 80 端口)
    ls -l /var/www/html/.well-known/acme-challenge/

    --cert-name 固定了证书目录名,续期脚本才不会因域名顺序变化而生成 example.com-0001。certbot 2.0 起默认密钥类型改为 ECDSA(secp256r1),如需 RSA 请显式加 --key-type rsa --rsa-key-size 2048。商业 CA 则在订单页的「SAN / 附加域名」里填 www.example.com,通常按域名数计价。

  5. 步骤 5:配置 Nginx 并做语法校验

    server {
        listen 443 ssl;
        http2 on;                                  # nginx 1.25.1+ 的新写法
        server_name example.com www.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;
    }
    nginx -t
    # nginx: configuration file /etc/nginx/nginx.conf test is successful
    systemctl reload nginx    # reload 不中断连接,restart 会

    必须用 fullchain.pem 而不是 cert.pem,否则部分客户端报 unable to get local issuer certificate。

  6. 步骤 6:续期演练 + 自动重载钩子

    certbot renew --dry-run        # 用 staging 环境演练,不消耗正式配额
    systemctl list-timers | grep certbot
    # Mon 2025-01-06 03:22:11 UTC  8h left  certbot.timer  certbot.service
    
    # 在 /etc/letsencrypt/renewal/example.com.conf 的 [renewalparams] 段加:
    # renew_hook = systemctl reload nginx
    # 或签发时用 --deploy-hook 'systemctl reload nginx'

    缺少 hook 是最隐蔽的故障:证书已更新,Nginx 仍持有旧证书,直到 systemctl reload nginx 才生效。可用 echo | openssl s_client -connect example.com:443 -servername www.example.com 2>/dev/null | openssl x509 -noout -dates -ext subjectAltName 确认线上实际下发的证书与 SAN。

检查点 命令 通过标准
DNS 一致性 dig +short A www.example.com 与裸域返回同一 IP,TTL ≤ 600
CSR 的 SAN openssl req -in ... -noout -text 含 DNS:www.example.com
线上证书 openssl s_client -servername www... 返回的 SAN 含 www,未过期
续期钩子 certbot renew --dry-run 末尾出现 Congratulations, all simulated renewals succeeded

配置与命令示例:OpenSSL 3.0、Certbot 2.x、Nginx 1.24

先别改 Nginx 配置。要回答“ssl证书包含www吗”这个问题,一条命令就够:直接读取 fullchain.pem 的 SAN 扩展,比在浏览器里点锁图标可靠得多。据 Let’s Encrypt 文档,Certbot 默认会把申请时 -d 列出的所有域名写进同一张证书的 SAN,因此 www 是否被覆盖完全取决于签发时的参数,而不是服务器配置。

# OpenSSL 1.1.1+ / 3.0.x 通用;-noout 只打印文本摘要,不输出 PEM 本体
openssl x509 -in /etc/letsencrypt/live/example.com/fullchain.pem -noout -text 
  | grep -A1 'Subject Alternative Name'
# 等价写法(OpenSSL 1.1.1+ 新增 -ext 参数,输出更干净)
openssl x509 -in /etc/letsencrypt/live/example.com/fullchain.pem -noout -ext subjectAltName

OpenSSL 3.0 的典型输出如下。若第二行只有 DNS:example.com,说明这张证书不覆盖 www;如果浏览器访问 https://www.example.com 时提示证书错误,原因就在这里。

X509v3 Subject Alternative Name:
    DNS:example.com, DNS:www.example.com

确认 SAN 齐全后,Nginx 1.24 的最小可用配置如下。注意 server_name 必须同时列出两个名字,否则 www 请求会落到 default_server 而返回错误证书:

server {
    listen 443 ssl;                       # Nginx 1.25.1 起 http2 改为独立指令:http2 on;
    server_name example.com www.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;  # 默认值为 TLSv1 TLSv1.1 TLSv1.2(1.24)
    ssl_prefer_server_ciphers off;        # 默认 off,交由客户端选择,配合 TLS1.3 更合理
}

别复制 live 目录:/etc/letsencrypt/live/example.com/ 下的文件是符号链接,指向 ../../archive/example.com/ 中带序号的文件。Certbot 续期后链接会自动指向新文件,复制走就等于把证书固定在了旧版本上。核对续期覆盖范围用 Certbot 2.x:

certbot certificates
# 期望输出:
#   Certificate Name: example.com
#     Domains: example.com www.example.com
#     Expiry Date: 2025-06-01 12:00:00+00:00 (VALID: 89 days)
#     Certificate Path: /etc/letsencrypt/live/example.com/fullchain.pem

证书文件对,不等于链路和主机名都对。用 SNI 显式握手验证,据 OpenSSL 文档,-servername 才会触发服务器返回对应虚拟主机的证书:

openssl s_client -connect www.example.com:443 -servername www.example.com 
  -CAfile /etc/ssl/certs/ca-certificates.crt /dev/null 
  | openssl x509 -noout -subject -issuer -ext subjectAltName
# 同时检查握手尾部,必须出现:Verify return code: 0 (ok)

再从 HTTP 层验证一次,--resolve 可在不修改 DNS 和 hosts 的情况下指定回源 IP(curl 7.81 / 8.x 均支持):

curl -vI https://www.example.com --resolve www.example.com:443:203.0.113.10
# 期望:* SSL certificate verify ok.  以及 HTTP/2 200(或 301/302)

如果开启了 OCSP 装订(ssl_stapling on;),可顺手确认装订是否生效,否则客户端会自行回源查询 OCSP,增加首字节延迟:

openssl s_client -connect www.example.com:443 -servername www.example.com -status /dev/null 
  | grep -E 'OCSP Response Status|Cert Status'
# 期望:OCSP Response Status: successful   Cert Status: good
验证手段 能证明什么 通过判据
openssl x509 -text 证书文件里是否写了 www(本地文件) SAN 中出现 DNS:www.example.com
certbot certificates 续期时会不会继续带上 www Domains 行含两个域名
openssl s_client 服务器实际下发的证书 + 链 + 主机名匹配 Verify return code: 0 (ok)
curl -vI --resolve 端到端 HTTPS 是否可用 SSL certificate verify ok 且状态码 200/301/302

四步都通过,才算真正解决了“ssl证书包含www吗”的疑问;任何一步失败,优先回头检查签发时的 -d 列表与 server_name 是否一致。

单域名、多域名SAN、通配符怎么选?参数对比表

先给结论:只用一个域名(裸域或 www 中的某一个)访问,单域名 DV 就够;裸域和 www 都要能打开 HTTPS,最省事的是”多域名 SAN DV”把两个 FQDN 写进同一张证书;只有当你有一批动态子域(a.example.com、b.example.com……)时,通配符才划算。据 CA/Browser Forum 基线要求,浏览器早已不认 Common Name,只认 SAN(subjectAltName),所以”证书包含 www 吗”这个问题本质是问”www 有没有被列进 SAN“。

方案 覆盖范围 适用场景 参考价格/年 签发时间
单域名 DV 仅 example.com 或 www.example.com 其中一个 测试页、个人主页 ¥0–300 1–10 分钟
多域名 SAN DV example.com + www.example.com + 其他 FQDN 主站 + www + API ¥0–800 1–30 分钟
通配符 DV *.example.com,含 www,不含裸域 子域多且动态 ¥300–1500 5–30 分钟
OV 单/多域名 组织验证,1–5 个 FQDN 企业官网 ¥800–3000 1–3 个工作日
EV 扩展验证,地址栏展示组织名(部分浏览器已弱化) 金融、高信任场景 ¥2000–8000 3–7 个工作日

两个最容易踩的坑。第一,单域名证书不会”自动带 www”:在商业 CA 下单页里 Common Name 只能填一个 FQDN,想同时覆盖 www 就得在 SAN 里额外购买/添加一个域名额度。第二,通配符 *.example.com 不覆盖 example.com,这是 RFC 6125 中通配符只匹配一个标签的规则决定的;裸域和 www 都要用,常见做法是”通配符 + 裸域 SAN”写进同一张证书,或者干脆两张证书。各 CA 的单证书 SAN 上限不同,常见档位是 5 / 10 / 50 / 100 个域名(据 Let’s Encrypt 文档,单张证书最多 100 个域名)。

用 Let’s Encrypt 免费拿到”裸域 + www”一张证书,并固定证书名,避免续期时生成 example.com-0001 目录导致 Nginx 路径失效(Certbot 0.10 起支持 --cert-name):

# 一张证书覆盖裸域与 www;-d 可重复,第一个 -d 仅决定 CN 显示
sudo certbot certonly --webroot -w /var/www/html 
  -d example.com -d www.example.com 
  --cert-name example.com          # 关键:固定证书名,续期不会新建 example.com-0001

# 通配符必须走 DNS-01 质询;显式再加 -d example.com 才能覆盖裸域
sudo certbot certonly --manual --preferred-challenges dns 
  -d '*.example.com' -d example.com 
  --cert-name wildcard-example.com

签完先验证 SAN 到底有没有 www(OpenSSL 1.1.1+ 通用):

openssl x509 -in /etc/letsencrypt/live/example.com/cert.pem -noout -text 
  | grep -A1 "Subject Alternative Name"
# 正常输出:X509v3 Subject Alternative Name:
#              DNS:example.com, DNS:www.example.com

如果你是自己生成 CSR 交给商业 CA,务必显式写 SAN,因为 OpenSSL 默认只写 CN、不写 SAN:

openssl req -new -newkey rsa:2048 -nodes 
  -keyout example.key -out example.csr 
  -subj "/CN=example.com" 
  -addext "subjectAltName=DNS:example.com,DNS:www.example.com"
# -addext 需 OpenSSL 1.1.1 及以上;旧版本请改用 -config 中的 subjectAltName 段

最后提醒 CDN 场景:源站证书包含 www,不等于边缘节点也包含。若 Cloudflare、阿里云 CDN 的回源/边缘证书只签了裸域,浏览器依旧会抛 NET::ERR_CERT_COMMON_NAME_INVALID。排查顺序是”边缘证书 SAN → 源站证书 SAN → Nginx 实际加载的 ssl_certificate 路径”,三者任一缺失 www 都会报错。

常见错误与排查:这些报错分别代表什么

Chrome 报 NET::ERR_CERT_COMMON_NAME_INVALID,是证书没包含 www 吗?

大概率是。Chrome 自 58 版起完全忽略证书的 CN 字段,只按 SAN(subjectAltName)校验主机名,规则见 RFC 6125 §6.4.4。所以“SSL 证书包含 www 吗”这个问题的答案必须落在 SAN 列表里,而不是证书主题的 Common Name 上。先用 OpenSSL 确认实际签发了哪些名字(-ext 需 OpenSSL 1.1.1 及以上,1.0.2 请改用 -text 后 grep):

# 查看证书 SAN 列表;-ext 自 OpenSSL 1.1.1 起可用
openssl x509 -in /etc/letsencrypt/live/example.com/fullchain.pem -noout -ext subjectAltName
# 期望输出:X509v3 Subject Alternative Name:
#     DNS:example.com, DNS:www.example.com

若只有 DNS:example.com,用 Certbot 重新签发时显式带上两个域名(-d 可重复,Let’s Encrypt 允许一张证书最多 100 个 SAN):

# 同一张证书同时覆盖裸域与 www
sudo certbot certonly --webroot -w /var/www/html 
  -d example.com -d www.example.com

curl 报 curl: (60) SSL: no alternative certificate subject name matches target host name 'www.example.com' 怎么定位?

这是 libcurl 7.36+ 的原文报错,含义就是 SAN 里没有该主机名。排查时先用 --resolve 绕过 DNS/CDN,把域名钉到源站 IP,避免被 CDN 回源证书干扰判断:

# 强制把 www.example.com 解析到源站 203.0.113.10,跳过 DNS 与 CDN
curl -vI https://www.example.com --resolve www.example.com:443:203.0.113.10

Java 抛 javax.net.ssl.SSLHandshakeException: No subject alternative DNS name matching www.example.com found

JDK 自 8u181 起(JDK-8203682)在 X509ExtendedTrustManager 中强制按 SAN 匹配,CN 回退已被移除。正确做法是重签证书补上 SAN,而不是在生产环境设置 -Dcom.sun.net.ssl.checkRevocation=false 或自定义 HostnameVerifier 返回 true——那等于关掉主机名校验,直接暴露中间人攻击面。

Firefox 报 SSL_ERROR_BAD_CERT_DOMAIN,和 Chrome 是同一回事吗?

同类问题,但 Firefox 的报错更常暴露 SNI 配置错误:服务器对 www.example.com 的 SNI 返回了默认 server block 的证书。用 s_client 指定 SNI 验证:

# -servername 模拟浏览器发送 SNI,观察服务器实际返回哪张证书
openssl s_client -connect 203.0.113.10:443 -servername www.example.com /dev/null 
  | openssl x509 -noout -subject -ext subjectAltName

若返回的是其他站点证书,说明 Nginx 缺少 server_name www.example.com; 或该 server 块未配置 ssl_certificate,落到了 default_server。

Certbot 报 Challenge failed for domain www.example.com / Timeout during connect (likely firewall problem)

顺序检查三件事:DNS 是否指向本机、80 端口是否放行、CDN 是否代理并拦截了 /.well-known/acme-challenge/。

dig +short www.example.com          # 应返回本机公网 IP;返回 CDN 节点则需关闭代理或改用 DNS-01
curl -I http://www.example.com/.well-known/acme-challenge/test  # 期望 404 而非 403/502
sudo ufw status | grep 80           # 或 firewall-cmd --list-ports

Nginx 报 nginx: [emerg] cannot load certificate "/etc/letsencrypt/live/example.com/fullchain.pem": No such file or directory

多为路径写错或 live/ 下的符号链接断裂(续期失败或目录被手工删除)。核对链接指向与 Certbot 记录的证书名(注意 example.com-0001 这类重名后缀):

ls -l /etc/letsencrypt/live/example.com/   # fullchain.pem -> ../../archive/example.com/fullchain1.pem
sudo certbot certificates                  # 列出 Certificate Name / Domains / Expiry
sudo nginx -t && sudo systemctl reload nginx
报错原文 含义 最常见根因 验证命令
NET::ERR_CERT_COMMON_NAME_INVALID 主机名不在 SAN 中 只签了裸域 openssl x509 -noout -ext subjectAltName
curl: (60) no alternative certificate subject name matches 同上,libcurl 措辞 CDN 回源证书覆盖 curl --resolve
SSLHandshakeException: No subject alternative DNS name matching JDK 按 SAN 校验 旧证书无 www SAN keytool -printcert -sslserver
SSL_ERROR_BAD_CERT_DOMAIN SNI 返回错误证书 缺 server_name / 默认 server s_client -servername
Challenge failed / Timeout during connect HTTP-01 校验不可达 80 端口、DNS、CDN 代理 dig +short
cannot load certificate … No such file or directory 文件或软链缺失 路径错 / live 链接断裂 ls -l live/、certbot certificates

效果验证:如何确认证书真的包含www并已生效

把证书装上不等于浏览器会认 www。这一节按”客户端 → 线上握手 → 信任链 → HTTP 层 → 服务端配置”五层逐级验证,任何一层通过都不足以证明”ssl 证书包含 www 吗”这个问题的答案是肯定的——锁图标只能说明当前连接被验证过,不能说明 SAN 覆盖了你访问的那个主机名。

验证层 命令/位置 通过判据 覆盖不到的风险
浏览器 UI Chrome 120+:锁图标 → 连接安全 → 证书有效 使用者可选名称同时列出 example.com 与 www.example.com 页面混合内容、旧缓存
线上握手取证书 openssl s_client -servername subject=CN = example.com,SAN 含 DNS:www.example.com 信任链是否完整
链 + 主机名校验 openssl verify -verify_hostname 输出 OK HTTP 层实际行为
HTTP 数值化 curl -w 状态码 200/301 且 ssl_verify_result=0 —
服务端配置 nginx -T / ss -lntp 配置被加载、443 处于监听 CDN/负载均衡后的证书被替换

第一层在浏览器里展开:地址栏锁图标 → 连接安全 → 证书有效 → 详细信息,逐条读”使用者可选名称”。据 CA/Browser Forum 基线要求,现代浏览器只匹配 SAN 扩展、完全忽略 CN,所以 CN 里写着 example.com 并不能救回 www 访问失败。

# 1) 从线上真实返回的证书读 SAN。-servername 触发 SNI,缺省会拿到默认虚拟主机的证书
openssl s_client -connect www.example.com:443 -servername www.example.com </dev/null 2>/dev/null 
  | openssl x509 -noout -subject -ext subjectAltName
# 期望:subject=CN = example.com
#       X509v3 Subject Alternative Name:
#           DNS:example.com, DNS:www.example.com

# 2) 同时校验信任链与主机名(-verify_hostname 需 OpenSSL 1.1.0+,RHEL 7 自带的 1.0.2 不支持)
openssl verify -CAfile /etc/letsencrypt/live/example.com/chain.pem 
  -verify_hostname www.example.com 
  /etc/letsencrypt/live/example.com/cert.pem
# 期望:/etc/letsencrypt/live/example.com/cert.pem: OK

# 3) 数值化验证:ssl_verify_result 为 0 表示证书验证通过
curl -sS -o /dev/null -w '%{http_code} %{ssl_verify_result}n' https://www.example.com
# 期望:200 0 或 301 0;若为 60 即证书链不受信,为 62 即主机名不匹配

主机名不匹配时,openssl verify 会直接报 verify error:num=62:hostname mismatch,这正是”ssl 证书包含 www 吗”最常见的否定答案。据 RFC 9525(已取代 RFC 6125)规定,主机名匹配以 SAN 中的 dNSName 条目为准,且不支持通配符跨越多个标签。

# Certbot 视角:Domains 行必须同时出现两个主机名,Expiry Date 应在 90 天内(Let's Encrypt 证书有效期)
certbot certificates

# 演练续期,不真正写入。期望结尾:Congratulations, all simulated renewals succeeded
certbot renew --dry-run

# 确认 Nginx 加载的配置里,server_name 与 ssl_certificate 指向同一站点
nginx -T | grep -E 'server_name|ssl_certificate'
systemctl status nginx --no-pager | head -3   # 期望 active (running)
ss -lntp | grep ':443'                        # 期望有 nginx 进程监听 0.0.0.0:443 / [::]:443

nginx -T(1.9.2+ 支持)转储的是合并后真正生效的配置,比读 /etc/nginx/conf.d/*.conf 可靠——可以立刻发现 server_name 只写了 example.com 而 www 落到了别的 server 块。若前置了 CDN 或云负载均衡,还需在其控制台单独核对回源证书,因为终端用户看到的是边缘节点的那一张。

不一定。单域名证书只覆盖订单/CSR中列出的FQDN,若SAN只有DNS:example.com,访问https://www.example.com会报主机名不匹配。要覆盖www,需在SAN中加入DNS:www.example.com,或用*.example.com通配符(但不覆盖裸域)。

包含。*.example.com可匹配www.example.com、blog.example.com等一级子域,但不匹配example.com,也不匹配a.b.example.com。若裸域也要HTTPS,需把example.com加入SAN或单独签发。

可以。Certbot 2.x执行certbot certonly –webroot -w /var/www/html -d example.com -d www.example.com –cert-name example.com即可。Let's Encrypt证书有效期90天,建议用certbot.timer自动续期并加deploy-hook重载Nginx。

先确认访问的主机名和证书SAN:openssl x509 -in fullchain.pem -noout -ext subjectAltName。若缺少DNS:www.example.com,重新签发并加入www;Chrome 58起不再用CN回退,改CN无效。

DV场景优先Let's Encrypt:免费、90天、可自动化,适合个人站和测试;需要OV/EV组织验证、1-2年有效期、商业支持或保修时选商业CA。参考价格:商业DV单域名约¥0-300/年,OV约¥800-3000/年,EV约¥2000-8000/年。

常见原因是DNS/SNI指到了另一个虚拟主机或CDN回源证书。用curl –resolve www.example.com:443:正确IP复测,并用openssl s_client -servername www.example.com查看实际返回证书;同时检查Nginx server_name是否包含www。

检查certbot certificates的Certificate Name和Domains,确认续期任务没有生成example.com-0001新目录。Nginx路径应固定指向/etc/letsencrypt/live/example.com/,并配置deploy-hook 'systemctl reload nginx'。


本文由 sslgood.com 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。

内容审核

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