跳到主要内容
证书选购指南

SSL 证书安装部署全攻略:Nginx、Apache、IIS、Tomcat、宝塔与 CDN 实操对比

各服务器环境 SSL 证书安装教程汇总(Nginx / Apache / IIS / Tomcat / 宝塔 / CDN) — 各服务器环境 SSL 证书安装教程汇总(Nginx / Apache / IIS / Tomcat / 宝塔 / CDN)

一、证书签好了却装不上:三类根因

证书签发只完成了信任链的一半,另一半在服务端。线上 80% 的“证书装了但不生效”可以归到三类根因,先定位再动手,比盲目重装快得多。

根因一:格式错配。CA 交付的通常是 PEM(cert.pem + chain.pem + priv.key),但 IIS 只认 PFX(PKCS#12),Tomcat 8.5 以下只认 JKS。把 PEM 直接丢给 IIS,导入向导会提示“指定的文件不是有效的证书文件”;把 PFX 配给 Nginx,nginx -t 会直接报 PEM_read_bio_X509_AUX() failed。

根因二:证书链不完整。只部署了叶子证书,漏掉中间证书(Intermediate CA)。桌面 Chrome 有时会通过 AIA 扩展自动补链,所以“我这儿有小锁”,但 Android 旧版本、Java 客户端、curl、微信内置浏览器会直接报 unable to get local issuer certificate。这是最隐蔽、也最容易被漏测的一类。

根因三:跳转与回源冲突。典型链路是“用户 → HTTPS CDN → HTTP 回源 → 源站强制 301 到 HTTPS → 又回到 CDN”,浏览器最终抛 ERR_TOO_MANY_REDIRECTS。CDN 场景必须同时配置边缘证书和回源协议两层,只配边缘证书一定会踩坑。

还有一个时效性前提必须纠正:公开信任的 TLS 证书最长有效期已缩短到 398 天(CA/B Forum 基线要求,2020 年 9 月起生效,不再有 2 年期选项),Let’s Encrypt 免费证书是 90 天。行业已确定继续缩短路线(200 天 → 100 天 → 最终 47 天),这意味着手工续期迟早出事故,部署时就要把自动续期和到期监控一起做掉。

二、部署前准备:文件核对与格式转换命令

先别急着改配置,用三条命令把文件核对干净,能省掉后面一半的排错时间。

# 1. 看证书主体、SAN、有效期(确认域名在 SAN 里,CN 字段已不被现代浏览器采信)
openssl x509 -in cert.pem -noout -subject -issuer -dates -ext subjectAltName

# 2. 校验证书与私钥是否配对:两条命令输出的 MD5 必须完全一致
openssl x509 -in cert.pem -noout -pubkey | openssl md5
openssl pkey -in priv.key -pubout | openssl md5

# 3. 拼接 fullchain:叶子证书在前,中间证书在后,顺序反了会握手失败
cat cert.pem chain.pem > fullchain.pem

# 4. 本地校验链是否完整(返回 OK 才算通过)
openssl verify -CAfile chain.pem cert.pem

格式转换是跨平台部署的必备动作,四组命令覆盖绝大多数场景:

# PEM → PFX(IIS、Tomcat 8.5+ 用),-certfile 一定要带中间证书
openssl pkcs12 -export -out server.pfx -inkey priv.key -in cert.pem 
  -certfile chain.pem -passout pass:ChangeMe123

# PFX → PEM(从 Windows 导出后回到 Linux 用)
openssl pkcs12 -in server.pfx -nodes -out all.pem -passin pass:ChangeMe123

# PFX → JKS(Tomcat 8.5 以下)
keytool -importkeystore -srckeystore server.pfx -srcstoretype PKCS12 
  -srcstorepass ChangeMe123 -destkeystore tomcat.jks -deststoretype JKS 
  -deststorepass ChangeMe123 -destkeypass ChangeMe123

# 查看 PFX 里到底装了什么(排查“别名不是私钥条目”必备)
openssl pkcs12 -in server.pfx -info -nokeys -passin pass:ChangeMe123

文件权限同样属于部署的一部分:私钥必须 chmod 600、属主为 root 或服务运行用户,否则 Nginx 报 SSL_CTX_use_PrivateKey_file() failed,而错误信息里往往只写权限拒绝,不写具体路径,很容易误判为路径写错。

三、Nginx:fullchain + key,改完先 -t 再 reload

Nginx 用 PEM 格式的 fullchain 和独立私钥,两个文件都要写绝对路径。下面是一份可直接落地的 server 段(TLS 1.2/1.3、OCSP Stapling、HSTS 全配齐):

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/priv.key;
    ssl_trusted_certificate /etc/nginx/ssl/chain.pem;       # OCSP Stapling 校验用

    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;
    resolver 223.5.5.5 1.1.1.1 valid=300s;
    resolver_timeout 5s;

    add_header Strict-Transport-Security "max-age=31536000" always;
}
server {
    listen 80;
    server_name example.com www.example.com;
    return 301 https://$host$request_uri;
}

三个易错点:ssl_certificate 必须指向 fullchain,指向单张叶子证书会导致移动端握手失败;ssl_stapling 必须配合 ssl_trusted_certificate 和可用 resolver,否则 Stapling 静默失效;HSTS 的 max-age 首次上线建议先给 300 秒试跑,确认全站 HTTPS 无混合内容后再拉到一年。

生效流程固定三步:nginx -t 语法通过 → nginx -s reload 热加载(不断连接)→ 用 openssl s_client 复验。切记不要用 restart,生产环境 reload 即可完成证书切换。

四、Apache:mod_ssl,2.4.8+ 不必再配 ChainFile

Apache 依赖 mod_ssl。CentOS/RHEL 装 yum install mod_ssl,Debian/Ubuntu 用 a2enmod ssl。关键差异在版本:Apache 2.4.8 及以上可以把中间证书直接拼进 SSLCertificateFile,不再需要 SSLCertificateChainFile(该指令在 2.4.8 起已废弃);低于 2.4.8 才必须单独指定链文件。

<VirtualHost *:443>
    ServerName example.com
    SSLEngine on
    SSLCertificateFile      /etc/httpd/ssl/fullchain.pem
    SSLCertificateKeyFile   /etc/httpd/ssl/priv.key
    # Apache < 2.4.8 才需要下面这行
    # SSLCertificateChainFile /etc/httpd/ssl/chain.pem

    SSLProtocol -all +TLSv1.2 +TLSv1.3
    SSLCipherSuite ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384
    SSLHonorCipherOrder off
    Header always set Strict-Transport-Security "max-age=31536000"

    DocumentRoot /var/www/html
    <Directory /var/www/html>
        Require all granted
    </Directory>
</VirtualHost>

验证与生效:apachectl configtest(或 httpd -t)返回 Syntax OK 后执行 systemctl reload httpd(Debian 系为 apache2)。若出现 AH00526: Syntax error on line XX: SSLCertificateFile: file does not exist or is empty,九成是 SELinux 上下文问题,用 restorecon -Rv /etc/httpd/ssl 修复,而不是去改权限 777。

另一个高频坑:同一台机器上多个 VirtualHost 共用一个 IP 时,必须全部启用 SNI(Apache 2.2.12+ 默认开启),否则第一个加载的证书会被所有站点复用,第二个域名必然报域名不匹配。

五、IIS 与 Tomcat:容器格式 + SNI 是关键

IIS 走 PFX。流程:certlm.msc → 个人 → 所有任务 → 导入 → 选择 server.pfx → 输入导出密码 → 勾选“标记此密钥可导出”(便于后续迁移)→ 证书落到“个人”存储;中间证书需单独导入到“中间证书颁发机构”存储。随后 IIS 管理器 → 站点 → 绑定 → 添加 → 类型 https → 选择证书 → 多站点共用 443 时必须勾选“需要服务器名称指示”(SNI)。命令行核对:netsh http show sslcert 可以看到每个 IP:端口绑定的证书哈希。HTTP 跳转需要安装 URL Rewrite 模块,web.config 写法如下:

<system.webServer>
  <rewrite>
    <rules>
      <rule name="ForceHTTPS" stopProcessing="true">
        <match url="(.*)" />
        <conditions>
          <add input="{HTTPS}" pattern="off" ignoreCase="true" />
        </conditions>
        <action type="Redirect" url="https://{HTTP_HOST}/{R:1}" redirectType="Permanent" />
      </rule>
    </rules>
  </rewrite>
</system.webServer>

Tomcat 8.5+ 直接用 PKCS12,不必再折腾 JKS,改 conf/server.xml:

<Connector port="8443" protocol="org.apache.coyote.http11.Http11NioProtocol"
           maxThreads="150" SSLEnabled="true" scheme="https" secure="true">
  <SSLHostConfig>
    <Certificate certificateKeystoreFile="conf/server.pfx"
                 certificateKeystoreType="PKCS12"
                 certificateKeystorePassword="ChangeMe123" />
  </SSLHostConfig>
</Connector>

Tomcat 8.0 及以下仍是老写法:keystoreFile="conf/tomcat.jks" keystoreType="JKS" keystorePass="ChangeMe123"。改完必须重启 Tomcat(shutdown.sh + startup.sh),server.xml 不支持热加载。若启动报 java.io.IOException: Alias name tomcat does not identify a key entry,说明 JKS 里存的是只含证书的信任条目,需要用 keytool -importkeystore 重新从 PFX 转换。

六、宝塔面板与 CDN:两层都要配

宝塔面板是最省事的路径,但两个开关容易出事。网站 → 设置 → SSL:可以一键申请 Let’s Encrypt(免费,90 天,自动续签依赖 80/443 可从公网访问),也可以选“其他证书”粘贴 PEM 与私钥。保存后打开“强制 HTTPS”,它实际是往 /www/server/panel/vhost/nginx/example.com.conf 里写一段 301。风险点在于:如果站点前面挂了 CDN 且回源协议是 HTTP,这条 301 会把回源请求重新打到 CDN,形成循环。申请 Let’s Encrypt 失败时常见返回 {"status":false,"msg":"验证失败"},先检查 80 端口是否放行、CDN 是否代理了验证路径。

CDN 必须配两层。第一层是边缘证书:在 CDN 控制台上传 PEM + KEY,或直接使用厂商提供的免费 DV 证书(多为 90 天自动续期)。第二层是回源协议:选 HTTPS、回源端口 443、回源 HOST 与 SNI 和目标站点一致。只配边缘证书、回源仍走 HTTP,而源站又开了强制 HTTPS,浏览器就会抛 ERR_TOO_MANY_REDIRECTS;反过来,回源走 HTTPS 但源站证书是自签或已过期,CDN 会返回 502,此时要么换成受信任证书,要么临时开启“回源证书不受信任时继续”(不推荐长期使用)。

验证时不要只看浏览器,用 curl -I https://example.com 看 CDN 返回头,再直连源站 IP 对比:curl -I --resolve example.com:443:1.2.3.4 https://example.com,两边都返回 200 且证书链完整,才算真正打通。

七、六种环境对比表

环境 证书格式 关键配置位置 生效命令 最常见坑
Nginx fullchain.pem + priv.key /etc/nginx/conf.d/*.conf nginx -t && nginx -s reload 只配叶子证书、私钥权限 644
Apache fullchain.pem + priv.key httpd-ssl.conf / 站点 vhost apachectl configtest && systemctl reload httpd 2.4.8+ 仍配 ChainFile 导致重复链
IIS server.pfx(PKCS#12) certlm.msc + 站点绑定 绑定后即时生效 多站点未勾 SNI、中间证书未导入
Tomcat 8.5+ server.pfx(PKCS#12) conf/server.xml shutdown.sh && startup.sh 沿用 JKS 写法、密码含特殊字符
Tomcat ≤8.0 tomcat.jks conf/server.xml 重启 别名不是私钥条目
宝塔面板 PEM + KEY 粘贴 面板 SSL 页 / vhost 配置 保存即 reload 强制 HTTPS 与 CDN 回源冲突
CDN 边缘 PEM + KEY CDN 控制台证书 + 回源设置 保存后 1-5 分钟下发 只配边缘证书、回源 HOST 不匹配

表格里最值得记的一条:PEM 系(Nginx/Apache/宝塔/CDN)与容器系(IIS/Tomcat)的分界线是“是否需要把证书和私钥打包”。跨环境迁移时,只要按第二节的 openssl pkcs12 双向转换,就不必重新签发。

八、常见错误排查(含真实报错)

1. curl: (60) SSL certificate problem: unable to get local issuer certificate:链不完整。检查 ssl_certificate 是否指向 fullchain,用 openssl s_client -connect example.com:443 -servername example.com -showcerts 数返回的证书张数,正常应为 2 张(叶子 + 中间)。

2. nginx: [emerg] PEM_read_bio_X509_AUX() failed (SSL: error:...):证书文件里混入了私钥或文本说明。用 head -1 fullchain.pem 确认首行是 -----BEGIN CERTIFICATE-----。

3. nginx: [emerg] cannot load certificate key ...:PEM lib (no start line):路径写错或权限不足,ls -l 确认属主与 600 权限。

4. 浏览器 NET::ERR_CERT_COMMON_NAME_INVALID / SSL_ERROR_BAD_CERT_DOMAIN:域名不在 SAN 列表里。CN 字段早已被主流浏览器忽略,必须核对 subjectAltName,泛域名证书 *.example.com 不覆盖 a.b.example.com。

5. ERR_TOO_MANY_REDIRECTS:跳转循环,典型是 CDN 回源 HTTP + 源站强制 HTTPS。用 curl -I -L --max-redirs 3 https://example.com 看 301 指向,再决定是改回源协议还是关掉源站强制跳转。

6. NET::ERR_CERT_DATE_INVALID:证书过期或服务器时间漂移。先 date -u 核对系统时间,再 openssl x509 -in cert.pem -noout -dates 核对有效期。

7. 小锁正常但页面资源加载失败:混合内容(Mixed Content)。F12 控制台会列出被拦截的 http 资源,把图片、JS、接口地址统一改为 https 或协议相对写法。

九、效果验证:三条命令 + 一个评级

无论哪种环境,部署完成后的验证动作是统一的,建议固化成脚本:

# 1. 握手 + 证书链完整性,Verify return code 必须为 0 (ok)
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | grep -E "Verify return code|subject=|issuer="

# 2. 查看实际下发的证书有效期与 SAN
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null | openssl x509 -noout -dates -subject -ext subjectAltName

# 3. 协议与跳转
curl -sI https://example.com | head -5
curl -sI http://example.com | grep -i location

# 4. 到期监控(剩余天数,低于 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 )) 天

最后跑一次 SSL Labs 评级,curl "https://api.ssllabs.com/api/v3/analyze?host=example.com&publish=on" 可拿到 JSON 结果,A/A+ 为达标线。评级掉到 B 通常只有两个原因:仍支持 TLS 1.0/1.1,或者存在 RC4/3DES 弱套件。另外别忘了 CDN 场景要分别验证边缘节点和源站,两者证书可能不是同一张。

把上面的到期监控挂到 cron 或监控系统里,配合 Let’s Encrypt 的自动续期(certbot renew --dry-run 先演练),才能在 398 天与 90 天的有效期规则下长期不出事。

常见问题

pem、crt、cer 本质都是证书,只是编码或扩展名不同;key 是私钥;csr 是申请文件,部署时用不到;pfx/p12 是把证书和私钥打包的容器。Nginx、Apache、宝塔用 pem + key,IIS 和 Tomcat 用 pfx。

公开信任的 TLS 证书最长有效期为 398 天,Let’s Encrypt 免费证书为 90 天,且行业计划继续缩短至 47 天。建议直接启用自动续期,并在到期前 20 天设置告警,不要依赖人工记忆。

不建议。边缘 HTTPS、回源 HTTP 意味着用户到 CDN 加密、CDN 到源站明文,且源站若开启强制 HTTPS 会与回源请求形成 301 循环,报 ERR_TOO_MANY_REDIRECTS。正确做法是边缘证书和回源 HTTPS 两层都配。

多为证书链不完整。桌面浏览器可通过 AIA 自动补拉中间证书,但 Android 旧版本、Java 客户端、curl 不会。用 openssl s_client -showcerts 确认返回两张证书,并把中间证书拼进 fullchain 即可。

不会,前提是启用 SNI。Nginx 按 server_name 匹配,Apache 需各 VirtualHost 独立配置,IIS 绑定时必须勾选“需要服务器名称指示”,Tomcat 用 SSLHostConfig 区分。未开 SNI 时会复用第一张证书,其余域名报域名不匹配。

内容审核

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