跳到主要内容
ssl证书按装

HTTPS 配置与 SSL 证书安装全流程:Nginx/Apache/Tomcat 实操、真实报错排查与验证

HTTPS 配置与 SSL 证书安装全流程:Nginx/Apache/Tomcat 实操、真实报错排查与验证 — 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 测试应返回握手失败。

内容审核

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