SSL 证书申请与管理全流程:从 CSR 生成、域名验证到 Nginx 部署与报错排查
问题背景与根因:HTTP 明文传输到底暴露了什么
当浏览器地址栏出现“不安全”红色警告,或 Chrome 抛出 NET::ERR_CERT_DATE_INVALID,绝大多数情况是 SSL/TLS 链路在某个环节断了。HTTP 明文意味着链路上的任何一跳——公共 Wi-Fi、运营商、反向代理——都能读取和篡改内容:Cookie 被窃取、登录表单被注入钓鱼脚本、下载的安装包被替换。除此之外,现代 Web 平台把大量能力绑定在安全上下文上:HTTP/2 与 HTTP/3 在浏览器中只对 HTTPS 生效,Service Worker、地理位置、摄像头、剪贴板 API 都要求 window.isSecureContext 为 true;微信小程序、Apple ATS、PCI DSS、等保 2.0 也都把 HTTPS 作为硬性前提。
把“证书问题”拆开,根因只有五类:
- 根本没有证书:80 端口直接返回 200,或 443 端口未监听。
- 证书过期:公有信任证书最长有效期 398 天(2026-03-15 起缩短为 200 天),Let’s Encrypt 只有 90 天,忘记续期是最常见故障。
- 证书链不完整:只部署了叶子证书、没带中间证书,桌面浏览器靠 AIA 自动补齐能过,Android、Java、curl、Go 直接握手失败。
- 域名不匹配:证书 SAN 里没有
www.example.com,或通配符*.example.com不覆盖a.b.example.com。 - 混合内容:页面是 HTTPS,但图片、脚本仍走
http://,被浏览器降级拦截。
先做一次 30 秒体检,再决定是申请新证书还是修配置:
curl -sSI http://example.com | head -n 5
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null | openssl x509 -noout -subject -issuer -dates
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null | grep -E 'Verify return code|depth'
第一条看是否 301 到 HTTPS;第二条读 notAfter 判断是否过期;第三条必须出现 Verify return code: 0 (ok),若出现 unable to get local issuer certificate,就是缺中间证书。
证书选型与有效期新规:DV / OV / EV 与 398 天上限
选型只需回答三个问题:验证级别、覆盖域名数量、是否需要通配符。
| 类型 | 验证内容 | 签发时长 | 典型用途 | 浏览器表现 |
|---|---|---|---|---|
| DV 域名型 | 仅验证域名控制权(DNS TXT / HTTP 文件 / 邮件) | 分钟级 | 博客、API、内部测试、SaaS 边缘 | 显示锁标志 |
| OV 企业型 | 营业执照 + 电话回拨核验 | 1-3 个工作日 | 企业官网、电商、对外门户 | 锁标志,证书详情显示企业名 |
| EV 增强型 | 严格企业法律实体核验 | 3-7 个工作日 | 金融、政企、支付 | 锁标志,证书详情显示企业名(Chrome 自 2019 起不再显示绿色地址栏) |
关于有效期,这是最容易被旧文章误导的地方:CA/Browser Forum 的 SC-17 决议自 2020-09-01 起,所有公有信任 TLS 证书有效期上限为 398 天(含签发当天),Apple、Chrome、Mozilla 会直接拒绝超期证书。SC-081 进一步规定:2026-03-15 起上限降到 200 天,2027-03-15 起 100 天,2029-03-15 起 47 天。Let’s Encrypt 一直固定 90 天,且免费证书不支持 OV/EV。
覆盖范围上,单域名证书只保护一个 FQDN;多域名(SAN/UCC)证书可在一张证书里写入多个域名,适合多站点共用;通配符 *.example.com 只覆盖一级子域,既不覆盖 example.com 本身(需同时写进 SAN),也不覆盖 a.b.example.com。通配符证书通常只能做 DV 验证。
另一个常被忽略的点是密钥算法:RSA 2048 兼容性最好;ECDSA P-256 握手更快、证书更小,但极老的 Android 4.x 与 Windows XP 不支持。国内业务若需国密合规,还要考虑 SM2 双证书部署,这需要国密网关或 Nginx 国密分支支持,不能直接用标准 OpenSSL 签发。
第一步:生成私钥与 CSR(命令可直接执行)
CSR(Certificate Signing Request)只包含公钥和主体信息,私钥永远不离开自己的服务器。先收紧目录权限——私钥一旦泄露,证书等同作废,必须吊销重签。
mkdir -p /etc/nginx/ssl && chmod 700 /etc/nginx/ssl
cd /etc/nginx/ssl
# RSA 2048(兼容性优先)
openssl req -new -newkey rsa:2048 -nodes
-keyout example.com.key -out example.com.csr
-subj '/C=CN/ST=Beijing/L=Beijing/O=Example Ltd/CN=example.com'
-addext 'subjectAltName=DNS:example.com,DNS:www.example.com'
# ECDSA P-256(性能优先)
openssl ecparam -genkey -name prime256v1 -out example.com.key
openssl req -new -key 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
三个必须检查的点:
- CN 已不被浏览器采纳,真正生效的是 SAN 扩展。上面的
-addext需要 OpenSSL 1.1.1 及以上;老版本要写临时配置文件用-config指定subjectAltName。 - 核对 CSR 内容:
openssl req -in example.com.csr -noout -text | grep -A1 'Subject Alternative Name',确认域名没写错、没有多余空格。 - 私钥与 CSR 匹配:
openssl req -noout -modulus -in example.com.csr | openssl md5与openssl rsa -noout -modulus -in example.com.key | openssl md5输出必须一致;EC 密钥改用openssl pkey -pubout比对。
把 example.com.csr 全文(含 BEGIN/END 行)提交给 CA。私钥不要发给任何人,也不要提交进 Git 仓库;如果 CSR 泄露,最坏结果只是别人知道你要签哪些域名,风险可控,但私钥泄露必须立即吊销证书。
第二步:域名验证与证书签发(HTTP-01 / DNS-01 实操)
CA 签发前必须确认你控制该域名,主流方式两种:
| 方式 | 前置条件 | 支持通配符 | 适用场景 |
|---|---|---|---|
| HTTP-01 | 80 端口公网可达,/.well-known/acme-challenge/ 返回 token |
否 | 单域名、常规 Web 站点 |
| DNS-01 | 能通过 API 或手动添加 TXT 记录 _acme-challenge.example.com |
是 | 通配符证书、CDN 后站点、内网域名 |
手动验证最容易踩的坑:80 端口被 CDN/WAF 拦截;nginx 把 /.well-known/ 重写到首页;强制 301 到 HTTPS 但 443 证书尚未配好形成死锁(Let’s Encrypt 允许重定向到 443,但证书必须有效);DNS TXT 存在多条同名记录或 TTL 未过期,读到旧值。
# 检查 CAA 是否放行签发机构
dig +short CAA example.com
# 确认 HTTP-01 路径可访问(应返回 200 且内容为 token)
curl -sS http://example.com/.well-known/acme-challenge/test-token
# 确认 DNS-01 TXT 已生效
dig +short TXT _acme-challenge.example.com @8.8.8.8
推荐直接用 ACME 客户端自动化。certbot 走 webroot:
certbot certonly --webroot -w /var/www/html
-d example.com -d www.example.com
--deploy-hook 'systemctl reload nginx'
acme.sh 走 DNS API(通配符必须用这条):
curl https://get.acme.sh | sh -s email=ops@example.com
export CF_Token='你的Cloudflare API Token'
~/.acme.sh/acme.sh --issue --dns dns_cf -d example.com -d '*.example.com' --keylength ec-256
~/.acme.sh/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'
Let’s Encrypt 的限流必须记住:每个注册域名每周 50 张证书、同一组域名每周 5 张重复证书、每个账号对每个主机名每小时 5 次验证失败。超限会报 too many failed authorizations recently,调试阶段务必加 --staging 或 --dry-run。
第三步:Nginx 与 Apache 部署配置示例
证书到手后,关键是“叶子证书 + 中间证书”按正确顺序拼成 fullchain 部署。
server {
listen 80;
server_name example.com www.example.com;
return 301 https://$host$request_uri;
}
server {
listen 443 ssl;
http2 on; # nginx < 1.25.1 请写 listen 443 ssl http2;
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;
add_header Strict-Transport-Security 'max-age=31536000; includeSubDomains' always;
add_header X-Content-Type-Options 'nosniff' always;
location / { proxy_pass http://127.0.0.1:8080; }
}
几个关键点:ssl_certificate 必须指向 fullchain,顺序反了会让部分客户端握手失败;TLS 1.0/1.1 已被 RFC 8996 正式废弃,2020 年后主流浏览器全部移除支持,不要再开;ssl_stapling on 对 Let’s Encrypt 证书已基本无意义——LE 自 2025 年起逐步关闭 OCSP 响应服务,短周期证书正取代 OCSP 成为吊销状态的主要方案。
Apache 2.4 对应写法:
<VirtualHost *:443>
SSLEngine on
SSLCertificateFile /etc/ssl/certs/fullchain.pem
SSLCertificateKeyFile /etc/ssl/private/example.com.key
SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1
SSLCipherSuite ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256
SSLHonorCipherOrder off
Header always set Strict-Transport-Security 'max-age=31536000'
</VirtualHost>
Apache 2.4.8 起 SSLCertificateFile 可直接指向 fullchain,不再需要 SSLCertificateChainFile(该指令自 2.4.35 起废弃)。改完先 nginx -t 或 apachectl configtest 验证语法,再 reload,不要 restart,避免连接中断。
证书管理与自动续期:90 天证书怎么管
398 天上限、90 天免费证书、未来 47 天的趋势,决定了证书管理必须自动化。三条铁律:续期任务必须有独立监控,不能只依赖 cron 静默失败;续期后必须 reload 服务,否则进程仍加载旧证书;证书与私钥必须有备份和轮换流程。
# certbot 自动续期(systemd timer 默认已启用)
systemctl list-timers | grep certbot
certbot renew --dry-run
# acme.sh 安装时会写入 crontab,确认一下
crontab -l | grep acme.sh
# 全量盘点机器上的证书到期时间
for f in $(find /etc/nginx/ssl /etc/ssl/certs -name '*.pem' -o -name '*.crt' 2>/dev/null); do
echo -n "$f "; openssl x509 -in "$f" -noout -enddate 2>/dev/null || echo 'not a cert'
done
监控侧最简单的做法是把剩余天数交给 Prometheus blackbox_exporter 的 probe_ssl_earliest_cert_expiry,配一条 (probe_ssl_earliest_cert_expiry - time()) / 86400 < 21 的告警规则;没有监控系统就用一条 cron 兜底:
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null
| openssl x509 -noout -checkend 1209600 || echo 'CERT EXPIRES IN 14 DAYS' | mail -s alert ops@example.com
多节点场景不要每台机器各自签发,极易触发限流。正确做法是:一台机器签发,通过 Ansible / Vault / Kubernetes Secret 分发 fullchain 与私钥,分发后统一 reload。私钥轮换时先生成新 key 和新 CSR 重新签发,双证书并行一段时间再切流,避免直接覆盖导致回滚困难。另外建议订阅 CT 日志监控(如 crt.sh 查询 example.com),一旦有人为你的域名签发了非预期证书,能第一时间发现。
常见错误排查:真实报错与定位命令
下面这些报错在实际工单里出现频率最高,按“看到什么 → 说明什么 → 怎么修”处理。
| 报错信息 | 根因 | 处理方式 |
|---|---|---|
NET::ERR_CERT_DATE_INVALID / certificate has expired |
证书过期,或服务器系统时间错误 | openssl x509 -noout -dates;校正 NTP |
SSL_ERROR_BAD_CERT_DOMAIN / no alternative certificate subject name matches |
SAN 中不含访问的域名 | 重签并把该域名写入 SAN |
curl: (60) SSL certificate problem: unable to get local issuer certificate |
缺少中间证书 | 部署 fullchain.pem |
nginx: [emerg] SSL_CTX_use_PrivateKey_file() failed (X509_check_private_key:key values mismatch) |
证书与私钥不配对 | 比对 modulus / pubkey |
sslv3 alert handshake failure |
协议或加密套件无交集 | 检查 ssl_protocols,确认客户端是否只支持 TLS1.0 |
too many failed authorizations recently |
LE 验证失败触发限流 | 改用 --staging 调试,等待 1 小时 |
urn:ietf:params:acme:error:caa |
CAA 记录未授权该 CA | 添加 issue 记录后重试 |
几条通用定位命令:
# 看服务端到底发了什么链
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null
# 验证证书与私钥是否配对
openssl x509 -noout -modulus -in fullchain.pem | openssl md5
openssl rsa -noout -modulus -in example.com.key | openssl md5
# 指定协议版本复现握手失败
openssl s_client -connect example.com:443 -servername example.com -tls1_2
# 检查中间证书是否齐全(应看到至少两级 depth)
openssl s_client -connect example.com:443 -servername example.com 2>/dev/null | grep -E 'depth|verify'
混合内容问题不在证书层面,打开 DevTools Console 会直接列出被拦截的 http:// 资源,或使用 Content-Security-Policy: upgrade-insecure-requests 批量升级。若站点在 CDN 后面,注意证书要同时配在边缘节点和回源链路上,否则会出现“浏览器正常、回源 502”的割裂现象。
效果验证:五步确认 HTTPS 真正生效
部署完成后不要只看浏览器有没有小锁,按下面五步逐层验证。
- 协议与套件:
nmap --script ssl-enum-ciphers -p 443 example.com,确认没有 TLS1.0/1.1、没有 RC4/3DES。 - 证书链:
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null | grep 'Verify return code',必须为0 (ok)。 - 强制跳转:
curl -sSI http://example.com | head -n1应为301,且Location指向 https。 - HTTP/2 与 HSTS:
curl -sSI https://example.com --http2 | grep -i -E 'strict-transport|HTTP/2'。 - 综合评分:
docker run --rm -it ssllabs/ssllabs-scan --grade example.com,或用testssl.sh example.com,目标是 A/A+ 且无协议类 WARN。
把关键检查写成可上线的脚本:
#!/usr/bin/env bash
set -euo pipefail
D=example.com
code=$(echo | openssl s_client -connect "$D:443" -servername "$D" 2>/dev/null | awk '/Verify return code/{print $4}')
[ "$code" = "0" ] || { echo 'chain broken'; exit 1; }
echo | openssl s_client -connect "$D:443" -servername "$D" 2>/dev/null
| openssl x509 -noout -checkend 1209600 || { echo 'cert expiring soon'; exit 1; }
curl -sSI "http://$D" | head -n1 | grep -q 301 || { echo 'no https redirect'; exit 1; }
echo OK
最后做一次跨客户端抽检:Android 7 以下、Java 8 的 HttpsURLConnection、Go 的 http.Client 对证书链更严格,是暴露“缺中间证书”的最好探针。用 curl --cacert ./chain.pem https://example.com 模拟只信任特定根的场景,也能快速复现问题。
常见问题
免费 SSL 证书和付费证书的差别到底在哪?
信任级别完全一样,浏览器都显示锁标志。差别在验证级别(免费基本只有 DV,付费才有 OV/EV)、有效期(Let’s Encrypt 90 天需自动续期,付费可到 398 天上限)、赔付保障、技术支持响应、通配符与 SAN 数量、以及是否支持国密 SM2。面向公众的普通站点用 Let’s Encrypt 配合自动化续期完全够用。
一张证书能同时覆盖 example.com 和 *.example.com 吗?
可以,把两个都写进 SAN,例如 -addext 'subjectAltName=DNS:example.com,DNS:*.example.com'。注意 *.example.com 不覆盖 example.com 本身,也不覆盖 a.b.example.com 这类多级子域。
续期成功了,浏览器为什么还显示旧证书?
常见四种原因:Web 服务进程没有 reload,仍持有旧证书;CDN 或反向代理缓存了旧证书;多节点只更新了一台;客户端复用了 TLS session。处理顺序是先 systemctl reload nginx,再用 openssl s_client -connect 源站IP:443 -servername example.com 直连源站确认,最后清 CDN 缓存。
为什么 curl 报 unable to get local issuer certificate,浏览器却正常?
桌面浏览器具备 AIA(Authority Information Access)自动补齐中间证书的能力,而 curl、Java、Go、部分 Android 版本不会。解决办法只有一个:把叶子证书和中间证书按顺序合并成 fullchain.pem 部署,而不是只部署域名证书。
398 天是证书有效期的最终上限吗?
不是。按 CA/Browser Forum SC-081 的时间表,2026-03-15 起降为 200 天,2027-03-15 起降为 100 天,2029-03-15 起降为 47 天。任何依赖人工续期的流程都必须改为 ACME 自动化,否则必然会踩到过期故障。
内网域名可以申请公有 SSL 证书吗?
公有 CA 无法为不可公开验证的域名(.local、纯内网域名)签发证书。可行方案有三种:用 DNS-01 为可公网解析的内网子域签发;自建内部 CA 并下发到所有客户端信任库;或使用私有信任链 + 客户端预置根证书,同时通过 MDM 统一分发。