跳到主要内容
ssl证书按装

SSL/TLS 证书从申请到部署全流程实战:CSR 生成、证书链拼接、Nginx/Apache/Tomcat 配置与真实报错排查

SSL/TLS 证书从申请到部署全流程实战:CSR 生成、证书链拼接、Nginx/Apache/Tomcat 配置与真实报错排查 — SSL/TLS 证书从申请到部署全流程实战:CSR 生成、证书链拼接、Nginx/Apache/Tomcat 配置与真实报错排查

一、问题背景与根因:HTTP 站点为什么会被浏览器判为不安全

浏览器对 HTTP 页面显示的“不安全”标记不是装饰,而是基于一个明确事实:明文 HTTP 既无法验证服务器身份,也无法阻止链路上任意一跳篡改响应体。Chrome 从 68 版起对所有 HTTP 页面在地址栏左侧标注“不安全”,Edge、Safari 同样处理;而微信小程序、支付回调、iOS ATS、HTTP/2(主流实现要求 TLS)、Service Worker、地理位置 API 等能力,直接把 HTTPS 变成准入门槛而不是可选项。

TLS 解决两件事:身份与机密性。握手阶段服务器出示由 CA 签发的证书,浏览器用内置根证书库验证三件事——证书链是否完整(叶子证书 → 中间证书 → 根证书)、SAN 扩展是否覆盖实际访问的域名、有效期与系统时间是否正常。任一环节失败就会降级为警告页。因此“证书装上了浏览器仍报错”的根因,绝大多数集中在三处:缺中间证书导致链不完整、SAN 未包含实际域名、证书过期或服务器时间异常。

必须纠正一个过时认知:公开信任的 TLS 证书早已不能“买一张管很多年”。按 CA/Browser Forum 规定,单张公开信任证书的最长有效期自 2020 年 9 月 1 日起为 398 天;Let’s Encrypt 免费证书固定 90 天。CA/Browser Forum 已通过 SC-081 过渡方案,计划自 2026 年 3 月起将上限压缩到 200 天、2027 年 3 月起 100 天、2029 年 3 月起 47 天。正确姿势因此变成:短周期证书 + 自动化续期 + 到期监控,而不是追求“长期证书”。

二、证书类型与选型:DV/OV/EV 与单域名/多域名/通配符

公开信任证书有两个正交维度:验证等级与覆盖范围。选购时必须同时确认,否则会出现“买了证书却保护不了 www 子域”这类低级事故。

验证等级 验证内容 典型签发时长 年费区间 浏览器展示 适用场景
DV 域名型 仅验证域名控制权 数分钟至 1 小时 0–300 元 锁图标 博客、测试环境、API 网关、内部工具
OV 组织型 域名控制权 + 组织真实性 1–5 个工作日 800–3000 元 锁图标,证书详情含企业信息 企业官网、门户、B 端系统
EV 增强型 严格组织核验 + 人工复核 3–7 个工作日 3000–10000 元 锁图标(地址栏不再显示企业名) 金融、支付、政务

关于 EV 有一个必须澄清的误区:Chrome 77 之后已不再在地址栏展示 EV 证书的企业名称,Edge、Firefox 也陆续移除了该 UI,EV 信息只能点开锁图标在证书详情里查看。“买 EV 就能在地址栏显示公司名”是彻底的过时说法,EV 的真实价值在于更严格的身份核验与合规留痕。

覆盖范围上,单域名证书只保护一个 FQDN——example.com 与 www.example.com 被视为两个不同域名,除非一并写入 SAN;多域名证书(SAN 证书)可在一张证书里写多个不同主域;通配符证书(*.example.com)覆盖同一层级的所有二级子域,但不覆盖 example.com 本身,也不覆盖 a.b.example.com。预算敏感且能接受 90 天周期的,直接用 Let’s Encrypt 或 ZeroSSL 的 ACME 证书即可。

三、申请实操:私钥与 CSR 的正确生成方式

CSR(Certificate Signing Request)承载公钥与主体信息,私钥必须留在自己服务器上,绝不能发给 CA 或任何第三方。下面这条命令生成 2048 位 RSA 私钥与 CSR,并把所有需要保护的域名一次性写进 SAN:

openssl req -new -newkey rsa:2048 -nodes 
  -keyout example.com.key 
  -out example.com.csr 
  -subj '/C=CN/ST=Beijing/L=Beijing/O=Example Technology Ltd/CN=example.com' 
  -addext 'subjectAltName=DNS:example.com,DNS:www.example.com,DNS:api.example.com'
chmod 600 example.com.key
openssl req -in example.com.csr -noout -text | grep -A2 'Subject Alternative Name'

参数要点:-nodes 表示私钥不加密,便于 Nginx/Tomcat 自动加载,代价是必须靠文件权限保护;-addext 需要 OpenSSL 1.1.1 及以上,低版本只能写 openssl.cnf;CN 只填主域名,其余全部走 SAN——现代浏览器只认 SAN,不看 CN,这也是大量老证书报 ERR_CERT_COMMON_NAME_INVALID 的历史原因。

若偏好更短握手与更小体积,可改用 ECC 私钥:openssl ecparam -genkey -name prime256v1 -out example.com.key。注意同一张证书的公私钥算法必须匹配,混用会在 Nginx 启动时直接报 key values mismatch。提交 CA 后,OV/EV 还需营业执照与电话回访,DV 只需通过域名控制权验证。签发完成你会拿到至少两个文件:服务器证书与中间证书(ca-bundle / chain),部署时必须拼成一个 fullchain 文件,这是后面所有“证书不受信任”报错的源头。

四、域名验证与 CAA 记录:ACME 签发最容易卡住的一步

商业 CA 与 ACME 的 DV 验证本质相同:证明你控制该域名。HTTP-01 方式下 CA 会访问 http://example.com/.well-known/acme-challenge/<token> 并比对内容,要求 80 端口公网可达、不能被 301 跳到奇怪路径、不能被 WAF 拦截。certbot 一条命令即可完成,先用 –dry-run 验证通过再正式签发:

certbot certonly --webroot -w /var/www/html -d example.com -d www.example.com --dry-run

DNS-01 方式是在 _acme-challenge.example.com 添加 TXT 记录,是唯一支持通配符的方式。提交前务必确认解析已在多个权威 DNS 上生效:

dig +short TXT _acme-challenge.example.com @8.8.8.8
dig +short TXT _acme-challenge.example.com @1.1.1.1

两个高频真实报错:DNS problem: NXDOMAIN looking up TXT for _acme-challenge.example.com – check that a DNS record exists for this domain,说明记录没生效或主机名加错(很多 DNS 控制台要求只填 _acme-challenge);Invalid response from http://example.com/.well-known/acme-challenge/xxx: 404,说明 webroot 路径与站点实际根目录不一致。

还有一类隐蔽失败来自 CAA 记录:域名下若存在 CAA,只有记录中列出的 CA 才能签发,否则报 CAA record for example.com prevents issuance。用 dig +short CAA example.com 检查,缺失时补一条 example.com. CAA 0 issue "letsencrypt.org" 即可。通配符与多域名场景下,建议把 issuewild 一并配置,避免后续扩展时再次踩坑。

五、服务端配置示例:Nginx / Apache / Tomcat / IIS

Nginx 是最常见部署形态,注意 ssl_certificate 必须指向 fullchain(叶子 + 中间证书拼接),而不是单独的叶子证书:

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/example.com.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-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305;
    ssl_prefer_server_ciphers off;
    ssl_session_cache   shared:SSL:10m;
    ssl_session_timeout 1d;

    add_header Strict-Transport-Security max-age=31536000 always;
}
server {
    listen 80;
    server_name example.com www.example.com;
    return 301 https://$host$request_uri;
}

Apache 2.4.8 之后不再需要 SSLCertificateChainFile,直接把 fullchain 交给 SSLCertificateFile:

<VirtualHost *:443>
  ServerName example.com
  SSLEngine on
  SSLCertificateFile    /etc/httpd/ssl/example.com.fullchain.pem
  SSLCertificateKeyFile /etc/httpd/ssl/example.com.key
  SSLProtocol           all -SSLv3 -TLSv1 -TLSv1.1
  SSLCipherSuite        ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256
  Header always set Strict-Transport-Security max-age=31536000
</VirtualHost>

Tomcat 8.5+/9/10 推荐使用 PEM 直读,写在 server.xml 的 Connector 中:

<Connector port="443" protocol="org.apache.coyote.http11.Http11NioProtocol" SSLEnabled="true">
  <SSLHostConfig>
    <Certificate certificateFile="/opt/tomcat/conf/ssl/fullchain.pem"
                 certificateKeyFile="/opt/tomcat/conf/ssl/example.com.key"
                 type="UNDEFINED" />
  </SSLHostConfig>
</Connector>

IIS 走另一条路径:certlm.msc 导入 .pfx,把中间证书单独导入“中间证书颁发机构”存储,再到站点绑定中添加 443 并勾选 SNI。重载命令分别是 nginx -t && nginx -s reload、apachectl configtest && systemctl reload httpd、systemctl restart tomcat、iisreset。改动前务必备份配置,Nginx 的 -t 参数能在 reload 前拦住绝大多数语法与证书路径错误。

六、对比表格:验证方式与部署形态怎么选

先看 ACME 三种验证方式的取舍,选错方式会直接导致通配符签发失败或多站点批量签发效率极低:

验证方式 支持通配符 前置条件 典型失败原因
HTTP-01 否 80 端口公网可达 404、301 跳转、WAF 拦截、CDN 回源错误
DNS-01 是 DNS API 凭据或手工加 TXT TXT 未生效、多值未清理、CAA 限制
TLS-ALPN-01 否 443 端口独占、支持 ALPN 前置负载均衡已终止 TLS

再看四种服务端形态的配置差异,这张表基本覆盖了 90% 的日常部署场景:

服务端 证书格式 关键入口 生效命令 常见坑
Nginx PEM(叶子+链拼接) ssl_certificate / ssl_certificate_key nginx -t && nginx -s reload 只配叶子证书导致链不完整
Apache PEM fullchain SSLCertificateFile / SSLCertificateKeyFile apachectl configtest && systemctl reload httpd 仍写已废弃的 SSLCertificateChainFile
Tomcat PEM 或 JKS/PFX SSLHostConfig/Certificate systemctl restart tomcat Java 客户端 truststore 缺中间证书
IIS PFX certlm.msc 导入 + 站点绑定 443 iisreset 中间证书未装进“中间证书颁发机构”

选型结论很直接:纯静态站点与反向代理优先 Nginx;存量 LAMP 架构继续用 Apache,但要把 ChainFile 迁移掉;Java 生态用 Tomcat,并同步维护 JDK cacerts;Windows 环境用 IIS,PFX 密码要纳入密钥管理。多台服务器共享同一张证书时,建议把 fullchain 与私钥纳入配置管理或密钥托管系统,避免手工拷贝导致版本不一致。

七、常见错误排查:这些真实报错分别意味着什么

下面每一条都是部署现场高频出现的原始报错,按“报错原文 → 根因 → 修复”对照处理即可。

① NET::ERR_CERT_AUTHORITY_INVALID,或命令行 curl: (60) SSL certificate problem: unable to get local issuer certificate。根因是证书链不完整,服务端只下发了叶子证书。修复:cat example.com.crt ca-bundle.crt > fullchain.pem,再指向 fullchain。

② ERR_CERT_COMMON_NAME_INVALID 或 SSL_ERROR_BAD_CERT_DOMAIN。根因是 SAN 未包含当前访问域名,例如证书只写了 example.com 却访问 www.example.com。修复只能重新签发,把全部域名写进 SAN。

③ nginx: [emerg] SSL_CTX_use_PrivateKey_file("/etc/nginx/ssl/example.com.key") failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch)。根因是私钥与证书不配对。用 openssl x509 -noout -modulus -in cert.pem | openssl md5 与 openssl rsa -noout -modulus -in key.pem | openssl md5 比对,两个哈希必须一致。

④ nginx: [emerg] cannot load certificate "/etc/nginx/ssl/fullchain.pem": BIO_new_file() failed (SSL: error:02001002:system library:fopen:No such file or directory)。根因是路径写错、文件权限不足(Nginx worker 以 nginx 用户运行)或 SELinux 上下文不对。修复:chmod 644 fullchain.pem、chmod 600 key.pem,SELinux 环境执行 restorecon -Rv /etc/nginx/ssl。

⑤ ERR_CERT_DATE_INVALID。根因是证书过期或服务器系统时间漂移。先 openssl x509 -noout -dates -in cert.pem 确认 notAfter,再 date -u 核对时间。

⑥ ERR_SSL_PROTOCOL_ERROR。根因通常是 443 端口上跑的是明文 HTTP,或服务端把 TLSv1.2 也禁用了。用 curl -I http://example.com:443 验证端口内容,用 openssl s_client -connect example.com:443 -tls1_2 验证协议可用性。

⑦ 页面锁图标正常但仍提示“不安全”,控制台报 Mixed Content。根因是 HTML 里仍有 http:// 的图片、脚本或接口。修复:全站改相对协议或 https,并配置 CSP 的 upgrade-insecure-requests。

⑧ Java 侧 java.security.cert.CertPathValidatorException: PKIX path building failed。根因是 JDK 信任库中没有对应中间证书,需 keytool -importcert 导入 JDK 的 cacerts。⑨ Let’s Encrypt 报 too many certificates already issued for exact set of domains,属于速率限制,先用 –dry-run 调试,别在生产反复重签。

八、效果验证与自动化续期:别让证书在凌晨悄悄过期

部署完成后不要只看浏览器锁图标,用命令行做三项硬验证。第一项看证书链与协议:

openssl s_client -connect example.com:443 -servername example.com -showcerts </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|Protocol|Cipher'

输出中 Verify return code: 0 (ok) 是唯一可接受的链验证结果,出现 20 (unable to get local issuer certificate) 就是缺中间证书。第二项用 curl 做端到端校验,ssl_verify_result 必须为 0:

curl -sS -o /dev/null -w '%{http_code} %{ssl_verify_result}n' https://example.com

第三项做到期预检,返回非 0 即代表 30 天内将过期,可直接接入监控告警:

openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null | openssl x509 -checkend 2592000 -noout || echo 'CERT EXPIRING WITHIN 30 DAYS'

续期必须自动化。certbot 用户启用 systemd 定时器(systemctl list-timers | grep certbot 确认存在),或用 crontab 加 deploy-hook 触发重载:0 3 * * * /usr/bin/certbot renew –quiet –deploy-hook ‘systemctl reload nginx’。acme.sh 用户则用 acme.sh –install-cert -d example.com –key-file /etc/nginx/ssl/example.com.key –fullchain-file /etc/nginx/ssl/example.com.fullchain.pem –reloadcmd ‘systemctl reload nginx’,把重载命令固化进续期流程。上线前统一跑一次 certbot renew –dry-run 或 acme.sh –issue –test,确认自动化链路真的能跑通。最后用 SSL Labs 或 Hardenize 做一次外部扫描,确认协议版本、密钥强度、HSTS 与证书链全部达标。

常见问题

免费 Let’s Encrypt 证书和付费 DV 证书在浏览器里表现有区别吗

没有区别。两者都是公开信任的 DV 证书,浏览器显示相同的锁图标,加密强度取决于你配置的协议版本与密码套件,而非价格。差异在于有效期(Let’s Encrypt 固定 90 天,商业 DV 最长 398 天)、是否提供商业保障与技术支持、是否支持 OCSP/CRL 等附加服务。选择免费证书的前提是你能把自动化续期做扎实。

一张证书能同时保护多个域名吗,www 和裸域算一个吗

可以,但必须用多域名(SAN)证书或在申请时把域名一并写进 SAN。example.com 与 www.example.com 在证书体系里是两个完全独立的 FQDN,只写其中一个,访问另一个就会报 ERR_CERT_COMMON_NAME_INVALID。通配符证书 *.example.com 覆盖所有二级子域,但同样不包含裸域 example.com,通常需要把裸域加进同一张证书的 SAN 里。

证书有效期为什么越来越短,398 天还会继续变吗

缩短有效期是为了降低私钥泄露与吊销不及时带来的风险窗口。目前公开信任证书单张最长 398 天,Let’s Encrypt 为 90 天。按 CA/Browser Forum 已通过的 SC-081 过渡方案,2026 年 3 月起上限降至 200 天,2027 年 3 月起 100 天,2029 年 3 月起 47 天。结论很明确:任何依赖手工换证书的流程都会在未来几年内失效,必须尽早完成 ACME 自动化改造。

部署后浏览器显示锁图标正常,但页面仍提示不安全怎么办

这是混合内容(Mixed Content)问题,不是证书问题。打开开发者工具 Console,会看到类似 Mixed Content: The page at https://example.com was loaded over HTTPS, but requested an insecure image http://… 的报错。逐条把页面中的 http:// 资源改为 https:// 或相对路径,接口地址同步改造,并在响应头加 Content-Security-Policy: upgrade-insecure-requests 兜底。

服务器迁移时证书怎么搬才不出错

需要迁移三样东西:私钥、服务器证书、中间证书(或已拼好的 fullchain)。私钥必须原样保留,否则只能重新签发。迁移后用 openssl x509 -noout -modulus 与 openssl rsa -noout -modulus 比对哈希确认配对,再执行 openssl s_client 验证链完整。若使用 ACME 证书,新服务器上重新签发往往比拷贝更省事,也更符合短周期自动化的运维模型。

证书链看起来正常,但部分安卓机或老客户端仍然报错

典型原因是服务端只下发了中间证书而缺少根证书交叉签名,或使用了老客户端不支持的 ECC 证书与 TLS 1.3。排查方法:用 openssl s_client -showcerts 导出完整链,确认至少有叶子与中间两级;再用 SSL Labs 的客户端兼容性测试查看 Android 4.x、Java 8 等老客户端的握手结果。兼容性优先的场景,建议同时部署 RSA 2048 证书,并在服务端保留 TLS 1.2。

内容审核

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