HTTPS 配置与 SSL 证书安装全流程实战:Nginx/Apache/Tomcat 部署、报错排查与效果验证
问题背景与根因:HTTPS 配置失败的六类真实原因
绝大多数「HTTPS 打不开」「证书装完还是不安全」的工单,根因并不在证书本身,而在部署环节的六类问题:①只下发了服务器证书(server certificate),漏装中间证书(intermediate CA),客户端报 unable to get local issuer certificate;②私钥与证书不匹配,Nginx 直接启动失败;③证书与域名不匹配,例如只签了 www 却用裸域访问,或误以为泛域名能覆盖二级以上子域;④页面内仍是 http:// 绝对链接,触发混合内容(mixed content)拦截;⑤TLS 协议版本与加密套件过旧,被现代浏览器判定为弱加密;⑥80 端口未做 301 跳转,同一内容被双协议重复收录。
先用三条命令做自检,可定位约 80% 的故障:
# 1. 校验证书与私钥是否配对,两条输出的 MD5 必须完全一致
openssl x509 -noout -modulus -in server.crt | openssl md5
openssl rsa -noout -modulus -in server.key | openssl md5
# 2. 校验证书链完整性,正常应输出 OK
openssl verify -CAfile fullchain.crt server.crt
# 报 error 20 at 0 depth lookup: unable to get local issuer certificate 即链不完整
# 3. 校验证书覆盖的域名列表
openssl x509 -noout -text -in server.crt | grep -A1 'Subject Alternative Name'
必须纠正两个被老教程带偏的事实:其一,按 CA/Browser Forum 基线要求,公有 CA 签发的单张 TLS 证书有效期上限为 398 天,主流 CA 实际签发多为 90~365 天;其二,Let’s Encrypt 免费证书有效期为 90 天,并已提供更短的 6 天周期选项,必须配合自动续期,否则到期当天全站变成「您的连接不是私密连接」。因此正确认知是「安装 + 自动化续期 + 到期监控」三件套,而非一次安装永久有效。
前置准备:生成 CSR、规划域名与选择证书类型
申请证书的第一步是生成私钥与 CSR(Certificate Signing Request)。推荐 ECDSA P-256,密钥体积小、握手更快,主流浏览器与 Android 7+ 均已支持;若需兼容老旧 Android 5、部分 IoT 设备或 Java 6 客户端,则退回 RSA 2048。
# 方案 A:ECDSA P-256 私钥 + CSR(推荐)
openssl ecparam -genkey -name prime256v1 -out 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'
# 方案 B:RSA 2048 私钥 + CSR(兼容性优先)
openssl genrsa -out example.com.key 2048
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'
# 检查 CSR 内容是否正确
openssl req -noout -text -in example.com.csr | head -20
CN 只写一个主域名,多域名必须写进 SAN(Subject Alternative Name)。申请时把 example.com 与 www.example.com 一并提交;泛域名 *.example.com 只覆盖一级子域,不覆盖裸域,也不覆盖 a.b.example.com。DV 证书走 DNS TXT 或 HTTP 文件验证,通常 10 分钟内签发;OV/EV 需人工核验工商信息与电话,一般 1~2 个工作日,EV 还需完成企业电话回呼(座机、DUNS 记录或信用公示平台登记的企业电话均可)。域名规划上建议只保留一个规范域名(裸域或 www 二选一),其余全部 301 过去;后台与 API 用独立子域单独签证书,避免单张证书泄露影响全域。
完整实操:Nginx 部署 SSL 证书的 7 个步骤
以 Ubuntu 22.04 + Nginx 1.18 为例,以下命令可直接复制执行。
# 1. 建立证书目录,权限收紧,私钥只允许 root 读取
sudo mkdir -p /etc/nginx/ssl/example.com
sudo cp fullchain.crt /etc/nginx/ssl/example.com/
sudo cp example.com.key /etc/nginx/ssl/example.com/
sudo chmod 600 /etc/nginx/ssl/example.com/example.com.key
sudo chown root:root /etc/nginx/ssl/example.com/*
# 2. 写入 server 配置(模板见下一节)
# 3. 语法检查,必须看到 syntax is ok 与 test is successful
sudo nginx -t
# 4. 平滑重载,不断开现有连接
sudo systemctl reload nginx
# 5. 放行 443(firewalld 与 ufw 二选一)
sudo firewall-cmd --permanent --add-service=https && sudo firewall-cmd --reload
sudo ufw allow 443/tcp
# 6. 验证自动续期链路是否可用(Let's Encrypt 场景)
sudo certbot renew --dry-run
# 7. 添加续期后的重载钩子脚本,内容仅一行:systemctl reload nginx
sudo mkdir -p /etc/letsencrypt/renewal-hooks/deploy
sudo vi /etc/letsencrypt/renewal-hooks/deploy/reload-nginx.sh
sudo chmod +x /etc/letsencrypt/renewal-hooks/deploy/reload-nginx.sh
四个易踩的细节:ssl_certificate 必须指向 fullchain(叶子证书 + 中间证书拼接),只写叶子证书会让部分客户端握手失败;ssl_certificate_key 指向私钥,两者路径写反会直接启动失败;ssl_protocols 只保留 TLSv1.2 与 TLSv1.3,删除 TLSv1 与 TLSv1.1;开启 ssl_session_cache shared:SSL:10m 可缓存约 4 万个会话,显著降低重复握手开销。
配置示例:Nginx / Apache / Tomcat 三套可套用模板
Nginx(1.25.1 起 http2 on; 替代旧的 listen 443 ssl http2):
server {
listen 80;
server_name example.com www.example.com;
return 301 https://example.com$request_uri;
}
server {
listen 443 ssl;
http2 on;
server_name example.com;
ssl_certificate /etc/nginx/ssl/example.com/fullchain.crt;
ssl_certificate_key /etc/nginx/ssl/example.com/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:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384;
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/example.com/chain.crt;
resolver 223.5.5.5 1.1.1.1 valid=300s;
add_header Strict-Transport-Security 'max-age=31536000; includeSubDomains' always;
add_header X-Content-Type-Options nosniff always;
root /var/www/html;
index index.html;
}
Apache 2.4(需启用 mod_ssl 与 mod_headers):
<VirtualHost *:443>
ServerName example.com
DocumentRoot /var/www/html
SSLEngine on
SSLCertificateFile /etc/httpd/ssl/example.com.crt
SSLCertificateKeyFile /etc/httpd/ssl/example.com.key
SSLCertificateChainFile /etc/httpd/ssl/chain.crt
SSLProtocol -all +TLSv1.2 +TLSv1.3
SSLCipherSuite HIGH:!aNULL:!MD5:!3DES
SSLHonorCipherOrder off
Header always set Strict-Transport-Security 'max-age=31536000'
</VirtualHost>
Tomcat 9/10(推荐 PKCS12,替代已废弃的 JKS):
openssl pkcs12 -export -in fullchain.crt -inkey example.com.key
-out example.com.p12 -name tomcat -passout pass:Changeit123
# server.xml 中 Connector 需设置的关键属性:
# port=8443 protocol=org.apache.coyote.http11.Http11NioProtocol
# SSLEnabled=true scheme=https secure=true
# certificateKeystoreFile=/opt/tomcat/conf/example.com.p12
# certificateKeystorePassword=Changeit123 certificateKeystoreType=PKCS12
# sslProtocol=TLSv1.2,TLSv1.3
| 服务器 | 证书指令 | 私钥指令 | 协议指令 | 生效命令 |
|---|---|---|---|---|
| Nginx | ssl_certificate(fullchain) | ssl_certificate_key | ssl_protocols | nginx -t && nginx -s reload |
| Apache | SSLCertificateFile + SSLCertificateChainFile | SSLCertificateKeyFile | SSLProtocol | apachectl configtest && apachectl -k graceful |
| Tomcat | certificateKeystoreFile | certificateKeystorePassword | sslProtocol | shutdown.sh && startup.sh |
证书类型与部署方案对比表
选型不要只看价格,要看验证等级、有效期与运维成本。下表为当前实际可签发的情况:
| 证书类型 | 验证内容 | 签发时长 | 有效期上限 | 浏览器展示 | 适用场景 |
|---|---|---|---|---|---|
| Let’s Encrypt DV | 域名控制权(HTTP-01 / DNS-01) | 1~10 分钟 | 90 天,需自动续期 | 锁标志 | 个人站、测试环境、中小站点 |
| 商业 DV | 域名控制权 | 10 分钟~2 小时 | 398 天 | 锁标志 | 多域名 SAN、泛域名业务 |
| OV | 域名 + 企业工商信息核验 | 1~2 个工作日 | 398 天 | 锁标志,点开可见企业名 | 企业官网、B 端 SaaS |
| EV | 域名 + 企业 + 电话/DUNS 回呼 | 2~5 个工作日 | 398 天 | 锁标志(Chrome 77 起已取消绿色地址栏) | 金融、支付、政企 |
再补充一组部署形态对比:单域名证书成本最低但扩展性差;多域名 SAN 证书一张覆盖 5~100 个域名,适合多子域业务;泛域名证书覆盖一级子域,但私钥一旦泄露影响全域,且无法用于裸域。工程上更稳妥的做法是「泛域名 + 关键域名单独签」,并用配置管理工具统一分发,避免手工拷贝导致的版本混乱。
常见错误排查:8 条真实报错与对应解法
下面每一条都是线上工单中出现频率最高的原始报错,直接对照处理即可。
| 报错信息 | 根因 | 解法 |
|---|---|---|
| nginx: [emerg] PEM_read_bio_X509_AUX(…) failed (SSL: error:0909006C:PEM routines:get_name:no start line) | 证书是 DER 二进制,或下载时被 HTML 页面内容污染 | openssl x509 -in a.crt -inform DER -out a.pem 转换,或从 CA 重新下载 PEM |
| nginx: [emerg] SSL_CTX_use_PrivateKey(…) failed (SSL: error:0B080074:X509_check_private_key:key values mismatch) | 私钥与证书不配对,常见于多张证书混用 | 用 modulus md5 比对后重新配对 |
| curl: (60) SSL certificate problem: unable to get local issuer certificate | 缺中间证书,只部署了叶子证书 | 改用 fullchain.crt 并确认链文件顺序 |
| NET::ERR_CERT_COMMON_NAME_INVALID | 证书未覆盖当前访问域名(www 与裸域不一致) | 重签含 SAN 的证书,或统一 301 到已覆盖域名 |
| Mixed Content: The page at https://… was loaded over HTTPS, but requested an insecure element http://… | 页面内存在 http 绝对链接 | 改为 // 或 https,并下发 CSP upgrade-insecure-requests |
| SSL_ERROR_NO_CYPHER_OVERLAP | 客户端与服务器无交集加密套件(老 XP / Java 6) | 临时放行 TLSv1.2 兼容套件,或推动客户端升级 |
| AH01909: RSA certificate configured for www.example.com:443 does not include an ID which matches the server name | Apache 中 ServerName 与证书域名不一致 | 修正 ServerName 或更换匹配证书 |
| 525 SSL handshake failed(Cloudflare 回源) | 源站 443 未监听或证书链错误 | 源站执行 openssl s_client 自测,回源模式改为 Full (strict) |
关于第 5 条要特别说明:配置完成后如果页面样式错乱、图片加载失败,绝大多数不是证书配置问题,而是程序模板里硬编码了 http:// 调用。排查命令:curl -s https://example.com | grep -o 'http://[^"]*' | head -20,把命中的资源逐个改为相对协议或 https,再清理 CDN 与浏览器缓存。
效果验证:从命令行到浏览器评级
配置完成不等于生效,必须做四层验证:协议与套件、证书链、跳转与安全响应头、到期监控。
# 1. 查看协商结果与证书主体、签发者、有效期
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null
| openssl x509 -noout -subject -issuer -dates
# 2. 确认旧协议已关闭,期望输出 handshake failure 或 alert protocol version
openssl s_client -connect example.com:443 -tls1_1 </dev/null
# 3. 检查 80 跳转与 HSTS 响应头
curl -sI http://example.com | head -3
curl -sI https://example.com | grep -Ei 'strict-transport-security|^HTTP/'
# 4. 取到期时间,剩余不足 15 天应触发告警
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null
| openssl x509 -noout -enddate
浏览器侧按 F12 打开 Security 面板,确认 Connection 显示 TLS 1.3、Certificate 显示有效且证书链完整;Console 中不应出现 Mixed Content 告警。第三方评级可提交 SSL Labs 检测,目标是 A 及以上;若出现「This server supports weak Diffie-Hellman parameters」或「Uses SHA-1」,需替换为 ECDHE 套件并重签证书。最后把到期检查接入监控(Zabbix / Prometheus blackbox_exporter 的 probe_ssl_earliest_cert_expiry 指标),阈值设为剩余 15 天告警,这才是完整的 HTTPS 交付。
常见问题
证书已经安装,浏览器仍提示不安全怎么办?
按顺序排查三点:一是证书链是否完整,执行 openssl verify -CAfile fullchain.crt server.crt 看是否 OK;二是访问域名是否在证书 SAN 列表中,注意 www 与裸域是两张不同的名字;三是系统时间是否准确,客户端时间偏差超过证书有效期会直接报错。若三项都正常,检查是否有 CDN 或 WAF 层终止了 TLS 并返回了自签证书。
一张证书可以同时用于多个域名或子域吗?
可以,用多域名 SAN 证书,一张证书可写多个完全不同的域名,主流 CA 支持 5~100 个。泛域名 *.example.com 只覆盖一级子域,不覆盖裸域 example.com,也不覆盖 a.b.example.com,实际使用中通常需要「泛域名 + 裸域」组合下单。
Let’s Encrypt 免费证书和付费证书的核心差别是什么?
加密强度没有差别,都是 2048 位 RSA 或 P-256 ECDSA。差别在三点:有效期 90 天对 398 天,免费证书必须做自动续期;验证等级只有 DV,不含企业身份核验;无商业 SLA 与人工支持。对外服务的生产环境建议用商业 OV 证书,测试与内部系统用 Let’s Encrypt 完全够用。
证书续期或更换服务器后需要重新配置吗?
续期只替换证书文件,配置文件不用改,但必须重载服务:Nginx 执行 nginx -t && nginx -s reload,Apache 执行 apachectl -k graceful,Tomcat 需重启。迁移服务器时私钥要一并迁移,否则新机器上的证书无法使用;如果私钥已泄露,必须重新签发而不是复制旧文件。
启用 HTTPS 后还需要单独配置 HTTP/2 吗?
需要。HTTP/2 在主流服务器上依赖 TLS(h2 协议),但必须显式开启:Nginx 1.25.1 之前写 listen 443 ssl http2;,之后写 http2 on;;Apache 需加载 mod_http2 并设置 Protocols h2 http/1.1。开启后可用 curl -sI --http2 https://example.com 验证返回 HTTP/2。
HSTS 头可以随便加吗?
不建议一开始就设长周期。建议先用 max-age=300 观察一周,确认全站资源与子域都已支持 HTTPS,再逐步提升到 31536000 并追加 includeSubDomains。一旦下发长周期 HSTS 且某个子域只有 HTTP 服务,该子域在有效期内将无法被访问,回滚只能等 max-age 到期。