跳到主要内容
SSL 证书付费服务

NGINX、Apache、Tomcat、IIS、宝塔面板 SSL 证书安装配置全流程与报错排查实战

NGINX、Apache、Tomcat、IIS、宝塔面板 SSL 证书安装配置全流程与报错排查实战 — NGINX、Apache、Tomcat、IIS、宝塔面板 SSL 证书安装配置全流程与报错排查实战

证书买了却装不上:HTTPS 部署失败的五个真实根因

大量站点在购买 SSL 证书之后卡在部署环节,浏览器仍然提示「不安全」。把线上工单的失败案例做归因,95% 落在下面五类:

  • 证书链不完整:只部署了站点证书 cert.pem,漏掉中间 CA。桌面浏览器有时靠 AIA 自动补链而「看起来正常」,但 Android 客户端、Java、curl 会直接报错。
  • 私钥与证书不匹配:CSR 生成了多次,最后上传的 key 不是签发时用的那一把。
  • 未启用 SNI:同一 IP 承载多个域名时,客户端拿到的是默认站点的证书。
  • 协议与套件过时:仍开启 TLS 1.0/1.1,或只支持 RSA 密钥交换,被现代客户端拒绝。
  • 有效期规则变化:自 2020 年 9 月 1 日起,Apple 与 Chrome 要求 TLS 服务器证书有效期不超过 398 天;Let’s Encrypt 签发有效期固定 90 天。过去「买三年省事」的思路已经彻底失效,必须做自动化续期。

先做三件事定位问题。第一,看服务端实际返回的证书:

openssl s_client -connect www.example.com:443 -servername www.example.com -showcerts </dev/null 2>/dev/null | openssl x509 -noout -subject -issuer -dates

输出里 -subject 的 CN/SAN 必须包含你访问的域名,-issuer 应当是中间 CA 而不是根 CA。第二,校验私钥与证书是否配对,两者模数 MD5 必须一致:

openssl x509 -noout -modulus -in cert.pem | openssl md5
openssl rsa  -noout -modulus -in example.com.key | openssl md5

第三,检查证书链文件里到底有几张证书:

grep -c "BEGIN CERTIFICATE" fullchain.pem

正常应为 2 或 3。若为 1,说明缺中间证书,这就是很多「电脑能开、手机打不开」的根因。

选证书与生成 CSR:DV/OV/EV 与 398 天规则

证书按验证等级分三类:DV(域名验证,几分钟签发)、OV(组织验证,需营业执照,1–3 个工作日)、EV(扩展验证,浏览器地址栏已不再显示绿色公司名)。绝大多数站点用 DV 足够,OV/EV 的价值在于企业身份背书与更高赔付额度。

无论哪种,签发前都要提交 CSR。推荐直接用 OpenSSL 一次性生成私钥与 CSR,并把所有域名写进 SAN:

openssl req -new -newkey rsa:2048 -nodes 
  -keyout example.com.key -out example.com.csr 
  -subj "/C=CN/ST=Beijing/L=Beijing/O=Example Tech/CN=example.com" 
  -addext "subjectAltName=DNS:example.com,DNS:www.example.com,DNS:api.example.com"

参数说明:-nodes 表示私钥不加密(否则每次重载都要人工输密码);-addext 要求 OpenSSL 1.1.1 及以上,低版本需手写 openssl.cnf。也可以改用 ECDSA 密钥,体积更小、握手更快:

openssl ecparam -genkey -name prime256v1 -out example.com.key

提交前务必自检 CSR:

openssl req -in example.com.csr -noout -text | grep -A1 "Subject Alternative Name"

漏掉 www 是最常见的返工原因。另外三点容易忽略:通配符证书 *.example.com 只覆盖一级子域,a.b.example.com 不在其内,也不包含裸域,必须额外写入 SAN;证书有效期上限 398 天,到期前 30 天必须续期;私钥文件权限应为 600、属主为运行 Web 服务的账号,chmod 644 example.com.key 属于严重安全事故。

NGINX 完整配置:80 跳转 + TLS 1.3 + OCSP Stapling

NGINX 是最常见的部署环境。下面是一份可直接落地的配置,含 80 端口强制跳转、TLS 1.2/1.3、OCSP Stapling 与 HSTS:

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-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384: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/chain.pem;

    add_header Strict-Transport-Security "max-age=31536000" always;

    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_set_header Host              $host;
        proxy_set_header X-Real-IP         $remote_addr;
        proxy_set_header X-Forwarded-Proto https;
    }
}

几个易错点:ssl_certificate 必须指向 fullchain(站点证书 + 中间证书),而不是单独的 cert.pem;ssl_trusted_certificate 才用 chain.pem,二者不能混用。ssl_prefer_server_ciphers 在启用 TLS 1.3 后建议设为 off,让客户端选择更优套件。

改完先做语法检查再平滑重载,切勿直接 restart 造成连接中断:

nginx -t && nginx -s reload

若前面有 CDN 或负载均衡,还需在其控制台同步上传证书,并确认回源协议为 HTTPS,否则会出现「边缘 HTTPS、回源 HTTP」的伪加密链路,安全扫描会直接判定不合规。

Apache、Tomcat、IIS 配置要点与格式转换

Apache 的关键是区分 CertFile 与 ChainFile。Apache 2.4.8 之后可以把 fullchain.pem 直接给 SSLCertificateFile,SSLCertificateChainFile 已废弃:

<VirtualHost *:443>
    ServerName example.com
    SSLEngine on
    SSLCertificateFile      /etc/httpd/ssl/fullchain.pem
    SSLCertificateKeyFile   /etc/httpd/ssl/example.com.key
    SSLProtocol             all -SSLv3 -TLSv1 -TLSv1.1
    SSLCipherSuite          HIGH:!aNULL:!MD5:!3DES
    Header always set Strict-Transport-Security "max-age=31536000"
</VirtualHost>

Tomcat 只认 JKS/PKCS12,必须先转换,不能直接填 pem:

openssl pkcs12 -export -in fullchain.pem -inkey example.com.key 
  -out example.p12 -name tomcat -passout pass:changeit
keytool -importkeystore -srckeystore example.p12 -srcstoretype PKCS12 
  -destkeystore example.jks -deststoretype JKS -deststorepass changeit

然后修改 server.xml 的 Connector:

<Connector port="8443" protocol="org.apache.coyote.http11.Http11NioProtocol"
           SSLEnabled="true" scheme="https" secure="true">
    <SSLHostConfig protocols="TLSv1.2,TLSv1.3">
        <Certificate certificateKeystoreFile="/opt/tomcat/conf/example.jks"
                     certificateKeystorePassword="changeit" type="RSA" />
    </SSLHostConfig>
</Connector>

IIS 使用 .pfx,导入时绑定必须勾选「需要服务器名称指示(SNI)」:

Import-PfxCertificate -FilePath C:sslexample.pfx 
  -CertStoreLocation Cert:LocalMachineMy 
  -Password (ConvertTo-SecureString -String "pwd" -AsPlainText -Force)
netsh http show sslcert

三者的共同坑:Apache 的 ServerName、Tomcat 的 defaultSSLHostConfigName、IIS 的绑定主机名必须与证书 SAN 一致,否则即使证书正确也会命中默认站点。

宝塔面板与 acme.sh 自动化续期

宝塔面板路径最省事:网站 → 设置 → SSL → Let’s Encrypt → 文件验证,签发成功后证书落在 /www/server/panel/vhost/cert/example.com/ 下的 fullchain.pem 与 privkey.pem。续期任务在「计划任务」里以 Shell 脚本形式存在,默认每天检查一次。

但面板续期失败率不低,常见原因是 80 端口被占、CDN 回源拦截了 /.well-known/acme-challenge/ 路径,或站点伪静态规则把验证请求 rewrite 到首页。排查方法:

curl -I http://example.com/.well-known/acme-challenge/test
ss -lntp | grep :80

命令行环境推荐 acme.sh,支持 DNS API 验证,彻底绕开 80 端口问题:

curl https://get.acme.sh | sh -s email=admin@example.com
~/.acme.sh/acme.sh --issue -d example.com -d www.example.com 
  --webroot /www/wwwroot/example.com
~/.acme.sh/acme.sh --install-cert -d example.com 
  --key-file       /etc/nginx/ssl/example.com.key 
  --fullchain-file /etc/nginx/ssl/fullchain.pem 
  --reloadcmd      "nginx -s reload"

acme.sh 安装时会写入 crontab(0 0 * * *),并在证书剩余 60 天时自动续期——Let’s Encrypt 有效期只有 90 天,这个提前量是刻意留出的容错窗口。务必用 --install-cert 而非手工 cp,否则续期后 Web 服务读到的仍是旧文件。验证定时任务是否生效:

crontab -l | grep acme
~/.acme.sh/acme.sh --list

五种部署环境配置对比表

下表汇总五类环境的差异,可作为选型与迁移时的对照清单:

部署环境 证书文件要求 关键配置项 是否需格式转换 重载命令
NGINX fullchain.pem + .key ssl_certificate / ssl_certificate_key / ssl_protocols 否 nginx -t && nginx -s reload
Apache fullchain.pem + .key SSLCertificateFile / SSLCertificateKeyFile 否(2.4.8+) apachectl configtest && apachectl graceful
Tomcat JKS 或 PKCS12 Connector / SSLHostConfig / Certificate 是,需 openssl + keytool systemctl restart tomcat
IIS PFX(含私钥) 站点绑定 + SNI 勾选 是,需打包 PFX iisreset /noforce
宝塔面板 fullchain.pem + privkey.pem 面板 SSL 页面 + 计划任务续签 否 面板内自动重载

从表里能看出两个规律:一是只有 Tomcat 与 IIS 需要二进制容器格式,转换过程最容易出错(别名 alias、密码、链证书顺序);二是只有 NGINX 与 Apache 支持真正意义上的平滑重载,Tomcat 与 IIS 重启会造成秒级中断,生产环境应放在低峰期执行,并配合前置负载均衡摘流。

另外,宝塔面板虽然「一键」,但它本质是 NGINX/Apache 的封装,出问题时仍要回到 /www/server/panel/vhost/nginx/example.com.conf 查看最终生成的配置,不要只在图形界面里打转。

常见报错与排查命令(附真实错误信息)

下面这些报错在工单里出现频率最高,按错误信息可以直接定位:

  • nginx: [emerg] SSL_CTX_use_PrivateKey_file() failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch):私钥与证书不配对,用前面的 modulus md5 命令重新核对。
  • curl: (60) SSL certificate problem: unable to get local issuer certificate:缺中间证书,把 chain.pem 内容拼到 cert.pem 之后生成 fullchain。
  • 浏览器 NET::ERR_CERT_COMMON_NAME_INVALID:SAN 中不包含当前访问域名,检查是否漏了 www 或子域。
  • 浏览器 SSL_ERROR_NO_CYPHER_OVERLAP:协议或套件不匹配,通常是客户端只支持 TLS 1.2 而服务端仅开 1.3,或反之。
  • AH01909: RSA certificate configured for example.com does NOT include an ID which matches the server name:Apache 的 ServerName 与证书域名不一致,或 SNI 未生效。
  • Tomcat java.io.IOException: Keystore was tampered with, or password was incorrect:JKS 密码错误,注意 keytool 与 Connector 中的密码必须完全一致。
  • IIS 443 端口被占用:netstat -ano | findstr :443 找到 PID 后核对是否为 Skype、SQL Server Reporting Services 等抢端口程序。

一条命令快速拿到关键信息:

curl -Iv https://example.com 2>&1 | grep -E "subject:|issuer:|expire|SSL connection"

若服务端正常而部分客户端异常,多半是证书链或协议问题;若所有客户端都异常,先查 443 端口监听与防火墙:ss -lntp | grep 443、firewall-cmd --list-ports。云服务器还需检查安全组是否放行 443。

上线前验证清单与到期监控

配置完成后不要只看浏览器地址栏的小锁,按下面清单逐项验证:

# 1. 协议支持情况(1.2 与 1.3 都应成功,1.0/1.1 应失败)
openssl s_client -connect example.com:443 -servername example.com -tls1_2 </dev/null
openssl s_client -connect example.com:443 -servername example.com -tls1_3 </dev/null

# 2. 证书链完整性
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null | grep -c "BEGIN CERTIFICATE"

# 3. 到期时间
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null | openssl x509 -noout -enddate

# 4. HSTS 是否下发
curl -sI https://example.com | grep -i strict-transport-security

第 2 步输出应为 2 或 3;第 4 步若为空,说明 HSTS 头没生效,检查 add_header 是否被 location 块覆盖。此外必须人工检查页面「混合内容」:在浏览器控制台过滤 Mixed Content,把残留的 http:// 图片、JS、CSS 全部改为相对协议或 https,否则小锁旁边仍会出现警告。

到期监控建议用脚本加告警,不要依赖记忆:

#!/bin/bash
end=$(echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null 
      | openssl x509 -noout -enddate | cut -d= -f2)
days=$(( ( $(date -d "$end" +%s) - $(date +%s) ) / 86400 ))
[ $days -lt 30 ] && echo "证书剩余 $days 天" | mail -s "SSL 到期告警" admin@example.com

最后用 SSL Labs 或 MySSL 做一次外部评分,目标 A 级以上;评分偏低通常是协议版本、套件强度或缺少 HSTS 导致,按报告逐条修正即可。

常见问题

SSL 证书最长有效期是多少?

公共 CA 签发的 TLS 服务器证书有效期上限为 398 天(自 2020 年 9 月 1 日起由 Apple 与 Chrome 强制),超过 398 天的证书在主流浏览器中会被判定为不合规。Let’s Encrypt 等免费 CA 固定签发 90 天,因此必须配置自动化续期,建议在剩余 30 天(免费证书 30–60 天)时完成续签。

一张证书能绑定几个域名?通配符能覆盖多级子域吗?

通过 SAN 字段,一张证书可以绑定多个域名,主流 CA 支持 1–100 个不等,具体看套餐。通配符证书 *.example.com 只覆盖一级子域(如 a.example.com),不覆盖 a.b.example.com,也不包含裸域 example.com,需要把裸域单独加入 SAN。

HTTPS 能正常打开,但页面样式错乱、图片不显示怎么办?

这是典型的混合内容(Mixed Content)问题:页面通过 HTTPS 加载,但内部引用了 http:// 的资源,浏览器会拦截或降级处理。打开开发者工具 Console 过滤 Mixed Content,把所有静态资源地址改成 https:// 或 // 开头,同时检查后端代码中硬编码的 http 链接和 CDN 回源协议。

私钥泄露了该怎么处理?

立即在 CA 控制台吊销该证书(触发 CRL/OCSP 更新),然后重新生成一对新密钥并签发新证书替换,不要复用旧私钥。同时排查泄露路径,确认私钥文件权限为 600、未被提交到 Git 仓库、未被 Web 目录直接暴露。吊销后到替换完成之间存在空窗期,可先用 HSTS + 快速替换压缩风险窗口。

宝塔面板自动续签失败,如何排查?

按三步查:一是 curl -I http://example.com/.well-known/acme-challenge/test 是否返回 404 或 301,若被伪静态规则拦截需在站点配置中放行该路径;二是 ss -lntp | grep :80 确认 80 端口未被其他程序占用;三是检查 CDN 是否开启,CDN 会拦截验证请求,此时改用 DNS 验证方式或临时切回直连。也可直接查看面板的续签日志定位具体错误码。

免费证书和付费证书的差别在哪里?

技术上加密强度一致,差别在验证等级与服务:免费证书(如 Let’s Encrypt)为 DV,只验证域名控制权,有效期 90 天,无赔付;付费 OV/EV 证书需验证企业主体,有效期最长 398 天,附带更高保额与人工技术支持。面向公众的内容站、API 用 DV 完全够用;涉及支付、金融、政企合规场景再考虑 OV/EV。

内容审核

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