HTTPS 部署实战:SSL 数字证书配置、安装与排错完整指南
一、问题背景与根因:证书装上了为什么还报“不安全”
HTTP 协议下,浏览器与服务器之间的每一个字节都是明文:登录密码、Cookie、支付信息在公共 WiFi 下可被同网段设备抓包还原,运营商与代理甚至能在响应中插入广告、替换下载文件。部署 HTTPS 的本质,是让 TCP 之上的 TLS 层完成两件事——用非对称加密(RSA 2048 或 ECDSA P-256)完成身份认证与密钥协商,再用协商出的对称密钥(AES-128-GCM 或 ChaCha20-Poly1305)加密后续全部业务数据。
实际排障中,90% 的“证书装了但不生效”并不是证书本身有问题,而是下面三个条件至少有一个不成立:
- 私钥与证书不匹配:申请时生成了两对密钥,上传了 A 的证书却配了 B 的私钥,Nginx 直接启动失败。
- 证书链不完整:只上传域名证书,没有拼接中间证书(Intermediate CA)。桌面 Chrome 能自动补链可能正常,但 Android、微信内置浏览器、Java 客户端会直接报
unable to get local issuer certificate。 - 协议或端口配置错误:443 未放行、站点仍只监听 80、或只开启了已被主流浏览器弃用的 TLSv1.0。
另一个必须纠正的过时认知是有效期:按 CA/Browser Forum 规定,公有可信 TLS 证书单次最长有效期为 398 天(2020 年 9 月起生效,早期的 825 天已成历史),Let’s Encrypt 免费证书更是只有 90 天。这意味着“一年一续”的手工模式必然导致证书过期,自动化续期属于部署方案的一部分,而不是可选项。
动手前先用一条命令摸清现状,无需登录服务器:
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null
| openssl x509 -noout -subject -issuer -dates
若输出 verify error:num=20:unable to get local issuer certificate,说明链不完整;若 notAfter 已过期,说明续期任务失败;若直接 connection refused,则先检查安全组与防火墙的 443 端口。
二、准备阶段:私钥生成、CSR 提交与文件权限
动手前明确三件事:域名清单(是否要覆盖 www、是否需要泛域名 *.example.com)、证书类型(DV 域名型 / OV 组织型 / EV 扩展验证)、以及证书最终部署到哪台机器或哪个 CDN。DV 只需 DNS 或文件验证,几分钟签发;OV/EV 需要营业执照与组织信息核验,通常 1–3 个工作日。
在服务器上生成私钥。推荐 ECDSA,握手更快、证书包更小;老客户端兼容性要求高时用 RSA 2048:
# 方式一:ECDSA P-256(推荐)
openssl ecparam -genkey -name prime256v1 -out example.com.key
# 方式二:RSA 2048
openssl genrsa -out example.com.key 2048
用私钥生成 CSR,务必写入 SAN。现代浏览器已完全不看 CN 字段,只看 subjectAltName:
openssl req -new -sha256 -key 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:www.example.com"
提交前自检 SAN 是否写入成功:
openssl req -in example.com.csr -noout -text | grep -A1 "Subject Alternative Name"
预期输出形如 DNS:example.com, DNS:www.example.com。若为空,说明 OpenSSL 版本低于 1.1.1 不支持 -addext,需改用 -config 配合 [req_extensions] 段声明。
私钥权限必须收紧,否则等于把证书白送:
chmod 600 /etc/nginx/ssl/example.com.key
chown root:root /etc/nginx/ssl/example.com.key
把 example.com.csr 的内容提交给 CA;私钥永远不要外发、不要提交进 Git 仓库、不要放在 Web 根目录下,否则任何一次目录遍历漏洞都会导致私钥泄露。
三、证书链拼接与格式转换:让所有客户端都信任
CA 下发的压缩包通常包含 domain.crt(服务器证书)、ca_bundle.crt(中间证书)、domain.key(私钥),部分厂商还会给 .pfx 或 .der。Nginx 与 Apache 2.4.8+ 需要的是“服务器证书 + 中间证书”按顺序拼接的文件,顺序颠倒或不拼接都会导致链验证失败。
# 顺序不能反:服务器证书在前,中间证书在后
cat domain.crt ca_bundle.crt > fullchain.pem
# 验证拼接结果(应输出 fullchain.pem: OK)
openssl verify -CAfile ca_bundle.crt fullchain.pem
根证书不要拼进去,客户端本地已内置,拼了只会增大握手包体积。
格式转换的常用命令:
# PFX/P12 转 PEM(-nodes 表示私钥不加密,供 Nginx 直接读取)
openssl pkcs12 -in cert.pfx -nodes -out all.pem
# PEM 转 PFX(Tomcat / IIS / Java 应用常用)
openssl pkcs12 -export -out cert.pfx -inkey example.com.key -in fullchain.pem
# DER 转 PEM(Windows 导出常见)
openssl x509 -in cert.der -inform DER -out cert.pem -outform PEM
最容易被忽略的一步,是校验私钥与证书是否配对。这一步能在 reload 之前发现“拿错私钥”,省去一次线上故障:
openssl x509 -noout -modulus -in fullchain.pem | openssl md5
openssl rsa -noout -modulus -in example.com.key | openssl md5
两条命令输出的 MD5 必须完全一致。ECDSA 证书没有 modulus 字段,改用公钥比对:
openssl x509 -in fullchain.pem -noout -pubkey | openssl md5
openssl ec -in example.com.key -pubout | openssl md5
顺手确认有效期与 SAN:openssl x509 -in fullchain.pem -noout -dates -ext subjectAltName。若 -ext 参数报错,说明 OpenSSL 低于 1.1.0,可改用 -text 后 grep。
四、Nginx 安装配置 SSL 证书的完整步骤
把 fullchain.pem、example.com.key、ca_bundle.crt 上传到 /etc/nginx/ssl/,再写入站点配置。注意 listen 443 ssl http2 的写法在 Nginx 1.25.1 之后已废弃,新版本使用独立的 http2 on; 指令。
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-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/ca_bundle.crt;
resolver 223.5.5.5 119.29.29.29 valid=300s;
resolver_timeout 5s;
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;
proxy_set_header Host $host;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_set_header X-Real-IP $remote_addr;
}
}
几个参数值得说明:ssl_stapling 让服务器代客户端去 CA 拉取 OCSP 响应,减少一次握手往返,但必须配置 resolver 否则不生效;ssl_session_tickets off 关闭会话票据是为了满足前向保密要求;ssl_trusted_certificate 指向中间证书用于校验 OCSP 响应,不要指向 fullchain。反向代理场景下 X-Forwarded-Proto 必须透传,否则后端应用会误判为 HTTP 并陷入重定向循环。
nginx -t && systemctl reload nginx
若 nginx -t 通过但浏览器仍提示不安全,检查页面内是否还有 http:// 的图片、JS、CSS 引用,即混合内容(Mixed Content),在 F12 控制台会以红色告警列出具体资源。
五、Apache 与 Tomcat 配置示例及关键参数对照
Apache 2.4.8 之后不再强制需要 SSLCertificateChainFile,把中间证书拼进 SSLCertificateFile 即可;但为兼容老配置,两种写法都可保留。
<VirtualHost *:443>
ServerName example.com
SSLEngine on
SSLCertificateFile /etc/httpd/ssl/fullchain.pem
SSLCertificateKeyFile /etc/httpd/ssl/example.com.key
SSLCertificateChainFile /etc/httpd/ssl/ca_bundle.crt
SSLProtocol -all +TLSv1.2 +TLSv1.3
SSLCipherSuite HIGH:!aNULL:!MD5:!3DES:!RC4
SSLHonorCipherOrder off
Header always set Strict-Transport-Security "max-age=31536000"
</VirtualHost>
Tomcat 走 JSSE,通常使用 PKCS12 而非已被弃用的 JKS,证书与私钥都在同一个 keystore 内:
<Connector port="443" protocol="org.apache.coyote.http11.Http11NioProtocol"
SSLEnabled="true" maxThreads="200">
<SSLHostConfig>
<Certificate certificateKeystoreFile="/opt/tomcat/conf/cert.pfx"
certificateKeystorePassword="YourPassword"
certificateKeystoreType="PKCS12"
type="RSA" />
</SSLHostConfig>
</Connector>
三种服务器的参数对应关系如下,迁移配置时可直接对照:
| 功能 | Nginx | Apache | Tomcat |
|---|---|---|---|
| 证书文件 | ssl_certificate(含链) | SSLCertificateFile | certificateKeystoreFile |
| 私钥 | ssl_certificate_key | SSLCertificateKeyFile | 含在 keystore 内 |
| 中间证书 | 拼入 fullchain.pem | SSLCertificateChainFile | 含在 keystore 内 |
| 协议控制 | ssl_protocols | SSLProtocol | sslProtocol / protocols |
| OCSP 装订 | ssl_stapling on | SSLUseStapling on | 需 JVM 参数或前置代理 |
| 配置校验 | nginx -t | apachectl configtest | 重启后看 catalina.out |
修改后执行 apachectl configtest && systemctl reload httpd;Tomcat 则重启并检查 logs/catalina.out 中是否有 Failed to load keystore 或 Keystore was tampered with, or password was incorrect,后者基本都是 pfx 密码填错。
六、证书类型与部署方式对比:怎么选、怎么续
选型先看验证等级,再看覆盖范围。DV 只验证域名控制权,签发快、价格低;OV 会核验企业工商信息,证书详情里能看到组织名;EV 在主流浏览器已不再显示绿色地址栏,但金融、政务招标场景仍常被明文要求。
| 维度 | DV 域名型 | OV 组织型 | Let’s Encrypt |
|---|---|---|---|
| 验证内容 | DNS/文件控制权 | 域名 + 企业资质 | 域名控制权(ACME) |
| 签发时长 | 分钟级 | 1–3 个工作日 | 分钟级,全自动 |
| 最长有效期 | 398 天 | 398 天 | 90 天 |
| 通配符 | 支持(付费) | 支持(付费) | 支持,需 DNS-01 验证 |
| 续期方式 | 手工或脚本 | 手工 | ACME 自动续期 |
| 适用场景 | 博客、API、测试环境 | 官网、电商、企业门户 | 个人站、内部系统、CI 环境 |
手工上传的证书必须建立到期提醒(建议提前 30 天),否则 398 天一到照样全站报警。自动签发用 Certbot 或 acme.sh:
# Certbot(Nginx 插件会自动改写配置并 reload)
certbot --nginx -d example.com -d www.example.com --agree-tos -m ops@example.com
# 验证续期链路是否可用(不真正签发)
certbot renew --dry-run
# acme.sh 通配符(DNS API 方式,需先 export Ali_Key/Ali_Secret)
acme.sh --issue --dns dns_ali -d example.com -d '*.example.com'
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"
--reloadcmd 是 acme.sh 的关键参数:续期成功后自动重载服务,否则新证书落盘但进程仍持有旧证书,直到下次重启才生效——这是“续期成功却仍显示过期”最常见的原因。泛域名证书走 DNS-01 验证,必须能通过 DNS API 写入 TXT 记录,纯 HTTP-01 无法签发通配符。
七、常见错误排查:真实报错与对应解法
下面这些报错在部署现场出现频率最高,按报错原文对照即可快速定位。
| 报错原文 | 根因 | 处理 |
|---|---|---|
| nginx: [emerg] SSL_CTX_use_PrivateKey_file(…) failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch) | 证书与私钥不配对 | 用第三节的 modulus / pubkey MD5 比对,重新上传匹配的一对 |
| curl: (60) SSL certificate problem: unable to get local issuer certificate | 缺少中间证书 | 拼接 fullchain.pem 并用 openssl verify 验证 |
| NET::ERR_CERT_COMMON_NAME_INVALID | 访问的域名不在 SAN 中 | 重新签发含该域名的证书,不要依赖 CN 字段 |
| NET::ERR_CERT_DATE_INVALID | 证书过期或服务器时间偏差 | timedatectl set-ntp true 校时,并检查续期任务 |
| ERR_SSL_PROTOCOL_ERROR | 客户端与服务器无共同协议版本 | 确认 ssl_protocols 至少包含 TLSv1.2 |
| nginx: [warn] “ssl_stapling” ignored, no OCSP responder URL in the certificate | 证书无 OCSP 地址或未配 resolver | 补 resolver 指令,或直接关闭 stapling |
| AH01909: RSA certificate configured for example.com:443 does NOT include an ID which matches the server name | ServerName 与证书域名不符 | 修正 VirtualHost 的 ServerName 或更换证书 |
排障顺序建议“从下往上”:先 ss -lntp | grep 443 确认进程在监听,再 nginx -t 确认配置语法,然后 openssl s_client -connect 127.0.0.1:443 -servername example.com 看本机握手返回的证书链,最后才排查 CDN/WAF 层。很多“证书不生效”其实是流量走了 CDN,源站换了证书但边缘节点还是旧的,需要在 CDN 控制台重新上传或刷新缓存。另外别忘了检查是否被安全软件或旧版客户端的证书信任库拦截。
八、效果验证与自动化续期监控
配置完成后按以下清单逐项验证,全部通过才算部署结束。
# 1. 检查是否 301 跳转到 HTTPS
curl -I http://example.com
# 2. 查看实际协商的协议与加密套件
curl -Iv https://example.com 2>&1 | grep -E "SSL connection|TLS"
# 3. 查看线上证书的颁发者、有效期、SAN
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null
| openssl x509 -noout -issuer -dates -ext subjectAltName
# 4. 单独测试 TLS 1.2 / TLS 1.3 是否可用
openssl s_client -connect example.com:443 -tls1_2 </dev/null 2>&1 | grep "Cipher is"
openssl s_client -connect example.com:443 -tls1_3 </dev/null 2>&1 | grep "Cipher is"
# 5. 检查 HSTS 响应头
curl -sI https://example.com | grep -i strict-transport-security
第 3 条命令的输出里,notAfter 就是要监控的到期时间,issuer 应显示中间 CA 而非根 CA。再用 SSL Labs(https://www.ssllabs.com/ssltest/)跑一次完整评估,目标等级 A 或 A+;若只得 B,通常是仍支持 TLS 1.0/1.1,或存在 RC4、3DES 等弱套件。
自动化方面,Certbot 安装时会注册 systemd timer,确认其处于启用状态:
systemctl list-timers | grep certbot
systemctl status certbot.timer
certbot renew --dry-run
acme.sh 依赖 crontab:crontab -l | grep acme.sh,正常应有一行带 --cron 的任务。最后补一条到期监控脚本,把结果接到告警系统:
#!/bin/bash
DOMAIN="example.com"
END=$(echo | openssl s_client -connect $DOMAIN:443 -servername $DOMAIN 2>/dev/null
| openssl x509 -noout -enddate | cut -d= -f2)
LEFT=$(( ( $(date -d "$END" +%s) - $(date +%s) ) / 86400 ))
[ $LEFT -lt 20 ] && echo "WARN: $DOMAIN 证书仅剩 $LEFT 天" | mail -s "SSL 到期告警" ops@example.com
上线 HSTS 前务必确认所有子域都已支持 HTTPS,因为 includeSubDomains 一旦下发并被浏览器缓存,回退成本极高。建议先用 max-age=300 试跑一周,确认无 HTTP 子资源后再放大到 31536000。
常见问题
按 CA/Browser Forum 规定,公有可信 TLS 证书单次有效期最长 398 天,Let’s Encrypt 免费证书为 90 天。到期必须重新签发而非“续费延期”,因此要配置自动续期与到期告警,建议在剩余 20–30 天时触发提醒。
几乎都是证书链不完整:桌面浏览器能自动下载缺失的中间证书,Android、微信内置浏览器和 Java 客户端不会。把服务器证书与中间证书按顺序拼成 fullchain.pem,用 openssl verify 验证后再部署即可解决。
取决于证书类型:单域名证书只保护一个完整域名;多域名证书(SAN 证书)默认覆盖 3–5 个域名,可付费扩展;通配符证书保护 *.example.com 下所有同级子域,但不含 example.com 本身,通常需要额外添加。
先开启 TLS 1.3 与会话复用(ssl_session_cache shared:SSL:10m),再启用 OCSP Stapling 减少握手往返;证书优先选 ECDSA P-256 而非 RSA 2048,握手包更小。正常 TLS 额外开销在 50ms 以内,若明显变慢应排查 CDN 回源与协议配置。
新证书落盘后 Nginx/Apache 不会自动重新加载,进程仍持有旧证书。需在续期脚本里加 reload 钩子:acme.sh 用 –reloadcmd “systemctl reload nginx”,Certbot 用 –deploy-hook。若前面有 CDN,还要在控制台更新边缘证书。
立即向 CA 申请吊销该证书并重新签发新的密钥对,不要复用旧私钥;同时排查服务器上是否存在备份泄露、Web 目录是否可下载 .key 文件,把私钥权限改为 600 且属主为 root,并检查访问日志确认是否已被利用。