跳到主要内容
HTTPS安装配置

SSL 通配符证书申请与 HTTPS 部署全流程:DV/EV 选型、Nginx 配置、真实报错排查

SSL 通配符证书申请与 HTTPS 部署全流程:DV/EV 选型、Nginx 配置、真实报错排查 — SSL 通配符证书申请与 HTTPS 部署全流程:DV/EV 选型、Nginx 配置、真实报错排查

为什么你的网站还在用 HTTP:问题背景与根因

浏览器对 HTTP 页面的处理早已从“提示”变成“拦截”:Chrome 地址栏对非 HTTPS 页面直接标红“不安全”,微信小程序、公众号网页授权、iOS App 的 ATS(App Transport Security)都强制要求 TLS。很多站长买了证书却依然报错,根因通常不是“证书没买对”,而是下面几类工程问题:

  • 证书链不完整:只部署了 cert.pem(站点证书),没部署中间 CA。桌面 Chrome 因为缓存可能能打开,但 Android 微信、Java 客户端、curl 直接失败。
  • 域名不匹配:证书签给 www.example.com,用户却访问 example.com;或误以为通配符 *.example.com 能覆盖 a.b.example.com。
  • 证书过期:公开 CA 签发的证书单次最长有效期已被压缩到 398 天,Let’s Encrypt 只有 90 天,忘记续期是最高频故障。
  • 混合内容(Mixed Content):页面是 HTTPS,但引用了 http:// 的图片、JS、CSS,Chrome 会主动阻断。
  • 只开了 443 没做 80 跳转,或 CDN 回源仍是 HTTP。

典型报错长这样:

curl: (60) SSL certificate problem: unable to get local issuer certificate
# 或
NET::ERR_CERT_COMMON_NAME_INVALID
Mixed Content: The page at 'https://example.com/' was loaded over HTTPS,
but requested an insecure image 'http://cdn.example.com/a.png'.

所以正确的顺序是:先确认证书类型与覆盖域名 → 生成私钥与 CSR → 完成域名验证 → 部署 fullchain(含中间证书的完整链)→ 配置强制跳转与 TLS 参数 → 用命令行验收。下面按这个顺序逐段拆解,所有命令可直接复制执行。

证书选型与有效期:DV、OV、EV 和通配符到底怎么选

“买证书”本质是买三件事:覆盖哪些域名、验证到哪一层、有效期多长,这三点决定了价格和部署复杂度,而不是加密强度——所有公开 CA 签发的证书,在 TLS 握手里的加密算法与强度完全一样。

类型 验证方式 签发时长 浏览器展示 适用场景
DV 单域名 DNS TXT 或 HTTP 文件验证域名控制权 秒级~10 分钟 锁图标 小程序、公众号、API、测试环境
DV 通配符 *.example.com 仅支持 DNS-01 10 分钟~数小时 锁图标 子域多、SaaS 多租户
OV 企业型 营业执照 + 电话回访核验 1~3 工作日 锁图标,企业名在证书详情 公司官网、电商
EV 增强型 严格企业身份核验 3~7 工作日 锁图标(Chrome 77 起已取消绿色地址栏) 金融、政企、招投标
多域名 SAN 对每个域名单独验证 同 DV/OV 同 DV/OV 主站 + 多个不相关域名

有效期必须纠正一个常见误解:CA/Browser Forum 与各大根证书计划早已把公开信任证书的单次最长有效期压缩到 398 天,任何 CA 都不可能签发“3 年期”“5 年期”证书。市面上所谓的“多年套餐”只是把多张 398 天证书一次性卖给你,仍需按期更换。Let’s Encrypt 更短,只有 90 天,必须自动化续期。按 CA/B Forum SC-081 的时间表,最长有效期还会继续缩短:2026 年 3 月 15 日起 200 天,2027 年 3 月 15 日起 100 天,届时自动化续期将从“建议”变成“必需”。

选型结论:有多个子域就选通配符 DV,性价比最高,市面上 300 元/年这个价位基本都是 DV 通配符;需要向客户证明企业身份才考虑 OV/EV,并且要接受 EV 不再显示绿色地址栏的现实——它现在只体现在证书详情的 O 字段里。

申请前的准备:私钥、CSR 与域名验证方式

无论从哪家 CA 购买,流程都是同一条链路:生成私钥 → 生成 CSR → 提交 CSR → 完成域名验证 → 下载证书 → 部署。自己生成私钥比让 CA 生成更安全,因为私钥始终不出服务器。

# 1) 生成 2048 位 RSA 私钥(也可用更快的 ECDSA P-256)
openssl genrsa -out example.com.key 2048
chmod 600 example.com.key

# 2) 生成 CSR,通配符与主域同时写入 SAN(关键!)
openssl req -new -key example.com.key -out example.com.csr 
  -subj "/C=CN/ST=Zhejiang/L=Hangzhou/O=Example Co.,Ltd/CN=*.example.com" 
  -addext "subjectAltName=DNS:example.com,DNS:*.example.com"

# 3) 校验 CSR 内容
openssl req -in example.com.csr -noout -text | grep -A2 "Subject Alternative Name"

域名验证有三种方式,选错是最常见的卡点:

  • HTTP-01 文件验证:CA 访问 http://example.com/.well-known/acme-challenge/<token>。必须 80 端口对外开放、不能有 301 跳转、不能被 WAF 拦截。
  • DNS-01 TXT 验证:在 _acme-challenge.example.com 添加 TXT 记录。通配符证书只能走这条,ACME 协议规定 *.example.com 不接受 HTTP 验证。
  • 邮件/WHOIS 验证:仅部分商业 CA 支持,用于 OV/EV 的企业身份核验环节。

DNS 记录添加后务必确认传播,TTL 建议先调到 60 秒:

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

另外提醒:CSR 里的 CN 与 subjectAltName 要一致;只写 CN=*.example.com 而不写 SAN 的老做法,在现代浏览器(强制校验 SAN)里会直接报域名不匹配。

完整实操:申请通配符证书(certbot / acme.sh 两种方案)

方案 A:certbot 手动 DNS 模式,适合一次性部署、无 DNS API 权限的场景

# Debian/Ubuntu
apt update && apt install -y certbot
# CentOS/RHEL 8+
dnf install -y certbot

# 申请通配符:-d 参数要写两次,主域和泛域名都要
certbot certonly --manual --preferred-challenges dns 
  -d example.com -d "*.example.com" 
  --agree-tos -m admin@example.com

执行后 certbot 会打印一串 TXT 值,要求你在 DNS 面板添加 _acme-challenge.example.com。注意:同时申请 example.com 和 *.example.com 时,certbot 会要求添加两条同名 TXT 记录,必须都加上再回车,少一条就验证失败。

方案 B:acme.sh + DNS API 自动续期,生产环境推荐

curl https://get.acme.sh | sh -s email=admin@example.com

# 阿里云 DNS(AK/SK 从 RAM 控制台获取,权限只需 AliyunDNSFullAccess)
export Ali_Key="LTAIxxxxxx"
export Ali_Secret="xxxxxxxxxxxx"
~/.acme.sh/acme.sh --issue --dns dns_ali -d example.com -d "*.example.com"

# 安装证书到 Nginx 目录,并注册续期后的 reload 钩子
~/.acme.sh/acme.sh --install-cert -d example.com 
  --key-file       /etc/nginx/ssl/example.com.key 
  --fullchain-file /etc/nginx/ssl/example.com.pem 
  --reloadcmd      "nginx -s reload"

acme.sh 会自动写入 crontab,每 60 天续期一次。certbot 用户则依赖系统定时器:

systemctl list-timers | grep certbot      # 确认 certbot.timer 已启用
certbot renew --dry-run                   # 演练续期,不实际写入

关键点:续期只更新证书文件,不会自动让 Nginx 生效,必须配置 --deploy-hook "nginx -s reload" 或 acme.sh 的 --reloadcmd。否则磁盘上是新证书、内存里还是旧的,到期当天全站报错,而且这种故障往往在凌晨触发。

配置示例:Nginx / Apache / 宝塔面板落地 HTTPS

Nginx(推荐,1.25.1 以上用 http2 on 语法)

server {
    listen 80;
    server_name example.com www.example.com;
    return 301 https://$host$request_uri;
}

server {
    listen 443 ssl;
    http2 on;
    server_name example.com www.example.com;

    # 必须用 fullchain,包含中间证书
    ssl_certificate         /etc/nginx/ssl/example.com.pem;
    ssl_certificate_key     /etc/nginx/ssl/example.com.key;
    ssl_trusted_certificate /etc/nginx/ssl/chain.pem;

    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_stapling        on;
    ssl_stapling_verify on;

    add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
    add_header X-Content-Type-Options nosniff always;

    root /var/www/example;
    index index.html;
}

改完执行 nginx -t && nginx -s reload。注意 HSTS 的 includeSubDomains 会把所有子域强制 HTTPS,如果还有子域跑着纯 HTTP 服务,先别加,等全部迁移完再开,否则在 max-age 有效期内几乎无法回滚。

Apache 2.4

<VirtualHost *:80>
    ServerName example.com
    Redirect permanent / https://example.com/
</VirtualHost>

<VirtualHost *:443>
    ServerName example.com
    SSLEngine on
    SSLCertificateFile      /etc/httpd/ssl/example.com.pem
    SSLCertificateKeyFile   /etc/httpd/ssl/example.com.key
    # Apache 2.4.8+ 不再需要 SSLCertificateChainFile,fullchain 已含中间证书
    SSLProtocol             all -SSLv3 -TLSv1 -TLSv1.1
    Header always set Strict-Transport-Security "max-age=31536000"
</VirtualHost>

宝塔面板:站点设置 → SSL → 其他证书 → 把 fullchain 内容粘到“证书(PEM 格式)”、privkey 粘到“私钥(KEY 格式)” → 保存 → 打开“强制 HTTPS”。宝塔的证书实际路径在 /www/server/panel/vhost/cert/域名/,续期脚本要指向这里。若前面套了 CDN(阿里云/腾讯云),证书必须同时在 CDN 控制台上传,否则源站 443 正常、边缘节点仍在用旧证书。

常见错误排查:8 个真实报错与修复

下面每一条都是从浏览器 DevTools、curl、nginx -t 或 certbot 日志里能直接抓到的原文,按报错原文检索即可。

报错原文 根因 修复
curl: (60) SSL certificate problem: unable to get local issuer certificate 只部署了站点证书,缺中间 CA 改用 fullchain.pem;或把站点证书与中间证书按顺序拼接成一个文件
NET::ERR_CERT_COMMON_NAME_INVALID 证书 SAN 不含当前访问域名(如缺 www) 重新签发,CSR 的 SAN 写全 example.com 与 *.example.com
NET::ERR_CERT_DATE_INVALID 证书过期,或服务器时间偏差超过 5 分钟 timedatectl set-ntp true 校时;配置自动续期钩子
nginx: [emerg] cannot load certificate "...": PEM_read_bio_X509_AUX() failed 文件是 PKCS#7 / PKCS#12 / 带 BOM 的文本,不是 PEM openssl pkcs12 -in a.pfx -nodes -out a.pem 转换;用 file a.pem 确认是 ASCII text
nginx: [emerg] SSL_CTX_use_PrivateKey(...) failed (SSL: key values mismatch) 证书与私钥不是一对 比对模数指纹:openssl x509 -noout -modulus -in cert.pem | md5sum 与私钥同样计算,值必须一致
Detail: DNS problem: NXDOMAIN looking for TXT at _acme-challenge.example.com TXT 记录没加、主机记录写错(误写成 _acme-challenge.example.com.example.com)或尚未传播 dig +short TXT _acme-challenge.example.com @8.8.8.8 确认有值后再继续
too many failed authorizations recently Let’s Encrypt 验证失败次数超限(每账号每小时 5 次) 等待 1 小时;后续先用 --dry-run 或 staging 环境调试
Mixed Content: The page at 'https://...' was loaded over HTTPS, but requested an insecure resource 'http://...' 页面内硬编码了 http 资源 改成协议相对 //cdn.example.com/a.js 或直接 https;再加 Content-Security-Policy: upgrade-insecure-requests

两个最容易漏的点:一是防火墙只放了 443 没放 80,既导致 HTTP-01 验证失败,也让用户访问 http:// 时无法跳转;二是 CDN/WAF 终结了 TLS,源站证书其实是 CDN 在验证,此时排查要看 CDN 侧的证书配置,而不是服务器上的文件。

效果验证:从命令行到 SSL Labs 的 5 步验收

部署完不要只看浏览器有没有绿锁,按下面 5 步逐项确认,每一步都有明确判据。

# 1) 看证书主体、签发者、有效期(-servername 必加,否则可能拿到默认站证书)
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null 
  | openssl x509 -noout -subject -issuer -dates

# 2) 验证证书链是否完整(必须返回 Verify return code: 0 (ok))
openssl s_client -connect example.com:443 -servername example.com 
  -CAfile /etc/ssl/certs/ca-certificates.crt </dev/null 2>&1 | grep "Verify return code"

# 3) 确认协议版本,应只看到 TLSv1.2 / TLSv1.3
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null | grep "Protocol"

# 4) 确认 80 端口 301 跳转与 HSTS 响应头
curl -sI http://example.com | head -3
curl -sI https://example.com | grep -i strict-transport-security

# 5) 检查剩余天数(1814400 秒 = 21 天),可用于监控告警
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null 
  | openssl x509 -noout -checkend 1814400 && echo "剩余 > 21 天"

第 2 步是最容易被跳过、也最容易出问题的一步:很多国产手机浏览器、微信内置 WebView、Java/Python 客户端对证书链的校验比桌面 Chrome 严格,桌面能打开、手机报错,99% 是链不完整。

最后跑一次 SSL Labs 评级(免费 API,无需注册):

curl -s "https://api.ssllabs.com/api/v3/analyze?host=example.com&publish=off&all=done" 
  | grep -E '"grade"|"status"'

目标是 A 及以上。只有 B 通常是仍支持 TLS 1.0/1.1 或缺少 HSTS;显示 “Certificate not trusted” 就回到第 2 步查链。另外在浏览器 DevTools → Security 面板确认没有 Mixed Content 警告,并把第 5 步的到期检查接入监控:Prometheus 的 blackbox_exporter 直接提供 probe_ssl_earliest_cert_expiry 指标,比人工巡检可靠得多。

常见问题

通配符证书 *.example.com 能保护 a.b.example.com 吗?

不能。通配符只匹配一级子域,*.example.com 覆盖 www.example.com、api.example.com,但不覆盖 a.b.example.com,也不覆盖裸域 example.com 本身。所以申请时通常要同时提交 -d example.com -d "*.example.com"。如果业务确实有多级子域,需要单独为 *.b.example.com 再签一张证书,或改用多域名 SAN 证书。

免费的 Let’s Encrypt 和几百元一年的 DV 证书有区别吗?

在加密强度和浏览器信任上没有任何区别,两者都是 DV 级别、都受同一批根证书信任。差异在于:Let’s Encrypt 有效期只有 90 天,必须自动化续期;部分商业 DV 支持更长有效期(上限仍是 398 天)、提供发票与工单支持、支持通配符与多域名灵活组合。如果服务器能跑 acme.sh/certbot 且 80 或 DNS API 可用,免费证书完全够用。

证书有效期为什么是 398 天而不是一年?

398 天是 CA/Browser Forum 基线要求与 Apple、Chrome、Mozilla 根证书策略共同强制的结果,目的是缩短密钥泄露的暴露窗口,同时给 365 天留出续期缓冲。任何声称“三年期、五年期”的报价,实际交付的都是需要按期更换的多张证书。按 SC-081 时间表,2026 年 3 月 15 日起降为 200 天,2027 年 3 月 15 日起降为 100 天。

换完证书必须重启 Nginx 吗?

不需要重启,用 nginx -t && nginx -s reload 平滑重载即可,连接不会中断。restart 会造成瞬时 502。自动化续期时务必把 reload 命令写进 --deploy-hook 或 acme.sh 的 --reloadcmd,否则新证书不会生效。可以用 openssl s_client 对比 notAfter 是否已更新来确认。

微信小程序、公众号一定需要 HTTPS 吗?

是。小程序所有网络请求强制 HTTPS,且要求 TLS 1.2 及以上、证书链完整、不能使用自签名证书;公众号网页授权、支付回调同样要求 HTTPS 域名并需在后台配置。iOS 的 ATS 默认也禁止明文 HTTP。这也是“桌面浏览器正常、小程序却报 request:fail”的常见原因——多半是中间证书缺失。

证书部署后浏览器仍提示不安全怎么办?

按顺序排查四点:一看证书链是否完整(openssl s_client ... | grep "Verify return code" 必须为 0);二看页面是否还有 http 资源,DevTools → Console 会打印 Mixed Content 警告;三看是否被 CDN/WAF 缓存了旧证书,需要在 CDN 控制台重新上传并刷新;四看系统时间,客户端时间偏差超过证书有效期范围同样会报错。

内容审核

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