SSL 证书申请与部署实战:CSR 生成、证书链拼接、Nginx 配置与真实报错排查
问题背景与根因:证书装了却仍然“不安全”的三个原因
浏览器地址栏的“不安全”提示,根因很少是“没装证书”,而是 TLS 握手时以下三个条件之一不成立:
- 信任链不完整:服务器只下发了域名证书,没有下发中间证书(Intermediate CA),客户端无法把证书链回溯到内置根证书。
- 域名不匹配:证书 SAN(Subject Alternative Name)字段里没有当前访问的域名,例如只签了
example.com却用www.example.com访问。 - 有效期或时间问题:证书已过期,或服务器时间漂移超出证书有效期窗口。
同时,HTTP/2 在主流浏览器中只通过 TLS 实现,Service Worker、地理定位、摄像头、剪贴板等 Web API 都要求 secure context,因此“全站 HTTPS”已经是功能前提而非可选项。
还要纠正两个常见的过时认知:一是公开可信 TLS 证书的最长有效期自 2020-09-01 起为 398 天,CA/B Forum 已通过 SC-081 确定从 2026-03-15 起降为 200 天、2027-03-15 降为 100 天、2029-03-15 降为 47 天;二是 Let’s Encrypt 免费证书固定 90 天,需在剩余 30 天内续期。结论很明确:手工买证书、手工换证书的方式不可持续,必须把签发与续期自动化。
先用两条命令确认现状:
curl -sI http://example.com | head -n 3
openssl s_client -connect example.com:443 -servername example.com /dev/null | openssl x509 -noout -subject -issuer -dates
第一条看是否 301 跳转到 https,第二条直接读出证书的 Subject(域名)、Issuer(签发 CA)与 notBefore/notAfter(有效期)。
证书选型:DV/OV/EV 与单域名/通配符/多域名怎么选
| 类型 | 验证内容 | 签发时长 | 浏览器表现 | 典型场景 |
|---|---|---|---|---|
| DV(域名验证) | 仅验证域名控制权(DNS TXT / HTTP 文件 / 邮箱) | 分钟级 | 地址栏锁标 | 博客、API、内部系统、SaaS 默认域名 |
| OV(组织验证) | 域名 + 企业工商信息人工核验 | 1–3 个工作日 | 锁标,点开证书详情可见企业名 | 企业官网、电商、对公业务 |
| EV(扩展验证) | OV + 更严格的主体审查 | 3–7 个工作日 | Chrome 自 2019 年起已取消绿色地址栏,仅证书详情可见 | 金融、招投标合规要求 |
按覆盖范围再分三类,这是最容易踩坑的地方:
| 覆盖方式 | 示例 | 覆盖范围 | 说明 |
|---|---|---|---|
| 单域名 | example.com | 1 个 FQDN | www 与裸域算两个不同域名 |
| 多域名(SAN/UCC) | example.com + www.example.com + api.example.com | 默认 5–100 个 FQDN | 具体数量取决于 CA 套餐 |
| 通配符 | *.example.com | 仅一级子域 | 不覆盖 example.com 本身,也不覆盖 a.b.example.com |
选择逻辑:子域名数量多且动态增加(多租户、多环境)→ 通配符 + 裸域 SAN;只有 www 和裸域 → 单域名双 SAN 的免费证书足够;需要向客户展示企业主体 → OV。费用上,Let’s Encrypt 免费但 90 天;付费 DV 每年约百元级;OV/EV 通常千元以上;国内云厂商的通配符 DV 约 1000–3000 元/年。注意:DV 与 OV 在“是否加密”上没有区别,加密强度由密钥长度与协议版本决定,与证书等级无关。
实操第一步:生成私钥与 CSR(可直接执行)
无论从哪家 CA 购买,都先在服务器上生成私钥和 CSR,私钥绝不出服务器。
mkdir -p /etc/ssl/private/example.com && cd /etc/ssl/private/example.com
# RSA 2048,兼容性最好
openssl genpkey -algorithm RSA -pkeyopt rsa_keygen_bits:2048 -out example.com.key
# 或 ECDSA P-256,握手更快、体积更小
# openssl ecparam -genkey -name prime256v1 -out example.com.key
chmod 600 example.com.key && chown root:root example.com.key
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:www.example.com"
关键点:CN 字段已不被主流浏览器采信,域名必须写进 SAN,否则报 ERR_CERT_COMMON_NAME_INVALID。生成后自查:
openssl req -in example.com.csr -noout -text | grep -A1 "Subject Alternative Name"
# 期望输出:DNS:example.com, DNS:www.example.com
openssl req -in example.com.csr -noout -verify -key example.com.key
拿到证书后必须验证证书与私钥匹配,这一步能提前避免 90% 的 nginx 启动失败:
openssl x509 -noout -modulus -in example.com.crt | openssl md5
openssl rsa -noout -modulus -in example.com.key | openssl md5
# 两行 md5 必须完全一致;ECDSA 证书改用:
# openssl x509 -noout -pubkey -in example.com.crt | openssl md5
# openssl pkey -pubout -in example.com.key | openssl md5
把 CSR 交给 CA,OV/EV 还需提交营业执照、电话回访等材料。签发完成后会拿到两个文件:域名证书(如 example.com.crt)与中间证书(ca_bundle.crt 或 chain.crt),两者要按“域名证书在前、中间证书在后”的顺序拼成 fullchain。
实操第二步:用 ACME 自动签发与续期
手工签发无法应对 90 天甚至未来 47 天的短周期,用 ACME 客户端自动化。安装 acme.sh(纯 Shell,无依赖):
curl https://get.acme.sh | sh -s email=admin@example.com
source ~/.bashrc
acme.sh --set-default-ca --server letsencrypt
两种验证方式:HTTP-01 需 80 端口可从公网访问;DNS-01 通过添加 TXT 记录验证,是签发通配符证书的唯一方式。以阿里云 DNS 为例:
export Ali_Key="LTAI5t******"
export Ali_Secret="******"
acme.sh --issue -d example.com -d '*.example.com' --dns dns_ali --keylength ec-256
用 webroot 方式签发普通域名:
acme.sh --issue -d example.com -d www.example.com -w /var/www/html
签发成功后安装证书并注册续期钩子(acme.sh 会自动写入 crontab,每天检查,剩余 30 天时续期):
acme.sh --install-cert -d example.com --ecc
--key-file /etc/nginx/ssl/example.com.key
--fullchain-file /etc/nginx/ssl/fullchain.pem
--reloadcmd "systemctl reload nginx"
crontab -l | grep acme
若使用 certbot:
certbot certonly --webroot -w /var/www/html -d example.com -d www.example.com --deploy-hook "systemctl reload nginx"
certbot renew --dry-run # 演练续期,不消耗速率限制
注意 Let’s Encrypt 的速率限制:同一注册域名每周 50 张、重复证书每周 5 张。调试时务必加 --staging 参数,否则很容易触发 too many certificates already issued 而被迫等待一周。
- 代购 SSL 证书 · DigiCert / GeoTrust / RapidSSL 单域名与通配符
- SSL证书申请 · SSL证书购买 · SSL证书安装配置
- SSL域名证书申请 · 小程序证书 · 国外SSL证书
配置示例:Nginx 与 Apache 的 HTTPS 最佳实践
Nginx(1.25.1 起用 http2 on;,旧的 listen 443 ssl http2; 已废弃):
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;
ssl_certificate /etc/nginx/ssl/fullchain.pem;
ssl_certificate_key /etc/nginx/ssl/example.com.key;
ssl_protocols TLSv1.2 TLSv1.3;
ssl_ciphers ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305;
ssl_prefer_server_ciphers off;
ssl_session_cache shared:SSL:10m;
ssl_session_timeout 1d;
ssl_session_tickets off;
ssl_stapling on;
ssl_stapling_verify on;
ssl_trusted_certificate /etc/nginx/ssl/chain.pem;
resolver 223.5.5.5 1.1.1.1 valid=300s;
add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
}
改完执行 nginx -t && systemctl reload nginx。ssl_trusted_certificate 指向中间证书(不含域名证书),OCSP Stapling 才能真正生效;HSTS 建议先用 max-age=300 试运行,确认所有子域都能上 HTTPS 再改回一年,否则回滚困难。
Apache 2.4.8+ 只需两个指令,中间证书拼进 SSLCertificateFile:
<VirtualHost *:443>
ServerName example.com
SSLEngine on
SSLCertificateFile /etc/httpd/ssl/fullchain.pem
SSLCertificateKeyFile /etc/httpd/ssl/example.com.key
# Apache < 2.4.8 才需要单独指定:
# SSLCertificateChainFile /etc/httpd/ssl/chain.pem
SSLProtocol -all +TLSv1.2 +TLSv1.3
SSLCipherSuite ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256
SSLHonorCipherOrder off
Header always set Strict-Transport-Security "max-age=31536000"
</VirtualHost>
证书链:90% 的“部分设备打不开”都出在这里
TLS 握手时服务器要下发“域名证书 + 中间证书”,客户端用内置根证书校验。若只发域名证书,桌面 Chrome 往往能靠 AIA 自动补链而“看起来正常”,但 Android 旧版本、Java、微信内置浏览器、curl、Python requests 会直接失败。因此生产环境一律使用 fullchain:
cat example.com.crt chain.crt > fullchain.pem
openssl crl2pkcs7 -nocrl -certfile fullchain.pem | openssl pkcs7 -print_certs -noout
线上实际下发的证书链用这条命令查看,顺序应为 0 s:example.com → 1 s:中间CA:
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | grep -E "^ [0-9] s:|i:"
openssl s_client -connect example.com:443 -servername example.com -verify_return_error </dev/null
# 期望末尾出现:Verify return code: 0 (ok)
三个原则:不要放根证书(多余且增大握手包,部分客户端会判为无效链);顺序不能颠倒;换 CA 后必须整链替换。若 CA 没有提供中间证书,可从证书的 AIA 字段抓取:
openssl x509 -in example.com.crt -noout -text | grep -A4 "Authority Information Access"
# 输出中的 CA Issuers - URI 即为中间证书下载地址
curl -sO http://.../ca.crt
很多“桌面端正常、手机端白屏”的工单,本质就是证书链问题,而不是网络或 CDN 问题。上线前用 -verify_return_error 跑一遍,能把问题挡在发布之前。
常见错误排查:真实报错与对应修复
| 报错原文 | 根因 | 修复 |
|---|---|---|
curl: (60) SSL certificate problem: unable to get local issuer certificate |
服务端缺中间证书,或客户端 CA 库过旧 | 服务端改用 fullchain.pem;客户端 apt install ca-certificates && update-ca-certificates |
NET::ERR_CERT_COMMON_NAME_INVALID / SSL_ERROR_BAD_CERT_DOMAIN |
证书 SAN 不含当前域名,或通配符不覆盖多级子域 | openssl x509 -in fullchain.pem -noout -text | grep DNS: 核对后重新签发 |
NET::ERR_CERT_AUTHORITY_INVALID |
自签证书,或证书链中夹带了错误的根证书 | 移除根证书,改用公有 CA 签发 |
NET::ERR_CERT_DATE_INVALID |
证书过期或服务器时间漂移 | timedatectl status、chronyc tracking,并检查续期任务是否执行 |
nginx: [emerg] SSL_CTX_use_PrivateKey_file(...) failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch) |
证书与私钥不配对 | 用上文 modulus / pubkey 的 md5 比对,重新匹配文件 |
nginx: [emerg] PEM_read_bio_X509_AUX(...) failed (SSL: error:0909006C:PEM routines:get_name:no start line) |
证书文件被编辑器加了 BOM/CRLF,或误下载成 HTML 页面 | head -n1 fullchain.pem 应为 -----BEGIN CERTIFICATE-----;sed -i 's/r$//' fullchain.pem |
Verify error:Invalid response from http://example.com/.well-known/acme-challenge/xxx: 404 |
webroot 路径不对、伪静态拦截或 CDN 回源异常 | 临时关闭 rewrite,确认 .well-known 可访问;或改用 DNS-01 |
sslv3 alert handshake failure |
客户端仅支持 TLS 1.0/1.1,被服务端禁用 | 核查客户端版本;合规场景不建议回退协议,应升级客户端 |
排查顺序固定为三步:先 openssl s_client -connect host:443 -servername host 看服务端到底下发了什么;再 curl -vI https://host 看客户端报什么;最后对比 openssl x509 -noout -text 中的 SAN 与有效期。90% 的问题在前两步就能定位。
效果验证与续期监控
部署后逐项验证,不要只看浏览器地址栏:
# 1. HTTP 强制跳转
curl -sI http://example.com | grep -iE "^HTTP|^location"
# 2. 证书信息与有效期
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null | openssl x509 -noout -subject -issuer -dates
# 3. 协议版本,TLS 1.1 应握手失败
echo | openssl s_client -connect example.com:443 -tls1_1 2>&1 | grep -i "alert|error"
# 4. 证书链完整性
openssl s_client -connect example.com:443 -servername example.com -verify_return_error </dev/null
# 5. HSTS 是否生效
curl -sI https://example.com | grep -i "strict-transport-security"
把到期检查写进监控脚本,openssl x509 -checkend 在剩余时间小于阈值时返回非 0:
#!/bin/bash
CERT=/etc/nginx/ssl/fullchain.pem
if ! openssl x509 -checkend 1209600 -noout -in "$CERT"; then # 14 天
echo "CRITICAL: $CERT 将在 14 天内过期" | mail -s "证书告警" ops@example.com
fi
自动化续期确认:acme.sh 会写入 crontab(--cron 每天执行一次);certbot 由 systemd timer 驱动,用 systemctl list-timers | grep certbot 与 certbot certificates 核对剩余天数。最后用 SSL Labs 跑一次全量评分,目标 A/A+:若因 TLS 1.0/1.1、RC4、3DES 被降级,按上文 ssl_protocols、ssl_ciphers 收敛即可。
常见问题
不能。*.example.com 只匹配一级子域,如 www、api、mail,既不包含裸域 example.com,也不匹配多级子域 a.b.example.com。签发时需把裸域作为额外 SAN 一起提交,多级子域则需单独签发或改用多域名证书。
公开可信 TLS 证书目前最长 398 天,自 2020-09-01 起生效。按 CA/B Forum SC-081,2026-03-15 起降为 200 天,2027-03-15 起 100 天,2029-03-15 起 47 天。Let’s Encrypt 免费证书固定 90 天,需在剩余 30 天内完成自动续期。
免费 DV 与付费 DV 在加密强度和浏览器锁标上没有区别,都使用同一套 TLS 协议与加密套件。差异在有效期(90 天 vs 398 天)、保险赔付、技术支持、是否支持通配符与多域名,以及 OV/EV 会核验企业主体信息。
按三步定位:用 openssl s_client 看服务端下发的证书链是否完整、SAN 是否含当前域名;用 curl -vI 看客户端具体错误码;用 date -u 检查服务器时间。最常见原因是只部署了域名证书没拼中间证书,或用 www 访问但证书只含裸域。
可以用一张多域名 SAN 证书覆盖所有 FQDN,通常支持 5–100 个;若子域数量多且动态增长,用通配符证书加裸域 SAN 更省事。也可以每个域名一张免费证书,靠 SNI 在同一 IP 上共存,Nginx 写多个 server 块各自配置 ssl_certificate 即可。
把 fullchain.pem(含中间证书)与私钥一起复制,权限设为 600、属主 root;在新机器上用 openssl x509 -noout -modulus 与私钥比对确认配对,再执行 nginx -t 校验。若用 acme.sh,复制整个 ~/.acme.sh 目录并重跑 –install-cert 恢复续期钩子。