网站 HTTPS 证书配置实战:单域名、多域名与通配符 SSL 证书申请、部署、排错
问题背景与根因:为什么 HTTPS 证书配置总踩坑
网站从 HTTP 切换到 HTTPS,本质是让浏览器用 TLS 建立加密通道,再通过 CA 签发的 SSL 证书验证服务器身份。没有证书或证书链不完整时,浏览器会提示不安全,小程序、支付回调、现代浏览器和搜索引擎也会限制。原文把重点放在购买须知,但真实落地常见问题集中在四类:一是把单域名证书、多域名证书、通配符证书混为一谈;二是误以为证书默认一年有效,忽视公开信任 TLS 证书单次最长 398 天、Let’s Encrypt 仅 90 天;三是只部署叶子证书,漏掉中间证书,导致 curl 报 unable to get local issuer certificate;四是通配符证书未用 DNS-01 验证,或误以为 *.example.com 能覆盖 example.com 和多级子域名。根因是证书选型、SAN 字段、验证方式、证书链、续期自动化没有形成闭环。本文按“选型→CSR/私钥→签发→Nginx/Apache 部署→排错→验证”的顺序给出可直接执行的命令。关键词覆盖网站HTTPS CA证书配置、SSL证书、HTTPS、通配符SSL证书、单域名证书、https泛解析和http加密。多站点共用 IP 时还依赖 SNI,旧客户端可能拿到默认站点证书;证书与私钥权限、防火墙 443、CDN 回源协议也常被忽略。
证书类型与有效期:单域名、多域名、通配符、DV/OV/EV 怎么选
按覆盖范围分,单域名证书只保护一个主机名,但可在 SAN 中同时写入 example.com 和 www.example.com;多域名证书通过 SAN 保护多个不同域名,数量受 CA 限制;通配符证书以 *.example.com 保护同一层级的一个子域名,不自动包含主域名 example.com,也不匹配 a.b.example.com。若业务有 https 泛解析,应在同一张证书 SAN 中写 DNS:*.example.com 和 DNS:example.com。按验证等级分,DV 只验证域名控制权,通常几分钟签发;OV 需验证组织信息,常见 1-5 个工作日;EV 审核更严,但主流浏览器已不再在地址栏直接展示公司名称,企业名称只能在证书详情中查看,不能把 EV 当作地址栏品牌展示手段。有效期必须修正:CA/Browser Forum 规则下,公开信任 TLS 证书单次有效期最长 398 天,Let’s Encrypt 为 90 天,不存在“默认一年且不用管续期”的安全做法。个人站点、API、内部测试优先 DV;需要展示组织主体信息选 OV;金融、电商等高合规场景再评估 EV,并配合自动化续期、监控和密钥管理。证书类型不是越贵越好,覆盖范围和自动化能力更关键。
完整实操步骤:生成私钥、CSR 并用 DNS-01 签发通配符证书
先准备域名管理权限和服务器时间同步,执行 timedatectl 确认 NTP 正常。以下以 example.com 和 *.example.com 为例。生成 ECDSA 私钥与 CSR:
mkdir -p /etc/nginx/ssl/example.com && cd /etc/nginx/ssl/example.com
openssl ecparam -genkey -name prime256v1 -out example.com.key
openssl req -new -key example.com.key -out example.com.csr -subj '/C=CN/ST=Beijing/L=Beijing/O=Example/CN=*.example.com' -addext 'subjectAltName=DNS:*.example.com,DNS:example.com'
chmod 600 example.com.key
openssl req -in example.com.csr -noout -text | grep -A1 'Subject Alternative Name'
输出应包含 DNS:*.example.com 和 DNS:example.com。若 CA 要求 RSA,可用 openssl req -new -newkey rsa:2048 -nodes -keyout example.com.key -out example.com.csr -subj '/C=CN/ST=Beijing/L=Beijing/O=Example/CN=*.example.com' -addext 'subjectAltName=DNS:*.example.com,DNS:example.com'。使用 Let’s Encrypt 手动 DNS 验证:
sudo certbot certonly --manual --preferred-challenges dns --cert-name example.com -d example.com -d '*.example.com'
按提示在 DNS 添加 TXT 记录,主机记录为 _acme-challenge.example.com,值为终端给出的随机串。用 dig TXT _acme-challenge.example.com +short 或 nslookup -type=TXT _acme-challenge.example.com 确认生效后再回车。acme.sh 也可执行:curl https://get.acme.sh | sh -s email=admin@example.com,再执行 ~/.acme.sh/acme.sh --issue --dns -d example.com -d '*.example.com' --yes-I-know-dns-manual-mode-enough-go-ahead-please,添加 TXT 后用 --renew 完成。生产环境不要长期用手动 DNS,应改用 DNS API 插件或 certbot DNS 插件,否则无法自动续期。签发后得到 fullchain.pem、privkey.pem、cert.pem、chain.pem,部署时使用 fullchain.pem 和私钥。
配置示例:Nginx 与 Apache 正确加载证书链
Nginx 必须让 ssl_certificate 指向包含叶子证书和中间证书的 fullchain.pem,ssl_certificate_key 指向私钥。示例:
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/privkey.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;
ssl_trusted_certificate /etc/nginx/ssl/example.com/fullchain.pem;
resolver 223.5.5.5 119.29.29.29 valid=300s;
add_header Strict-Transport-Security 'max-age=31536000; includeSubDomains' always;
}
server {
listen 80;
server_name example.com *.example.com;
return 301 https://$host$request_uri;
}
执行 nginx -t 通过后 systemctl reload nginx。Nginx 1.25.1 起更推荐 listen 443 ssl; 加 http2 on;。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/privkey.pem
SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1
SSLCipherSuite HIGH:!aNULL:!MD5
Header always set Strict-Transport-Security 'max-age=31536000'
</VirtualHost>
Apache 2.4 若 fullchain.pem 已含中间证书,SSLCertificateFile 指向 fullchain 即可;旧版本才需要 SSLCertificateChainFile 指向 chain.pem。执行 apachectl configtest 后重载 httpd。注意:*.example.com 只覆盖一级子域名,server_name 可以写通配,但证书不匹配多级域名时浏览器仍报错;HSTS 首次上线建议先用较短 max-age 验证。
对比表格:证书覆盖范围、验证等级与有效期
选型时先看覆盖范围,再看验证等级,最后看运维能力。下表把单域名、多域名、通配符与 DV/OV/EV 放在同一张表中对比。注意通配符证书的“泛解析”只解决同一级子域名签发问题,不等于自动覆盖主域名和多级子域名;多域名证书的 SAN 数量、是否支持通配符 SAN 取决于 CA 产品。有效期方面,公开信任 TLS 证书单次最长 398 天,Let’s Encrypt 90 天,OV/EV 同样受 398 天限制。EV 不再在 Chrome 等主流浏览器地址栏显示公司名,不能作为地址栏品牌展示卖点。
| 对比项 | 单域名 DV | 多域名 SAN | 通配符证书 | OV/EV |
|---|---|---|---|---|
| 覆盖范围 | 一个主机名,可在 SAN 加 www | 多个不同域名,数量受 CA 限制 | *.example.com 一级子域名,可加 example.com 到 SAN | 按产品覆盖,验证组织主体 |
| 验证方式 | HTTP-01 或 DNS-01 | HTTP-01/DNS-01,OV 增加组织验证 | 通常必须 DNS-01 | 组织验证,EV 更严格 |
| 典型签发 | 几分钟 | 几分钟到数个工作日 | 几分钟到数个工作日 | 1-5 个工作日或更久 |
| 有效期 | 最长 398 天,LE 90 天 | 最长 398 天 | 最长 398 天 | 最长 398 天 |
| 适用场景 | 个人站、API、测试 | 多品牌、多域名门户 | https 泛解析、SaaS 子域名 | 需展示组织信息、高合规 |
| 主要风险 | 漏配 www 或多域名 | SAN 漏写、续期遗漏 | 误判多级覆盖、DNS 验证失败 | 审核周期长、成本高 |
如果业务是 www.example.com、api.example.com、admin.example.com 这类同级子域名,通配符证书最省事;如果还有 example.com 主域名,必须在 SAN 中显式加入。若子域名跨多个层级,如 a.b.example.com,通配符 *.example.com 不匹配,应单独签发或使用多域名证书。个人博客和一般企业官网用 DV 即可;需要证书详情体现公司主体时选 OV;EV 仅在合规或采购要求时评估。
常见错误排查:真实报错与修复命令
第一类,Nginx 启动报 nginx: [emerg] SSL_CTX_use_PrivateKey ... key values mismatch,说明证书与私钥不匹配。RSA 用 openssl x509 -noout -modulus -in fullchain.pem | openssl md5 与 openssl rsa -noout -modulus -in privkey.pem | openssl md5 对比,两者必须一致;ECDSA 用 openssl pkey -in privkey.pem -pubout 与 openssl x509 -in fullchain.pem -pubkey -noout 对比。第二类,curl: (60) SSL certificate problem: unable to get local issuer certificate,多为只部署叶子证书,缺少中间证书。把 CA 提供的 fullchain.pem 配到 ssl_certificate 或 SSLCertificateFile,不要只配 cert.pem。第三类,浏览器报 NET::ERR_CERT_COMMON_NAME_INVALID,是 SAN 不含当前域名,或通配符层级不匹配。用 openssl x509 -in fullchain.pem -noout -ext subjectAltName 检查,重新签发时加入正确 DNS 名称。第四类,acme.sh 提示需要添加 TXT 或验证 pending,检查 dig TXT _acme-challenge.example.com +short 是否返回随机串,DNS 缓存未生效时等待 TTL;同一名称多条 TXT 要全部保留。第五类,Let’s Encrypt 报 too many failed authorizations recently,是失败频率限制,先修 DNS/防火墙,再用 certbot renew --dry-run 演练,等待限制窗口结束。第六类,SSL_ERROR_RX_RECORD_TOO_LONG 通常是 HTTPS 访问到了 HTTP 端口,或反代后端协议写错,检查 ss -lntp | grep 443 与 Nginx listen 是否带 ssl。
- Wildcard 通配符 SSL 证书安装部署续费申请
- 代购 SSL 证书 · DigiCert / GeoTrust / RapidSSL 单域名与通配符
- SSL证书申请 · SSL证书购买 · SSL证书安装配置
自动化续期与密钥管理:避免 90 天证书过期
Let’s Encrypt 证书只有 90 天,公开信任证书最长 398 天,手工续期迟早过期。certbot 安装后通常自带 systemd timer,执行 systemctl list-timers | grep certbot 查看,执行 certbot renew --dry-run 验证续期链路。生产续期后要重载服务,可写 deploy hook:certbot renew --deploy-hook 'systemctl reload nginx',或在 renewal 配置中设置 renew_hook = systemctl reload nginx。acme.sh 用 ~/.acme.sh/acme.sh --cron 加入 crontab,执行 crontab -l | grep acme.sh 确认;安装证书时直接绑定部署路径和重载命令:
~/.acme.sh/acme.sh --install-cert -d example.com -d '*.example.com' --key-file /etc/nginx/ssl/example.com/privkey.pem --fullchain-file /etc/nginx/ssl/example.com/fullchain.pem --reloadcmd 'systemctl reload nginx'
密钥权限必须 chmod 600 privkey.pem,属主为 root 或运行服务的受控账户,不要把私钥提交到 Git,也不要把 fullchain 和私钥放在 Web 根目录。通配符证书必须使用 DNS-01,自动续期应使用 DNS API 插件,例如 acme.sh 的 dns_ali、dns_cf、dns_dp 等,certbot 对应 DNS 插件;手动 TXT 只适合临时验证。建议加监控:openssl x509 -in fullchain.pem -noout -checkend 2592000,返回 0 表示 30 天内不过期,返回 1 应告警。证书透明日志和到期告警应同时配置。
效果验证:用 openssl、curl 和 SSL Labs 验收
部署后不要只看浏览器绿锁。先查证书主体、签发者、有效期和 SAN:
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null | openssl x509 -noout -subject -issuer -dates -ext subjectAltName
预期能看到 subject=CN = example.com,issuer 为对应 CA,notAfter 在有效期内,SAN 包含 DNS:example.com 和 DNS:*.example.com。再验证证书链和主机名:
curl -vI https://example.com 2>&1 | grep -E 'SSL certificate verify|HTTP/'
openssl s_client -connect example.com:443 -servername example.com -showcerts 2>/dev/null | grep -E 's:|i:'
curl 应出现 SSL certificate verify ok 和 HTTP/2 200 或 HTTP/1.1 200。检查 TLS 1.0/1.1 已关闭:openssl s_client -connect example.com:443 -servername example.com -tls1_1 应握手失败;-tls1_2 和 -tls1_3 应成功。检查续期余量:openssl x509 -in /etc/nginx/ssl/example.com/fullchain.pem -noout -checkend 2592000; echo $?。检查端口监听:ss -lntp | grep ':443'。最后用 SSL Labs 或 testssl.sh 做外部评分,目标至少 A;若只有 A 以下,常见原因是缺中间证书、支持 TLS 1.0/1.1、弱套件或未开 HSTS。HSTS 上线前确认全站 HTTPS 和子域名都可用,否则 includeSubDomains 会把未加密子域名锁死。
常见问题
通配符证书能覆盖 example.com 和 a.b.example.com 吗?
不能。*.example.com 只匹配 example.com 下一级的一个子域名,如 www.example.com、api.example.com;不匹配主域名 example.com,也不匹配 a.b.example.com。需要主域名时在 SAN 中显式加入 DNS:example.com;多级子域名需单独签发或改用多域名证书。
证书有效期为什么不是一年?
公开信任 TLS 证书受 CA/Browser Forum 规则约束,单次有效期最长 398 天;Let’s Encrypt 为 90 天。原文“默认一年”已过时。必须配置自动续期、重载和到期监控,不能依赖手工续费。
DV、OV、EV 应该怎么选?
个人站、API、一般企业官网优先 DV,签发快、成本低;需要证书详情展示组织信息选 OV;EV 审核更严,但主流浏览器已不在地址栏显示公司名,只有合规或采购明确要求时再选。
通配符证书为什么必须用 DNS 验证?
CA/B 规则要求通配符证书使用 DNS-01 验证域名控制权,即在 _acme-challenge.example.com 添加 TXT 记录。HTTP-01 不能签发通配符证书。生产环境应使用 DNS API 插件实现自动续期。
已经只配了 cert.pem,为什么浏览器和 curl 都报错?
因为缺少中间证书,信任链不完整。Nginx 的 ssl_certificate 和 Apache 的 SSLCertificateFile 应指向 fullchain.pem,其中包含叶子证书和中间证书;私钥单独放在 privkey.pem,并设置 600 权限。
证书链和私钥如何备份与轮换?
备份 fullchain.pem、privkey.pem 和续期配置,私钥加密存储并限制访问;轮换时先签发新证书、nginx -t 或 apachectl configtest 验证,再平滑重载。不要把私钥放入代码仓库或公开工单。