HTTPS 配置与 SSL 证书安装全流程:Nginx/Apache/Tomcat 实操、真实报错排查与验证
一、HTTPS 配置失败的根因:TLS 到底在哪一层起作用
SSL/TLS 位于 TCP/IP 与 HTTP 等应用层协议之间,分两层工作:记录协议(SSL Record Protocol)建立在 TCP 之上,负责数据封装、压缩与对称加密;握手协议(SSL Handshake Protocol)建立在记录协议之上,在真正传输数据前完成身份认证、加密套件协商与密钥交换。它对外提供三项服务:认证服务器身份(确保数据发到了正确的站点)、加密数据(防中途窃取)、校验完整性(防传输中被篡改)。
理解这个分层,就能理解为什么「证书买了、装上了,HTTPS 还是打不开」是常态:故障可能落在证书、私钥、证书链、协议版本、端口、DNS、SNI 任意一环。按线上工单统计,根因分布大致是:证书链不完整约 40%,私钥与证书不匹配约 15%,443 端口或安全组未放行约 15%,访问域名不在证书 SAN 列表内约 10%,页面混合内容约 10%,协议或加密套件过旧约 10%。因此排查顺序应当是「先确认服务端握手是否成功,再看浏览器是否信任,最后看页面资源」。
用两条命令就能排除一半的服务端问题:
# 1) 看服务端实际返回的证书主体、签发者与有效期
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | openssl x509 -noout -subject -issuer -dates
# 2) 校验私钥与证书是否配对,两条命令的 md5 必须完全一致
openssl x509 -noout -modulus -in example.com.pem | openssl md5
openssl rsa -noout -modulus -in example.com.key | openssl md5
如果第一条命令直接返回 connect: Connection refused,说明 443 端口没有监听或被安全组拦截,与证书无关;如果能返回证书但浏览器仍报错,就继续往下检查证书链与域名匹配。
二、动手前的三项准备:证书选型、私钥保护与 CSR 生成
第一项是选型。公开信任证书的单张有效期上限为 398 天(CA/Browser Forum 规定,Apple 自 2020-09-01 起对超期证书直接拒绝),并已确定继续缩短的时间表;Let’s Encrypt 免费证书固定 90 天,必须靠 ACME 自动续期,手工续期几乎必然过期。内网或测试环境可以用自签名证书,但浏览器不会信任,需要手动把根证书导入客户端信任库。
第二项是私钥。私钥文件权限必须 600、属主为运行 Web 服务的用户;私钥泄露等同于证书作废,只能吊销重签。商业 CA 只应收到 CSR,私钥永远不要外发。
第三项是 CSR。CSR 里最关键的是 CN 与 SAN,现代浏览器只认 SAN,CN 仅作兼容展示。生成与检查命令如下:
# 生成 2048 位 RSA 私钥与 CSR(-nodes 表示私钥不加密,便于服务自动加载)
openssl req -new -newkey rsa:2048 -sha256 -nodes
-keyout example.com.key -out example.com.csr
-subj '/C=CN/ST=Shanghai/L=Shanghai/O=Example Tech/CN=example.com'
-addext 'subjectAltName=DNS:example.com,DNS:www.example.com'
# 检查 CSR 内容,重点看 Subject 与 X509v3 Subject Alternative Name
openssl req -in example.com.csr -noout -text | grep -A2 'Subject Alternative Name'
# Let's Encrypt 自动化签发与续期演练
sudo certbot certonly --webroot -w /var/www/html -d example.com -d www.example.com
--email ops@example.com --agree-tos --no-eff-email
sudo certbot renew --dry-run
拿到签发结果后要注意文件顺序:fullchain 必须是「服务器证书 → 中间证书」,根证书不要放进去,否则部分客户端会报多余证书告警;同时确认证书的 SAN 覆盖了实际访问的所有域名(含带 www 与裸域)。
三、Nginx 完整实操:从上传文件到 reload 生效
下面是在 Ubuntu/Debian 与 CentOS 上通用的完整流程,命令可直接执行:
# 1) 建目录、放证书(fullchain = 站点证书 + 中间证书)
sudo mkdir -p /etc/nginx/ssl
sudo cp example.com.fullchain.pem /etc/nginx/ssl/
sudo cp example.com.key /etc/nginx/ssl/
sudo chmod 600 /etc/nginx/ssl/example.com.key
sudo chown root:root /etc/nginx/ssl/*
# 2) 写入站点配置
sudo vim /etc/nginx/conf.d/example.com.conf
# 3) 语法检查通过后再 reload,不要直接 restart
sudo nginx -t
sudo systemctl reload nginx
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/example.com.fullchain.pem;
ssl_certificate_key /etc/nginx/ssl/example.com.key;
ssl_protocols TLSv1.2 TLSv1.3; # TLSv1.0/1.1 已于 2021 年被 RFC 8996 弃用
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/example.com.chain.pem;
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 index.php;
}
几个容易踩坑的点:ssl_certificate 指向的文件必须包含中间证书,否则 Android 与部分 Java 客户端会报「证书链不完整」;ssl_stapling 依赖 ssl_trusted_certificate 提供完整链,且必须配置 resolver 才能解析 OCSP 地址;HSTS 建议先用 max-age=300 灰度一周,确认全站 HTTPS 无遗漏后再调成 31536000,否则一旦有 http 资源会被浏览器直接拦截且难以回滚。证书续期后无需改配置,只需 nginx -t && systemctl reload nginx 重新加载私钥与证书。
四、Apache、Tomcat、IIS 配置示例与文件对照
Apache(httpd)使用 PEM 明文证书,链文件单独指定:
<VirtualHost *:443>
ServerName example.com
SSLEngine on
SSLCertificateFile /etc/httpd/ssl/example.com.crt
SSLCertificateKeyFile /etc/httpd/ssl/example.com.key
SSLCertificateChainFile /etc/httpd/ssl/example.com.ca-bundle # 2.4.8+ 可直接并入 SSLCertificateFile
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 需要 JKS 或 PKCS12 容器,先转换再改 server.xml:
keytool -importkeystore -srckeystore example.pfx -srcstoretype PKCS12
-destkeystore /opt/tomcat/conf/example.jks -deststoretype JKS
<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='ChangeMe123'
certificateKeystoreType='JKS' type='RSA'/>
</SSLHostConfig>
</Connector>
IIS 使用 PFX 导入本地计算机的个人存储,再由站点绑定 443:
Import-PfxCertificate -FilePath C:sslexample.pfx -CertStoreLocation Cert:LocalMachineMy `
-Password (ConvertTo-SecureString -String 'PfxPass' -AsPlainText -Force)
netsh http show sslcert hostnameport=example.com:443
四个平台的文件形态不同,本质都是「私钥 + 站点证书 + 中间证书」三件套。跨平台迁移时,用 openssl pkcs12 -export -in fullchain.pem -inkey example.com.key -out example.pfx 即可把 PEM 转成 PFX,再交给 Tomcat 或 IIS 使用;Tomcat 的 keystore 密码不要含特殊字符,否则启动时会报 Keystore was tampered with, or password was incorrect。
五、证书类型与部署方案对比:怎么选不花冤枉钱
按验证等级划分,公开信任证书主要分三类,再加上免费 ACME 与自签名:
| 类型 | 验证内容 | 签发耗时 | 单张有效期 | 适用场景 |
|---|---|---|---|---|
| DV 域名型 | 仅验证域名控制权(DNS/文件) | 数分钟~1 小时 | 最长 398 天 | 博客、测试、内部工具、API 网关 |
| OV 企业型 | 域名 + 企业工商信息核验 | 1~3 个工作日 | 最长 398 天 | 企业官网、SaaS、电商 |
| EV 扩展型 | 严格主体核验 | 3~7 个工作日 | 最长 398 天 | 金融、支付(浏览器已取消绿色地址栏) |
| Let’s Encrypt | 域名控制权(ACME 协议) | 秒级 | 90 天,需自动续期 | 个人站、容器与 CI 环境 |
| 自签名 | 无 | 即时 | 自定义 | 内网联调,浏览器不信任 |
再按覆盖范围选:
| 覆盖方式 | 示例 | 覆盖范围 | 注意点 |
|---|---|---|---|
| 单域名 | example.com | 1 个主机名 | 带 www 的域名需另配或写入 SAN |
| 多域名 SAN | example.com + api.example.com | 通常 5~100 个 | 所有证书都有 SAN 字段,重点看它 |
| 通配符 | *.example.com | 同级子域不限 | 不覆盖裸域,也不覆盖 a.b.example.com |
选择建议:能自动续期就不要手工续期。398 天的上限意味着一年至少一次续签窗口,而 90 天的免费证书只要 ACME 定时任务可靠,反而更不容易过期。EV 证书的绿色地址栏早已被主流浏览器取消,只有合规展示需求才值得采购。
六、常见错误排查:真实报错与对应处置
下面这些报错在工单里出现频率最高,按「报错原文 → 根因 → 处置」对照处理:
| 报错原文 | 根因 | 处置 |
|---|---|---|
| nginx: [emerg] cannot load certificate … BIO_new_file() failed (SSL: error:02001002:system library:fopen:No such file or directory) | 路径写错、权限不足或 SELinux 拦截 | ls -l 确认文件存在;chmod 600;执行 restorecon -Rv /etc/nginx/ssl |
| nginx: [emerg] SSL_CTX_use_PrivateKey … key values mismatch | 私钥与证书不配对 | 用第二节的 modulus md5 比对,重新部署匹配的 key |
| curl: (60) SSL certificate problem: unable to get local issuer certificate | 服务端未发送中间证书 | 把中间证书拼进 fullchain.pem,站点证书在前 |
| NET::ERR_CERT_COMMON_NAME_INVALID / SSL_ERROR_BAD_CERT_DOMAIN | 访问域名不在 CN/SAN 内 | 重签含该域名的证书,或改用通配符证书 |
| ERR_SSL_PROTOCOL_ERROR | 443 端口跑的是 HTTP,或只支持已被禁用的 TLS 版本 | 确认配置里有 listen 443 ssl;开放 TLSv1.2/1.3 |
| Mixed Content: This request has been blocked; the content must be served over HTTPS | 页面内仍引用 http:// 资源 | 见第七节的批量修复方法 |
| Cloudflare 522 / 525 | 回源超时 / 源站与边缘握手失败 | 检查源站 443 是否对 CF 回源段放行、证书是否在有效期 |
补充三条定位命令:
# 从外部模拟浏览器握手,只看协议与加密套件
openssl s_client -connect example.com:443 -servername example.com -tls1_2 </dev/null
# 查看证书到期时间
openssl x509 -in example.com.fullchain.pem -noout -enddate
# 确认 443 是否监听、本机防火墙状态
ss -lntp | grep 443
还有一个容易忽略的点:证书本身没问题,但服务器时间偏差超过 5 分钟,浏览器会直接报 certificate is not yet valid 或 certificate has expired,用 timedatectl 校时并开启 NTP 同步即可。
七、HTTPS 页面错乱、样式丢失:混合内容的根因与修复
「配置完成后页面错乱、图片不显示、支付回调失败」几乎都是混合内容(Mixed Content)导致的:HTML 通过 HTTPS 加载,但里面的 CSS、JS、图片、接口仍写着 http://,浏览器按规则处理——被动内容(图片、音频)降级警告,主动内容(脚本、XHR、iframe)直接阻断。这不是证书配置问题,而是程序里硬编码了 http 链接,改证书不会好。
先用命令把残留链接抓出来:
# 统计首页中残留的 http:// 引用数量,并列出前 10 条
curl -s https://example.com/ | grep -o 'http://[^ ]*' | head -10
curl -s https://example.com/ | grep -c 'http://'
修复按优先级来:
- 静态资源与站内链接:把 http:// 改为 https:// 或协议相对写法 //,模板、数据库、CDN 回源配置三处都要改。
- CMS 批量替换:先备份数据库,再用
wp search-replace 'http://example.com' 'https://example.com' --all-tables --precise执行,避免直接 UPDATE 破坏序列化字段。 - 兜底响应头:
add_header Content-Security-Policy 'upgrade-insecure-requests' always;可让浏览器自动把 http 子资源升级为 https 请求。 - 第三方资源:字体、统计脚本、支付回调地址必须确认支持 HTTPS,不支持的只能替换服务商。
- 跨域接口:后端
Access-Control-Allow-Origin不能写成 http:// 域名,否则请求会被 CORS 拦截。
改完后打开 Chrome DevTools 的 Console,确认不再出现 Mixed Content 警告,再检查 Network 面板中所有资源状态码是否正常,这一步做完页面样式才会真正恢复。
八、上线验证与巡检:从握手到评分的四步确认
配置完不要只看浏览器有没有小锁。按四步验证:
# 1) 握手与证书链,期望输出 Verify return code: 0 (ok)
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null | grep -E 'Verify return code|Protocol|Cipher'
# 2) 强制跳转与 HSTS 头
curl -sI http://example.com | head -3
curl -sI https://example.com | grep -i strict-transport-security
# 3) 到期时间与 SAN 覆盖
openssl x509 -in example.com.fullchain.pem -noout -enddate -ext subjectAltName
# 4) 弱协议必须被拒绝,期望握手失败
openssl s_client -connect example.com:443 -tls1 </dev/null | grep -E 'Protocol|alert'
浏览器侧:Chrome DevTools → Security 面板应显示 This page is secure,Console 不应出现 Mixed Content 警告;第三方评分(SSL Labs)目标 A 及以上,常见扣分项是未开 HSTS、仍支持 TLS 1.0/1.1、未启用 OCSP Stapling。
最后一定要做到期监控,这是运维里最容易翻车的一环:
# 剩余天数小于 20 天时告警
END=$(openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null | openssl x509 -noout -enddate | cut -d= -f2)
echo $(( ( $(date -d "$END" +%s) - $(date +%s) ) / 86400 )) 天
把这条命令挂到 Zabbix/Prometheus 黑盒探针或每日 cron 里,配合 certbot renew --dry-run 定期演练,基本可以杜绝「证书过期导致全站不可用」这类事故。
常见问题
九成是证书链不完整:服务端只发了站点证书,没带中间证书。把中间证书按「站点证书→中间证书」顺序拼进 fullchain.pem,用 openssl s_client -showcerts 确认返回两条以上证书,再 reload 即可恢复。
公开信任证书单张有效期上限为 398 天,且后续还会继续缩短;Let’s Encrypt 固定 90 天。建议全部改用 ACME 自动续期,并用 certbot renew –dry-run 验证续期链路,避免手工续签漏期。
不能。*.example.com 只覆盖同级子域(如 www、api),不覆盖裸域 example.com,也不覆盖多级子域 a.b.example.com。签发时把裸域写进 SAN,或采用「通配符 + 单域名」两张证书组合。
不是。这是混合内容,页面内仍引用 http:// 的 CSS、JS 或接口被浏览器拦截。用 curl 抓首页 grep 出 http:// 引用并改写为 https:// 或 //,CMS 可用 wp search-replace 批量替换,再加 upgrade-insecure-requests 兜底。
不建议。TLS 1.0/1.1 已于 2021 年被 RFC 8996 正式弃用,主流浏览器与支付机构均拒绝握手。配置中只保留 TLSv1.2 与 TLSv1.3,用 openssl s_client -tls1 测试应返回握手失败。