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

SSL 证书部署实操全指南:Nginx / Apache / IIS / Tomcat / 宝塔 / CDN 六大环境配置、对比与排错

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

问题背景与根因:证书“装上了”,为什么浏览器还报警

绝大多数“SSL 安装失败”都不是证书本身有问题,而是三类根因:文件格式错配、证书链不完整、协议层配置缺失。

  • 格式错配:Nginx / Apache 只认 PEM 文本格式(以 -----BEGIN CERTIFICATE----- 开头),IIS / Tomcat 走 PKCS#12 容器(.pfx / .p12)。把二进制 DER 格式的 .cer 直接丢给 Nginx,加载时会直接报 PEM 解析失败。
  • 链不完整:只部署了叶子证书,没带中间证书。桌面 Chrome 有 AIA 自动补链能力,看起来“正常”,但 Android、微信内置浏览器、Java 客户端、老版本 curl 会直接报 unable to get local issuer certificate。Nginx 的 ssl_certificate 必须指向“叶子 + 中间”的 fullchain,且不要包含根证书。
  • 协议与端口层:写了 listen 443 ssl 却没配 ssl_certificate;安全组或防火墙没放行 443;CDN 只配了边缘证书没配回源协议。

几个必须掌握的时效事实:自 2020-09-01 起,CA/B 论坛规定公开信任的 TLS 服务器证书最长有效期 398 天;Let’s Encrypt 免费证书固定 90 天,必须做自动续期。TLS 1.0 / TLS 1.1 已被 RFC 8996 正式废弃,主流浏览器与 CDN 全部停止支持,配置中只应保留 TLS 1.2 与 TLS 1.3。SHA-1 签名证书已被全线拒绝,现在必须是 SHA-256。

还有一个高频坑是 SNI:一个 IP 挂多个站点时,客户端必须携带 SNI 扩展才能拿到正确证书。不支持 SNI 的老客户端(Android 4.x、Windows XP 上的 IE、部分 Java 6/7 客户端)会拿到默认站点的证书,报 hostname mismatch。这类问题只能靠升级客户端或给老客户端单独分配 IP 解决。

第一步:整理证书文件并完成格式转换

商业 CA 下发的压缩包通常包含四个文件:example.com.crt(叶子证书)、ca_bundle.crt 或 chain.crt(中间证书)、example.com.key(私钥)、example.com.pfx(已打包的 PKCS#12)。部署前先做三件事。

1. 合并 fullchain 并确认链结构

cat example.com.crt ca_bundle.crt > fullchain.pem
# 第一段必须是叶子证书,后面才是中间证书
grep -c "BEGIN CERTIFICATE" fullchain.pem   # 正常为 2,若为 1 说明缺中间证书

2. 校验私钥与证书是否匹配

# RSA 证书
openssl x509 -noout -modulus -in fullchain.pem | openssl md5
openssl rsa  -noout -modulus -in example.com.key | openssl md5
# ECDSA 证书用公钥比对
openssl x509 -in fullchain.pem -noout -pubkey | openssl md5
openssl pkey -in example.com.key -pubout | openssl md5

两条命令输出的 MD5 必须完全一致,否则就是“证书与私钥不匹配”,Nginx 会报 key values mismatch,IIS 导入时会提示密码错误。

3. 生成各环境需要的格式

# PEM 转 PFX(给 IIS / Tomcat 用),-certfile 用于补入中间证书
openssl pkcs12 -export -out server.pfx -inkey example.com.key -in fullchain.pem -certfile ca_bundle.crt -name "example.com" -passout pass:YourStrongPass
# PFX 反解成 PEM
openssl pkcs12 -in server.pfx -nodes -passin pass:YourStrongPass -out all.pem
# PKCS12 转 JKS(仅 Tomcat 7 及更老版本需要)
keytool -importkeystore -srckeystore server.pfx -srcstoretype PKCS12 -srcstorepass YourStrongPass -destkeystore tomcat.jks -deststoretype JKS -deststorepass YourStrongPass

另外两个细节:私钥权限必须收紧到 chmod 600,属主为 root 或 Web 服务用户;Windows 上生成的证书文件常带 CRLF 换行,拷到 Linux 后用 file example.com.key 检查,若显示 CRLF 就执行 sed -i 's/r$//' example.com.key fullchain.pem,否则 Nginx 可能报 bad base64 decode。

第二步:Nginx 与 Apache 的完整实操步骤

Nginx

  1. 确认编译了 SSL 模块:nginx -V 2>&1 | grep -o with-http_ssl_module,无输出说明需要重装或加载模块。
  2. 放置文件:mkdir -p /etc/nginx/ssl && cp fullchain.pem example.com.key /etc/nginx/ssl/ && chmod 600 /etc/nginx/ssl/example.com.key。
  3. 写入 server 块(模板见下一节)。
  4. 语法检查:nginx -t,必须看到 syntax is ok 与 test is successful。
  5. 平滑重载:systemctl reload nginx,不要用 restart,否则会断开现有连接。

版本差异要注意:Nginx 1.25.1 之前 HTTP/2 写在 listen 行上 listen 443 ssl http2;,1.25.1 起改为独立的 http2 on; 指令,混用会告警。开启 OCSP Stapling 时 ssl_trusted_certificate 需要指向包含中间证书的链文件,并配置 resolver,否则 stapling 状态会一直是 “not enabled”。

Apache

  1. 启用模块:Debian/Ubuntu 执行 a2enmod ssl headers rewrite;RHEL/CentOS 确认 /etc/httpd/conf.modules.d/00-ssl.conf 中已加载 mod_ssl.so。
  2. Apache 2.4.8 及以上只需两个指令:SSLCertificateFile 指向“叶子 + 中间”合并后的文件,SSLCertificateKeyFile 指向私钥;SSLCertificateChainFile 从 2.4.8 起已废弃,不需要再配。低于 2.4.8 的老版本才需要单独指定 ChainFile。
  3. 检查配置:apachectl configtest 或 httpd -t,输出 Syntax OK 才能继续。
  4. 重载:systemctl reload apache2,RHEL 系为 systemctl reload httpd。

Apache 还有一个坑:全局 SSLProtocol 与 SSLSessionTickets 默认写在 /etc/apache2/mods-available/ssl.conf 里,改虚拟主机前先确认全局配置没有把 TLS 1.2 关掉。想拿 SSL Labs A+,还需要在虚拟主机里加 HSTS 头与 SSLHonorCipherOrder off(交由客户端选套件更利于 TLS 1.3)。

第三步:IIS、Tomcat、宝塔面板与 CDN 的实操步骤

IIS(Windows Server)

  1. Win + R 输入 certlm.msc 打开“本地计算机证书”管理控制台。
  2. 右键“个人 → 所有任务 → 导入”,选择 server.pfx,输入导出密码,证书存储保持“个人”。
  3. 关键一步:把中间证书单独导入到“中间证书颁发机构 → 证书”存储,否则部分客户端会报链不完整(Windows 虽能通过 AIA 自动下载,但内网或离线环境会失败)。
  4. IIS 管理器 → 站点 → 绑定 → 添加 → 类型 https → 端口 443 → 选择证书 → 勾选“需要服务器名称指示(SNI)”,同一 IP 多站点必须勾。
  5. HTTP 跳转 HTTPS 需安装 URL Rewrite 模块,再在站点根目录 web.config 写 301 规则。

Tomcat

Tomcat 8.5 及以上直接在 conf/server.xml 的 Connector 中配置 PKCS#12,无需先用 keytool 转 JKS;Tomcat 9/10 的默认 keystore 类型已是 PKCS12。只有 Tomcat 7 及更老版本才需要 JKS 加 keystoreFile / keystorePass。改完必须重启,reload 不生效。若前面有 Nginx 反向代理,Connector 里要加 proxyPort="443",否则应用生成的绝对链接会退化成 http。

宝塔面板

路径:网站 → 设置 → SSL。Let’s Encrypt 走 HTTP-01 验证,需要 80 端口可直接访问;如果域名已接入 CDN 且开启了代理,验证会失败,此时应先暂停 CDN 代理或改用 DNS-01 验证。粘贴付费证书时,PEM 框要填“叶子 + 中间”两段,KEY 框填私钥,顺序颠倒会直接报错。签发成功后务必打开“强制 HTTPS”。面板自身的证书在“面板设置 → SSL”里单独配置,与站点证书互不影响。

CDN

CDN 是两层证书:边缘证书(用户 ↔ CDN 节点)和回源协议(CDN ↔ 源站)。只配边缘证书、回源仍走 HTTP(Flexible 模式),而源站又强制 301 到 HTTPS,就会形成 ERR_TOO_MANY_REDIRECTS 死循环。正确做法是回源协议选 HTTPS,并保证源站证书有效未过期(Let’s Encrypt 证书同样可用);若用 Full (Strict) 模式,源站证书必须由公共 CA 签发且链完整。同时要把 CDN 回源 IP 段加入源站白名单,否则回源 443 会被防火墙拦掉。

配置示例:四套可直接复制的模板

Nginx(TLS 1.2/1.3 + HSTS + OCSP Stapling)

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-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;
    resolver 223.5.5.5 119.29.29.29 valid=300s;

    add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
    add_header X-Content-Type-Options nosniff always;

    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_set_header X-Forwarded-Proto https;
    }
}
server {
    listen 80;
    server_name example.com www.example.com;
    return 301 https://$host$request_uri;
}

Apache(2.4.8+)

<VirtualHost *:443>
    ServerName example.com
    SSLEngine on
    SSLCertificateFile    /etc/ssl/example.com/fullchain.pem
    SSLCertificateKeyFile /etc/ssl/example.com/example.com.key
    SSLProtocol           -all +TLSv1.2 +TLSv1.3
    Header always set Strict-Transport-Security "max-age=31536000"
    <Directory "/var/www/html">
        Require all granted
    </Directory>
</VirtualHost>

Tomcat 9(conf/server.xml)

<Connector port="443" protocol="org.apache.coyote.http11.Http11NioProtocol"
           SSLEnabled="true" scheme="https" secure="true" proxyPort="443">
  <SSLHostConfig>
    <Certificate certificateKeystoreFile="conf/server.pfx"
                 certificateKeystoreType="PKCS12"
                 certificateKeystorePassword="YourStrongPass"
                 type="RSA" />
  </SSLHostConfig>
</Connector>

IIS web.config(HTTP 跳转 HTTPS)

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

四套模板的共同点是:都只启用 TLS 1.2 / 1.3、都做了 HTTP 到 HTTPS 的 301、都不包含根证书。复制后只需要替换域名、路径和密码三项即可上线。

六大环境对比表格:文件格式、关键指令与生效方式

环境 证书文件格式 关键配置项 生效命令 最常见坑
Nginx fullchain.pem + .key ssl_certificate / ssl_certificate_key nginx -t && systemctl reload nginx 只配叶子证书导致链不全
Apache 2.4.8+ fullchain.pem + .key SSLCertificateFile(含中间)/ SSLCertificateKeyFile apachectl configtest && systemctl reload apache2 多配了已废弃的 SSLCertificateChainFile
IIS 10 .pfx(PKCS#12) 站点绑定 + SNI + 中间证书存储 绑定保存即生效,无需重载 中间证书没进“中间证书颁发机构”
Tomcat 8.5+ .pfx(PKCS12) certificateKeystoreFile / Password 重启 Tomcat 密码不一致报 Cannot recover key
宝塔面板 PEM 文本粘贴 SSL 页 + 强制 HTTPS 面板自动 reload CDN 代理下 HTTP-01 验证失败
CDN 边缘证书 + 回源证书 回源协议 HTTPS / Full (Strict) 控制台保存即生效 Flexible 模式导致循环重定向

表格里的“生效命令”是最容易出错的一环:Nginx 与 Apache 用 reload 即可,Tomcat 必须 restart,IIS 绑定保存后立即生效,但更换证书后需要在绑定里重新选择一次,否则仍在使用旧证书。文件格式上,只有 IIS 和 Tomcat 需要 .pfx,其余环境一律用 PEM 文本;如果 CA 只给了 pfx,用第一步的 openssl pkcs12 -in ... -nodes 反解出证书和私钥即可。

选择 CDN 回源模式时按安全等级排序:Full (Strict) > Full > Flexible。Flexible 意味着 CDN 到源站是明文 HTTP,既不安全又极易引发重定向循环,除非源站完全无法安装证书,否则不建议使用。

常见错误排查:真实报错与对应解法

以下报错均来自真实环境,按报错原文检索即可定位。

  1. nginx: [emerg] cannot load certificate "/etc/nginx/ssl/fullchain.pem": BIO_new_file() failed (SSL: error:80000002:system library::No such file or directory) —— 路径写错,或 SELinux 拦截。RHEL/CentOS 执行 restorecon -Rv /etc/nginx/ssl,或 chcon -t httpd_sys_content_t /etc/nginx/ssl/*.pem。
  2. nginx: [emerg] PEM_read_bio_X509_AUX() failed (SSL: error:04800064:PEM routines::bad base64 decode) —— 文件是 DER 二进制,或混入了多余文本、CRLF 换行。用 openssl x509 -in fullchain.pem -text -noout 验证,转换:openssl x509 -in cert.cer -inform DER -out cert.pem -outform PEM。
  3. SSL_CTX_use_PrivateKey() failed (SSL: error:0A080006:SSL routines::EVP_PKEY_CTX_set0_rsa_oaep_label:key values mismatch) —— 证书与私钥不配对,回到第一步用 modulus 或 pubkey 比对。
  4. Chrome 报 ERR_CERT_AUTHORITY_INVALID —— 缺中间证书,grep -c "BEGIN CERTIFICATE" fullchain.pem 的结果必须大于等于 2。
  5. Chrome 报 ERR_SSL_PROTOCOL_ERROR —— 443 端口上跑的不是 TLS 服务,或反向代理把 https 请求转发到了 http 端口。
  6. Apache AH02572: Failed to configure at least one certificate and key for example.com:443 —— 证书路径、权限或格式有问题,先 ls -l 确认运行用户可读。
  7. Apache AH02032: Hostname example.com provided via SNI and hostname provided via HTTP have no compatible SSL setup —— 同 IP 多虚拟主机的 SNI 配置冲突,检查每个 443 虚拟主机是否都写了 SSLEngine on 与正确的证书。
  8. Tomcat java.security.UnrecoverableKeyException: Cannot recover key —— PKCS12 容器密码与私钥密码不一致,用统一密码重新导出 server.pfx。
  9. 浏览器 ERR_TOO_MANY_REDIRECTS —— CDN 回源协议与源站 301 冲突,把回源改成 HTTPS 并调整源站跳转规则。
  10. 命令行 curl: (60) SSL certificate problem: unable to get local issuer certificate —— 服务端未下发中间证书,属于服务端问题,不是客户端 CA 库过期。

效果验证:三条命令加一个评级

无论哪种环境,部署完成后都跑同一套验证。

# 1. 看证书链是否完整下发(s: 主题,i: 颁发者,应能看到叶子 + 中间两级)
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | grep -E "^ [0-9] s:|^   i:"

# 2. 校验结果必须是 0 (ok),非 0 说明链有问题
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null | grep "Verify return code"

# 3. 查看实际生效的颁发者与到期时间
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null | openssl x509 -noout -dates -issuer

# 4. 证明 TLS 1.1 已关闭(应返回协议错误)
openssl s_client -connect example.com:443 -servername example.com -tls1_1 </dev/null 2>&1 | grep -i "protocol version"

# 5. 检查 HSTS 头与 301 跳转
curl -sI https://example.com | grep -i strict-transport-security
curl -sI http://example.com | head -1

浏览器侧:地址栏点开小锁 → “连接是安全的” → 证书有效;F12 控制台里不应出现 Mixed Content 警告,否则说明页面里仍有 http 资源。

最后跑一次 SSL Labs:https://www.ssllabs.com/ssltest/analyze.html?d=example.com,目标是 A 或 A+。A+ 的硬性条件是启用 HSTS(max-age 不低于 15552000)且支持 TLS 1.3;如果只拿到 B,通常是仍在支持 TLS 1.0/1.1 或使用了 3DES 等弱套件。需要接入监控时可用 API:curl "https://api.ssllabs.com/api/v3/analyze?host=example.com&all=done&maxAge=24"。

到期监控:openssl x509 -checkend 2592000 -noout -in fullchain.pem,返回 0 表示 30 天内不会过期,返回 1 就该续期了。Let’s Encrypt 的 90 天有效期务必配置 certbot 自动续期并加 --deploy-hook "systemctl reload nginx",否则新证书下载了也不会被加载。

常见问题

pem 与 crt/cer 都是证书本体,区别只在编码,pem 是 Base64 文本;key 是私钥;csr 是申请文件,部署时用不到;pfx/p12 是证书加私钥的打包容器。Nginx、Apache 用 pem + key,IIS、Tomcat 用 pfx。


不需要。用 certbot 安装后系统会写入 systemd timer 或 cron,每天检查两次,剩余 30 天内自动续期。关键是加 –deploy-hook “systemctl reload nginx” 让新证书生效,并先用 certbot renew –dry-run 演练一次。手动下载的证书则必须自己续。


典型缺中间证书。桌面 Chrome 会通过证书里的 AIA 地址自动补链,微信内置浏览器和老 Android 不会。用 openssl s_client -showcerts 看是否只下发了一张证书,把 ca_bundle 合并进 fullchain 后重载即可。


用 SNI。Nginx 为每个域名写独立 server 块并各自配置 ssl_certificate;Apache 每个 VirtualHost *:443 单独配证书;IIS 绑定时勾选“需要服务器名称指示”。只要客户端支持 SNI 就能正确分流。


自 2020-09-01 起,公开信任的 TLS 服务器证书最长 398 天,CA 可签发更短。Let’s Encrypt 免费证书固定 90 天,这是其策略而非限制。到期必须换新证书,不能把同一张证书的有效期续长。


说明回源协议是 HTTP(Flexible),而源站又强制 301 到 HTTPS。把 CDN 回源协议改成 HTTPS,并确保源站证书有效、链完整;Full (Strict) 模式还要求源站证书由公共 CA 签发。改完清一次 CDN 缓存再测。

内容审核

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