跳到主要内容
ssl证书按装

SSL 证书申请与部署实战:CSR 生成、证书链拼接、Nginx 配置与真实报错排查

SSL 证书申请与部署实战:CSR 生成、证书链拼接、Nginx 配置与真实报错排查 — 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 而被迫等待一周。

配置示例: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 恢复续期钩子。

内容审核

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