跳到主要内容
ssl证书按装

SSL 证书申请与管理全流程:从 CSR 生成、域名验证到 Nginx 部署与报错排查

SSL 证书申请与管理全流程:从 CSR 生成、域名验证到 Nginx 部署与报错排查 — 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

三个必须检查的点:

  1. CN 已不被浏览器采纳,真正生效的是 SAN 扩展。上面的 -addext 需要 OpenSSL 1.1.1 及以上;老版本要写临时配置文件用 -config 指定 subjectAltName。
  2. 核对 CSR 内容:openssl req -in example.com.csr -noout -text | grep -A1 'Subject Alternative Name',确认域名没写错、没有多余空格。
  3. 私钥与 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 真正生效

部署完成后不要只看浏览器有没有小锁,按下面五步逐层验证。

  1. 协议与套件:nmap --script ssl-enum-ciphers -p 443 example.com,确认没有 TLS1.0/1.1、没有 RC4/3DES。
  2. 证书链:openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null | grep 'Verify return code',必须为 0 (ok)。
  3. 强制跳转:curl -sSI http://example.com | head -n1 应为 301,且 Location 指向 https。
  4. HTTP/2 与 HSTS:curl -sSI https://example.com --http2 | grep -i -E 'strict-transport|HTTP/2'。
  5. 综合评分: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 统一分发。

内容审核

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