SSL 证书 HTTPS 加密安装配置实战:CSR 生成、证书链修复与 Nginx/Apache/Tomcat 部署
一、为什么“证书装上了”浏览器还是提示不安全
把 SSL 证书文件复制到服务器、在 Nginx 里写两行 ssl_certificate,这只是 HTTPS 部署的第一步。生产环境中“证书已安装但不生效”的问题,根因集中在四类:证书链不完整、私钥与证书不匹配、域名覆盖范围不符、协议与端口配置错误。
根因一:只部署了叶子证书。CA 签发时通常给你两个文件:域名证书(叶子证书)和中间证书(Intermediate)。浏览器信任的是根证书,需要靠中间证书把叶子证书连接到根证书上。只配置叶子证书时,桌面浏览器有时能靠缓存或 AIA 补链成功,但 Android、微信内置浏览器、Java 客户端、curl、Go 程序会直接报错,典型信息是 unable to verify the first certificate 或 x509: certificate signed by unknown authority。
根因二:证书与私钥不匹配。重新签发证书后只替换了 .crt 文件,没有替换 .key 文件,或者从 A 服务器复制证书、从 B 服务器复制私钥,Nginx 会直接拒绝启动:SSL_CTX_use_PrivateKey_file(...) failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch)。
根因三:域名覆盖范围不符。CSR 里只写了 example.com,实际访问 www.example.com 就会报 NET::ERR_CERT_COMMON_NAME_INVALID。注意 *.example.com 只覆盖一级子域,不覆盖 example.com 本身,也不覆盖 api.test.example.com。
根因四:有效期规则变了。2020 年 9 月起,CA/Browser Forum 与 Apple、Chrome 共同要求公共信任 TLS 证书单次有效期不超过 398 天。过去“买两年、三年”的产品,实际执行方式是首年签发 + 到期前重新签发,运维必须建立续期流程,否则一年后必然大面积报 certificate has expired。
先做一次快速检查,确认服务器实际返回了什么:
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | grep -c "BEGIN CERTIFICATE"
返回值小于 2,基本可以判定链不完整。再看证书主体与有效期:
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null | openssl x509 -noout -subject -issuer -dates
如果 Subject 里没有你访问的域名、SAN 为空、Not After 已过,接下来的操作方向就非常明确:重新签发或补齐证书链。
二、证书选型:DV/OV、单域名/通配符与 398 天有效期
选型只需要回答三个问题:要保护几个域名、是否需要核验组织身份、能不能接受 90 天续期一次。下表是常见类型对比(价格为参考区间,以实际报价为准):
| 类型 | 保护范围 | 验证方式 | 签发速度 | 参考年价 | 典型场景 |
|---|---|---|---|---|---|
| DV 单域名 | example.com 或 www.example.com 一个 | DNS / HTTP / 邮箱 | 分钟级 | 约 200 元 | 单站点、测试环境 |
| DV 通配符 | *.example.com(裸域需写入 SAN) | DNS-01 | 5-30 分钟 | 500-800 元 | 多子域、SaaS 平台 |
| OV 单域名/通配符 | 同上,另含组织核验 | 工商/电话核验 | 1-3 工作日 | 数千元 | 政企、招投标合规 |
| 免费 DV(Let’s Encrypt 等) | 单域名或多域名、通配符 | DNS-01 / HTTP-01 | 1 分钟 | 0 元 | 自动化运维、内部系统 |
几个容易出问题的细节:
- 通配符证书的 SAN 必须同时包含
*.example.com和example.com,否则裸域访问会报证书错误。下单时要把两个都写进 CSR。 - 通配符只覆盖一级:
*.example.com匹配www.example.com、api.example.com,不匹配a.b.example.com,也不匹配example.com。 - OV/EV 的组织信息在浏览器里基本不可见:Chrome、Firefox、Safari 早已移除 EV 绿色地址栏,只保留证书详情中的主体信息。选 OV 的理由是合规与审计,不是 UI 效果。
- 398 天是硬性上限,任何“两年期/三年期”产品本质都是多次签发,续期动作不会消失。
域名验证方式对比如下,选择哪种直接决定你能不能签通配符:
| 验证方式 | 原理 | 耗时 | 能否签通配符 | 适用场景 |
|---|---|---|---|---|
| DNS-01 | 添加 TXT 记录(_dnsauth / _acme-challenge) | 1-10 分钟,受 TTL 影响 | 可以 | 无 80 端口、内网、通配符 |
| HTTP-01 | 根目录放验证文件 | 分钟级 | 不可以 | 有公网 80 端口 |
| 邮箱验证 | 接收 whois 邮箱 | 数十分钟到数小时 | 可以 | 传统商业 CA |
| 文件验证 | 上传指定文件到网站根目录 | 分钟级 | 可以 | 虚拟主机 |
三、生成私钥与 CSR,并完成域名所有权验证
CSR(Certificate Signing Request)包含公钥和域名信息,私钥必须留在自己服务器上,任何情况下都不要发给 CA 或服务商。RSA 2048 兼容性最好,OpenSSL 1.1.1 及以上可直接用 -addext 写 SAN:
openssl req -new -newkey rsa:2048 -nodes
-keyout example.com.key
-out example.com.csr
-subj "/C=CN/ST=Zhejiang/L=Hangzhou/O=Example Ltd/CN=example.com"
-addext "subjectAltName=DNS:example.com,DNS:*.example.com"
chmod 600 example.com.key
openssl rsa -in example.com.key -check
CentOS 7 自带的 OpenSSL 1.0.2 不支持 -addext,改用配置文件:
cat > req.cnf <<'EOF'
[req]
distinguished_name = dn
req_extensions = v3_req
prompt = no
[dn]
CN = example.com
O = Example Ltd
C = CN
[v3_req]
subjectAltName = @alt
[alt]
DNS.1 = example.com
DNS.2 = *.example.com
EOF
openssl req -new -newkey rsa:2048 -nodes -keyout example.com.key -out example.com.csr -config req.cnf
提交前务必校验 CSR,确认 SAN 没写错:
openssl req -in example.com.csr -noout -verify
openssl req -in example.com.csr -noout -text | grep -A2 "Subject Alternative Name"
域名所有权验证中,DNS 方式最快。添加记录后用公共 DNS 确认全球生效:
dig +short TXT _dnsauth.example.com @8.8.8.8
dig +short TXT _acme-challenge.example.com @1.1.1.1
HTTP 方式则本地先测通再点验证:
curl -I http://example.com/.well-known/pki-validation/xxxx.txt
邮箱验证只接受 whois 记录或预置的 admin@、administrator@、webmaster@、hostmaster@、postmaster@ 等地址。验证失败三大原因是:80 端口被安全组拦截、CDN 回源未同步、DNS 记录 TTL 未生效就提前点击验证。
四、证书格式与证书链:PEM、PFX、JKS 互转与全链拼接
CA 下发的文件在不同平台叫法不同,本质只有四种格式。搞错格式是“证书装不上”的第二大原因。
| 格式 | 常见扩展名 | 内容 | 典型用途 |
|---|---|---|---|
| PEM | .pem .crt .cer .key | Base64 文本,可拼接多张证书 | Nginx、Apache、Linux |
| DER | .der .cer | 二进制 | Java 老版本、部分硬件设备 |
| PKCS#12 | .pfx .p12 | 证书 + 私钥 + 链,带密码 | IIS、Windows、Tomcat |
| JKS | .jks | Java KeyStore | Tomcat、WebLogic |
PEM 与 DER 互转:
openssl x509 -in example.com.crt -outform DER -out example.com.der
openssl x509 -in example.com.der -inform DER -out example.com.crt
拼接全链,顺序必须是叶子 → 中间 → 根,根证书建议省略:
cat example.com.crt intermediate.crt > fullchain.pem
openssl verify -CAfile fullchain.pem example.com.crt
grep -c "BEGIN CERTIFICATE" fullchain.pem
PEM 转 PFX(Windows/IIS 用):
openssl pkcs12 -export -out example.pfx -inkey example.com.key
-in example.com.crt -certfile chain.pem -name example.com
PFX 拆回 PEM:
openssl pkcs12 -in example.pfx -nodes -out all.pem
openssl pkcs12 -in example.pfx -nokeys -clcerts -out example.com.crt
openssl pkcs12 -in example.pfx -nokeys -cacerts -out chain.pem
PFX 转 JKS(Tomcat 用):
keytool -importkeystore -srckeystore example.pfx -srcstoretype PKCS12
-destkeystore example.jks -deststoretype JKS
-deststorepass changeit -srcalias example.com
注意事项:生产链文件不要带根证书,会增大握手包,部分客户端对多余根证书敏感;私钥权限设为 600,属主为运行服务的用户;替换时保持文件名与路径不变,避免 reload 时因路径错误导致服务不可用。
五、服务器配置示例:Nginx、Apache、Tomcat 与 IIS
Nginx 完整配置,注意 ssl_certificate 必须指向 fullchain.pem,ssl_trusted_certificate 指向不含叶子证书的 chain.pem:
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-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305;
ssl_prefer_server_ciphers off;
ssl_session_cache shared:SSL:10m;
ssl_session_timeout 1d;
ssl_stapling on;
ssl_stapling_verify on;
ssl_trusted_certificate /etc/nginx/ssl/chain.pem;
add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
}
server {
listen 80;
server_name example.com www.example.com;
return 301 https://$host$request_uri;
}
nginx -t && systemctl reload nginx
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
SSLProtocol -all +TLSv1.2 +TLSv1.3
SSLCipherSuite HIGH:!aNULL:!MD5:!3DES
Header always set Strict-Transport-Security "max-age=31536000"
</VirtualHost>
Tomcat server.xml:
<Connector port="8443" protocol="org.apache.coyote.http11.Http11NioProtocol"
SSLEnabled="true" scheme="https" secure="true" maxThreads="200">
<SSLHostConfig protocols="TLSv1.2,TLSv1.3">
<Certificate certificateKeystoreFile="/opt/tomcat/conf/example.jks"
certificateKeystorePassword="changeit" type="RSA"/>
</SSLHostConfig>
</Connector>
IIS 先在 certlm.msc 把 PFX 导入“个人”存储,再在网站绑定中添加 https/443 并勾选“需要服务器名称指示”。命令行绑定可用:
netsh http add sslcert hostnameport=example.com:443 certhash=ABC123... appid={4dc3e181-e14b-4a21-b022-59fc669b0914} certstorename=MY
六、续期与到期监控:398 天规则下的自动化
商业证书续期流程:到期前 30 天提交重签,可复用私钥与 CSR(同私钥重签),也可换新私钥。换私钥更安全,但必须在同一时间窗口内替换证书与私钥,否则 reload 后直接 mismatch。重新签发后仍需完成一次域名验证,DV 证书通常分钟级完成。
免费证书用 ACME 协议自动化,Let’s Encrypt 有效期 90 天,建议每 60 天续期一次。certbot 用法:
certbot certonly --webroot -w /var/www/html -d example.com -d www.example.com
certbot renew --dry-run
systemctl list-timers | grep certbot
acme.sh 更适合通配符与 DNS API 自动化:
curl https://get.acme.sh | sh -s email=ops@example.com
acme.sh --issue -d example.com -d '*.example.com' --dns dns_ali
acme.sh --install-cert -d example.com
--key-file /etc/nginx/ssl/example.com.key
--fullchain-file /etc/nginx/ssl/fullchain.pem
--reloadcmd "systemctl reload nginx"
到期监控是必须项,一条命令即可查剩余时间:
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null | openssl x509 -noout -enddate
openssl x509 -checkend 2592000 -noout -in /etc/nginx/ssl/fullchain.pem
checkend 返回 0 表示 30 天内不会过期,返回 1 表示即将过期,可直接作为脚本退出码接入告警。批量巡检:
for d in example.com api.example.com; do
echo -n "$d: "
echo | openssl s_client -connect $d:443 -servername $d 2>/dev/null | openssl x509 -noout -enddate
done
用 Prometheus 的 blackbox_exporter 时,关注 probe_ssl_earliest_cert_expiry 指标,按 30 天、7 天两级阈值告警即可覆盖绝大多数事故。
七、常见错误排查:真实报错与修复
下表按出现频率排列,报错信息均为线上真实输出:
| 报错信息 | 根因 | 修复动作 |
|---|---|---|
| NET::ERR_CERT_AUTHORITY_INVALID / unable to verify the first certificate | 缺中间证书 | ssl_certificate 改为 fullchain.pem |
| x509: certificate signed by unknown authority(Go、Docker) | 同上 | 同上,并确认链文件顺序 |
| SSL_CTX_use_PrivateKey_file(…) failed (SSL: error:0B080074 … key values mismatch) | 证书与私钥不匹配 | 比对 modulus,替换配套私钥 |
| PEM_read_bio_X509:no start line | 文件混入说明文字或换行错误 | 重新导出纯 PEM |
| certificate has expired | 未续期 | 重签并 reload,检查系统时间 |
| SSL_ERROR_BAD_CERT_DOMAIN | SAN 不含当前域名 | 重签,补 www 或裸域 |
| sslv3 alert handshake failure / wrong version number | 协议或端口错配 | 确认 443 端口、TLS 版本与客户端一致 |
| javax.net.ssl.SSLHandshakeException: PKIX path building failed | Java 信任库缺中间证书 | 导入 chain 到 cacerts |
核对证书与私钥是否配套,RSA 证书用 modulus 比对,两个 md5 必须一致:
openssl x509 -noout -modulus -in example.com.crt | openssl md5
openssl rsa -noout -modulus -in example.com.key | openssl md5
ECDSA 证书没有 modulus,改用公钥比对:
openssl x509 -in example.com.crt -noout -pubkey | openssl md5
openssl pkey -in example.com.key -pubout | openssl md5
Java 客户端报 PKIX 时,把中间证书导入信任库:
keytool -importcert -alias intermediate -file chain.crt
-keystore $JAVA_HOME/lib/security/cacerts -storepass changeit
多域名共用一台服务器时,若客户端不支持 SNI 或 Nginx 未配置 server_name 匹配,会返回默认站点证书,表现为“证书不是这个域名的”。排查时加 -servername 参数复现真实握手。
八、效果验证:从命令行到 SSL Labs
配置完成后不要只看浏览器,按下面的顺序逐项验证。第一步看握手与证书链:
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null
输出中应看到至少两张证书,且 Verify return code 为 0 (ok)。第二步看协议版本是否按预期启用:
openssl s_client -connect example.com:443 -servername example.com -tls1_2 </dev/null | grep Protocol
openssl s_client -connect example.com:443 -servername example.com -tls1_1 </dev/null
后者应当握手失败,说明 TLS 1.0/1.1 已关闭。第三步看跳转与安全响应头:
curl -sI http://example.com | grep -i location
curl -sI https://example.com | grep -iE "strict-transport-security|server"
第四步枚举加密套件,确认没有 RC4、3DES、CBC 弱套件残留:
nmap --script ssl-enum-ciphers -p 443 example.com
testssl.sh --severity HIGH example.com
第五步检查 OCSP Stapling 是否生效,正常应返回 OCSP Response Status: successful:
openssl s_client -connect example.com:443 -servername example.com -status </dev/null | grep -A2 "OCSP Response Status"
第六步查混合内容,页面里残留的 http:// 资源会让浏览器显示“不安全”:
curl -s https://example.com | grep -o 'http://[^"]*' | head
最后用 SSL Labs 做整体评分,目标为 A 或 A+。若得 B,通常是协议版本过低或未开启 HSTS;若得 T,是证书链不受信任,回到第四节重新拼接 fullchain。验收通过的标准建议定为:链完整、SAN 覆盖全部域名、TLS 1.2/1.3、HSTS 已下发、到期时间已纳入监控。
常见问题
通配符证书能保护 example.com 裸域吗?
不能。*.example.com 只匹配一级子域,如 www.example.com、api.example.com。裸域 example.com 必须在 CSR 的 SAN 中显式写入 DNS:example.com,下单时两个域名一起提交。
为什么买的“两年期证书”只签发了 398 天?
2020 年 9 月起,公共信任 TLS 证书单次有效期上限为 398 天,由 CA/Browser Forum 与主流浏览器共同强制。所谓两年期产品实际是首年签发 + 到期前重新签发,续期动作无法省略,务必把续期纳入运维流程。
换服务器时可以直接复制证书文件吗?
可以复制证书与私钥,但要保证三件事:私钥权限为 600、路径与配置一致、fullchain.pem 与 chain.pem 区分正确。跨环境迁移更推荐重新签发,避免私钥在多台机器留存导致泄露风险。
免费的 Let’s Encrypt 和付费 DV 证书有区别吗?
在浏览器信任层面没有区别,都走同一套根证书体系。差异在有效期(90 天 vs 最长 398 天)、是否提供商业保险与人工支持、验证方式以及是否支持通配符的便捷签发。内部系统与自动化场景用免费证书完全够用。
私钥泄露了怎么办?
立即吊销当前证书并重新签发,同时更换私钥。注意 Let’s Encrypt 已停止 OCSP 服务,吊销状态查询转向 CRL;商业 CA 通常提供吊销入口。吊销后要同步更新所有使用该证书的节点,包括 CDN 与负载均衡。
HTTPS 页面为什么仍提示“部分内容不安全”?
这是混合内容问题:页面里的图片、脚本、样式仍通过 http:// 加载。把资源改为 https:// 或协议相对地址,并在生产环境启用 Content-Security-Policy 的 upgrade-insecure-requests 指令,可彻底消除告警。