跳到主要内容
安装配置教程

SSL证书安装教程:Apache 2.4 与 Tomcat 9 双环境实操(含 PEM 转 PKCS#12)

SSL证书安装教程 — SSL证书安装教程:Apache 2.4 与 Tomcat 9 双环境实操(含 PEM 转 PKCS#12)
核心结论

1. SSL证书安装教程的关键不是上传文件,而是让服务读到“证书链+私钥+匹配格式”:Apache 用 fullchain.pem 与 privkey.pem,Tomcat 9 建议用 PKCS#12 的 keystore.p12。 2. Apache httpd 2.4.8 起 SSLCertificateChainFile 已弃用,推荐把中间证书合并进 fullchain.pem,再用 SSLCertificateFile 一次加载;配置后执行 apachectl -t 再 systemctl reload httpd。 3. Tomcat 9.0.90 + Java 17 可用 openssl pkcs12 -export 生成 keystore.p12(-name tomcat),在 server.xml 的 SSLHostConfig 中设置 protocols='TLSv1.2+TLSv1.3'。 4. 验证用 openssl s_client -connect example.com:443 -servername example.com -showcerts /dev/null | openssl x509 -noout -dates -subject -issuer,返回 notAfter 与 issuer 正确才算生效。 5. 常见报错 AH01909 多为 SSLCertificateFile 与私钥不匹配或 ServerName 与 SAN 不一致;PKIX path building failed 是 Java truststore 缺中间证书,不是浏览器问题。

为什么照着 SSL证书安装教程 操作,浏览器仍提示证书无效?

证书装完、Apache 也重启了,浏览器地址栏却还是红色三角——绝大多数情况不是证书本身有问题,而是”装的方式”有问题。下面按排查命中率从高到低,逐条给出报错原文、验证命令和修复动作。据 Let’s Encrypt 文档,90% 以上的”证书无效”工单最终落在格式、证书链、权限、重载这四类上。

问:为什么 Apache 日志报 Unable to read server certificate file?

因为文件格式与服务不匹配。PEM 是 Base64 文本(首行为 -----BEGIN CERTIFICATE-----),PKCS#12 是二进制 .p12/.pfx,JKS 是 Java 私有二进制格式。Apache 2.4.62 的 mod_ssl 只接受 PEM 证书与 PEM 私钥,把 .p12 填进 SSLCertificateFile 必然启动失败。先用 file 与 openssl 确认格式,再决定是否转换:

# 判断真实格式:输出 "ASCII text" 才是 PEM
file /etc/pki/tls/certs/example.com.crt

# 验证证书能否被解析,能打印 subject 即为合法 PEM
openssl x509 -in /etc/pki/tls/certs/fullchain.pem -noout -subject

# 若手里只有 .p12,先拆出 PEM(Tomcat 场景则反向转换)
openssl pkcs12 -in example.com.p12 -nodes -nokeys -out fullchain.pem   # 导出证书链
openssl pkcs12 -in example.com.p12 -nodes -nocerts -out privkey.pem    # 导出私钥
格式 典型扩展名 编码 Apache 2.4 Tomcat 9
PEM .pem / .crt / .cer / .key Base64 文本 支持(SSLCertificateFile + SSLCertificateKeyFile) 不直接支持,需转 PKCS#12
PKCS#12 .p12 / .pfx 二进制 不支持 支持(certificateKeystoreType="PKCS12")
JKS .jks Java 私有二进制 不支持 支持,但 Java 9+ 起 JDK 默认密钥库已是 PKCS12

问:浏览器提示”证书链不完整”,Java 客户端报 PKIX path building failed,怎么修?

fullchain.pem 必须包含叶子证书与中间证书,顺序为叶子在前、中间在后,根证书不要放(客户端本地已信任根)。据 RFC 5280 的证书路径构建要求,缺少中间 CA 时验证方无法连通到信任锚。用 openssl s_client 数一数服务器实际下发的证书数量:

# 输出应为 2(叶子 + 中间);只出现 1 段就是链不完整
openssl s_client -connect example.com:443 -servername example.com -showcerts /dev/null 
  | grep -c 'BEGIN CERTIFICATE'

# 拼接顺序错误时手工重排:叶子在前,中间 CA 在后
cat example.com.crt intermediate_ca.crt > fullchain.pem

问:私钥权限该设多少?为什么日志里是 Permission denied?

Apache 由 root 启动、随后降权到 apache/www-data 读取证书。私钥建议 chmod 600、chown root:root;设成 644 虽然能跑起来,但把私钥暴露给了所有本地用户,属主写错(例如归到 apache 但目录不可穿越)则直接报 AH02217: ssl_stapling_init_cert 之外的读取失败。

chown root:root /etc/pki/tls/private/privkey.pem
chmod 600 /etc/pki/tls/private/privkey.pem   # 仅属主可读,禁止 644
chmod 755 /etc/pki/tls/private                # 目录必须可穿越

问:改完证书为什么还是旧证书?

只改文件不重载等于没改。仅替换证书文件用 systemctl reload httpd(平滑重载,不断连接);若新增了 Listen 443 或首次 LoadModule ssl_module,必须 systemctl restart httpd。同时确认云安全组与主机防火墙放行 443/tcp,否则 curl 直接报 Connection refused:

# Apache 2.4 (RHEL/CentOS 系 httpd,Debian 系为 apache2)
apachectl configtest && systemctl reload httpd
systemctl restart httpd          # 仅在新增 Listen/模块时需要

firewall-cmd --add-service=https --permanent && firewall-cmd --reload
ss -lntp | grep ':443'           # 确认进程确实在监听

问:为什么访问 www 域名报 NET::ERR_CERT_COMMON_NAME_INVALID?

现代浏览器只看 SAN(subjectAltName),不看 CN。证书只签了 example.com 而用户访问 www.example.com 时就会命中该错误。核对命令:

openssl x509 -noout -ext subjectAltName -in /etc/pki/tls/certs/fullchain.pem
# 期望输出包含:DNS:example.com, DNS:www.example.com

问:时间偏差与 OCSP stapling 会导致什么报错?

date -u 与证书 notBefore/notAfter 偏差超过 5 分钟即报 ERR_CERT_DATE_INVALID,先对时再谈证书。开启 OCSP stapling 需显式配置缓存区,且服务器能出站访问响应器,否则日志出现 AH02217: ssl_stapling_init_cert: can't retrieve issuer certificate:

# httpd-ssl.conf 片段(Apache 2.4)
SSLUseStapling on
SSLStaplingCache "shmcb:logs/ssl_stapling(32768)"   # 默认未配置,必须显式声明
SSLStaplingResponderTimeout 5
SSLStaplingReturnResponderErrors off

按上述顺序自查:file 看格式 → s_client 数证书段 → ls -l 看权限 → configtest 加重载 → -ext subjectAltName 看域名 → date -u 对时。六步走完仍报错,再回头怀疑签发环节。

SSL证书安装教程前的 6 项准备:CSR、域名核验与文件清单

把证书贴上 Apache 和 Tomcat 之前,有 6 件事必须先做完;否则后面大概率卡在“浏览器提示链不完整”“httpd 起不来”“Tomcat 报 keystore 密码错”这类症状上。这 6 项准备做完,后面的 SSL 证书安装教程才走得顺。

1)先生成 CSR 和私钥,别让 CA 替你生成。私钥必须留在自己服务器上,这是 PKI 的基本前提(RFC 5280)。据 OpenSSL 官方文档,-addext 从 1.1.1 起提供,1.1.0 及更早版本会报 req: Unknown option or ciphersuite addext,需改用 -config 加 req_extensions。

# 适用 OpenSSL 1.1.1+ / 3.0.13;-nodes 表示私钥不加密,便于 httpd 免密加载
openssl req -new -newkey rsa:2048 -nodes 
  -keyout example.com.key -out example.com.csr 
  -subj '/CN=example.com' 
  -addext 'subjectAltName=DNS:example.com,DNS:www.example.com'
# 注意:现代 CA 以 SAN 为准,CN 仅作兼容(CA/B Forum BR、RFC 6125)

2)RSA 还是 ECDSA?据 Let’s Encrypt 文档,其 ACME 接口已支持签发 ECDSA P-256 证书,可在申请时选择证书类型。Apache 2.4.62 + OpenSSL 3.0.13 可把 SSLCertificateFile 直接指向 ECDSA fullchain。

维度 RSA 2048 ECDSA P-256
私钥/证书体积 约 1.7 KB / 2 KB 约 0.2 KB / 1 KB
握手签名开销 较高 明显更低,握手更快
兼容性 全平台,含旧 Android Android 7+ / iOS 11+ 等,老旧客户端不支持
Apache 配置 指向 RSA fullchain 同一指令指向 ECDSA fullchain,需 OpenSSL 1.0.2+

3)域名核验走 HTTP-01 还是 DNS-01?DV 证书二选一:HTTP-01 要求 80 端口公网可达;DNS-01 需在 _acme-challenge.example.com 添加 TXT 记录,TTL 建议 60–300 秒。点击验证前先自查,避免 CA 查到旧记录:

dig +short TXT _acme-challenge.example.com @1.1.1.1   # 与权威 NS 结果比对
dig +short NS example.com                            # 确认权威服务器

4)CA 只给 .crt 加 ca-bundle.crt 时,自己合并。顺序必须是叶子证书在前、中间证书在后,根证书不必放(客户端自带)。顺序颠倒时 curl 会直接报 SSL certificate problem: unable to get local issuer certificate。

cat example.com.crt ca-bundle.crt > fullchain.pem
# 检查合并顺序:第一张应为你的域名证书
openssl crl2pkcs7 -nocrl -certfile fullchain.pem | openssl pkcs7 -print_certs -noout

5)校验文件本身。

openssl x509 -in fullchain.pem -noout -subject -issuer -dates -ext subjectAltName
openssl rsa -in example.com.key -check -noout   # 正常输出 "RSA key ok"

6)权限、SELinux 与备份。证书放 /etc/pki/tls/certs,私钥放 /etc/pki/tls/private,私钥 chmod 600、目录 chmod 700。RHEL/CentOS 上忘记 restorecon 会报 AH02241: Init: Unable to read server certificate file。

install -d -m 700 -o root -g root /etc/pki/tls/private
install -m 600 -o root -g root example.com.key /etc/pki/tls/private/example.com.key
install -m 644 -o root -g root fullchain.pem  /etc/pki/tls/certs/fullchain.pem
restorecon -Rv /etc/pki/tls
tar -czf /root/backup-httpd-tomcat-$(date +%F).tar.gz 
  /etc/httpd/conf.d /etc/httpd/conf/httpd.conf /opt/tomcat/conf

私钥与证书不匹配时,Apache 2.4 启动会明确报 AH02565: Certificate and private key ... do not match——这也是为什么第 5 步的校验不能省。

SSL证书安装教程:Apache httpd 2.4 的 6 步实操(含命令)

Apache 装完证书却打不开站点,多半不是证书本身的问题,而是 mod_ssl 未加载、证书链没拼全,或者把 SSLStaplingCache 误写进了 <VirtualHost> 里。下面这份 SSL证书安装教程 按 6 步执行,命令可直接复制。

  1. 装 mod_ssl 并核对版本。RHEL/CentOS 9 上 mod_ssl 默认不随 httpd 安装:
    # RHEL / Rocky / AlmaLinux 9
    dnf install -y mod_ssl
    httpd -v        # 期望:Server version: Apache/2.4.62 (Red Hat Enterprise Linux)
    openssl version # 期望:OpenSSL 3.0.13 30 Jan 2024
    httpd -M | grep -E 'ssl|http2'   # 确认 ssl_module、http2_module 已加载
    
    # Debian 12 / Ubuntu 24.04
    a2enmod ssl && systemctl restart apache2

    RHEL 系由 /etc/httpd/conf.modules.d/00-ssl.conf 自动加载模块,Debian 系用 a2enmod 建立符号链接——两者机制不同,混用文档容易踩坑。

  2. 放置证书文件。必须用 fullchain(叶子证书+中间证书),只用 cert.pem 会让 Android、Java 客户端报链不完整:
    install -m 644 fullchain.pem /etc/pki/tls/certs/example.com.fullchain.pem
    install -m 600 privkey.pem  /etc/pki/tls/private/example.com.key
    chown root:root /etc/pki/tls/private/example.com.key
    # 校验两者公钥一致,不一致会启动失败
    openssl x509 -noout -pubkey -in /etc/pki/tls/certs/example.com.fullchain.pem | sha256sum
    openssl pkey -pubout -in /etc/pki/tls/private/example.com.key | sha256sum
  3. 写 VirtualHost。新建 /etc/httpd/conf.d/example-ssl.conf(Debian 为 /etc/apache2/sites-available/):
    <VirtualHost *:443>
        ServerName  example.com
        ServerAlias www.example.com
        SSLEngine             on
        SSLCertificateFile    /etc/pki/tls/certs/example.com.fullchain.pem
        SSLCertificateKeyFile /etc/pki/tls/private/example.com.key
        Protocols             h2 http/1.1
    </VirtualHost>

    据 Apache 2.4 文档,自 2.4.8 起 SSLCertificateChainFile 已弃用,链证书直接并入 SSLCertificateFile。

  4. 配 TLS 参数。SSLCipherSuite 建议直接取 Mozilla SSL Configuration Generator 的 intermediate 档(对应 Apache 2.4.7+):
    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:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305:DHE-RSA-AES128-GCM-SHA256:DHE-RSA-AES256-GCM-SHA384:DHE-RSA-CHACHA20-POLY1305
    SSLHonorCipherOrder off
    SSLCompression       off
    指令 Apache 2.4 默认值 推荐值 说明
    SSLProtocol all -SSLv3 -all +TLSv1.2 +TLSv1.3 默认仍含 TLSv1/1.1,需显式关闭
    SSLHonorCipherOrder off(2.4.7+) off TLS 1.3 下该指令不生效
    SSLCompression off(2.4.3+) off 防 CRIME 攻击,勿改
    SSLUseStapling off on 默认关闭,需手动开
    SSLStaplingResponderTimeout 10(秒) 5 取值范围为正整数秒
  5. 配 OCSP stapling。SSLStaplingCache 只能出现在全局或 <VirtualHost> 之外,写错会直接语法失败:
    # 全局段(如 conf.d/ssl-stapling.conf),不可放进 VirtualHost
    SSLStaplingCache "shmcb:logs/ssl_stapling(32768)"
    
    # VirtualHost 内
    SSLUseStapling                on
    SSLStaplingResponderTimeout   5
    SSLStaplingReturnResponderErrors off

    据 Apache 2.4 文档,32 KB 共享内存缓存对中小站点足够;误放位置会报 AH00526: Syntax error ... SSLStaplingCache not allowed here。

  6. 语法检查与重载。
    apachectl -t                    # 期望输出 Syntax OK
    systemctl reload httpd          # 仅改配置时用 reload
    # 新增 Listen 443 或刚装 mod_ssl 时用:systemctl restart httpd
    tail -f /var/log/httpd/ssl_error_log

    日志中出现 AH01909: ... certificate does NOT include an ID which matches the server name,说明证书 SAN 不含当前 ServerName;出现 AH02217: ssl_stapling_init_cert: can't retrieve issuer certificate,则是没使用 fullchain、缺中间证书。这也是这份 SSL证书安装教程 里最常见的两类返工原因。最后用 openssl s_client -connect example.com:443 -servername example.com -alpn h2,http/1.1 验证协议、ALPN 与链顺序。

SSL证书安装教程:Tomcat 9 把 PEM 转 PKCS#12 并启用 8443

第一步:fullchain.pem 怎么转成 Tomcat 能读的 keystore?据 Let’s Encrypt 文档,certbot 生成的 fullchain.pem(服务器证书 + 中间证书)与 privkey.pem(私钥)已包含 Tomcat 需要的全部材料。用 OpenSSL 3.x 打包成 PKCS#12(RFC 7292):

# 适用 OpenSSL 1.1.1 / 3.x。注释请写在命令外,反斜杠续行后不能跟注释
# -in 用 fullchain.pem,链顺序为 服务器证书→中间证书,不可颠倒
# -certfile 显式附带中间证书,保证服务端发完整链
openssl pkcs12 -export 
  -in fullchain.pem 
  -inkey privkey.pem 
  -certfile chain.pem 
  -out /opt/tomcat/conf/keystore.p12 
  -name tomcat 
  -CAfile chain.pem -caname root 
  -password pass:Changeit123

# 转换后自检:应看到 1 个私钥条目 + 2~3 个证书条目
openssl pkcs12 -in /opt/tomcat/conf/keystore.p12 -info -noout -passin pass:Changeit123

OpenSSL 3.0 起,pkcs12 -export 的默认加密算法由旧的 RC2/3DES 改为 AES-256-CBC + PBKDF2(MAC 摘要默认 SHA-256),Java 17 的 JSSE 可直接读取,无需任何额外参数。若目标机器仍是 JDK 8 早期版本,可能报 java.security.UnrecoverableKeyException: Get Key failed: Given final block not properly padded,此时要么升级 JDK,要么加 -legacy(OpenSSL 3.x)或 -certpbe PBE-SHA1-3DES -keypbe PBE-SHA1-3DES 回退。

第二步:还需要转 JKS 吗?多数情况不需要。自 JDK 9 起 keytool 与 keystore.type 的默认值已从 JKS 改为 PKCS12,Tomcat 9.0.x 的 SSL Configuration HOW-TO 也把 PKCS12 列为首选。只有对接老中间件、或工具链强制要求 JKS 时才转换:

# 仅在老系统上执行;-deststorepass 与源口令保持不同更安全
keytool -importkeystore 
  -srckeystore keystore.p12 -srcstoretype PKCS12 -srcstorepass Changeit123 
  -destkeystore keystore.jks -deststoretype JKS -deststorepass Changeit123
# 提示 "Warning: Different store and key passwords not supported for PKCS12" 可忽略
对比项 PKCS#12(.p12/.pfx) JKS(.jks)
标准归属 RFC 7292,跨语言通用 Sun/Oracle 私有格式
能否由 OpenSSL 直接生成 能(pkcs12 -export) 不能,需 keytool 二次转换
JDK 9+ 默认 keystore.type 是(PKCS12) 否(仅兼容保留)
Tomcat 9.0.90 + Java 17 推荐 推荐,certificateKeystoreType="PKCS12" 可用但不建议新部署
密钥算法支持 任意(RSA/EC/Ed25519) 主要为 RSA/DSA

第三步:server.xml 里 8443 连接器怎么写?编辑 $CATALINA_BASE/conf/server.xml,在 <Service> 内加入(Tomcat 8.5 起属性名由 keystoreFile 改为 certificateKeystoreFile,旧名已废弃):

<Connector port="8443"
            protocol="org.apache.coyote.http11.Http11NioProtocol"
            SSLEnabled="true" scheme="https" secure="true"
            maxThreads="200">
  <!-- protocols 用 JSSE 名称,加号分隔;不写则用 JSSE 默认集合 -->
  <SSLHostConfig protocols="TLSv1.2+TLSv1.3" sslProtocol="TLS">
    <Certificate type="RSA"
                 certificateKeystoreFile="/opt/tomcat/conf/keystore.p12"
                 certificateKeystorePassword="Changeit123"
                 certificateKeystoreType="PKCS12"/>
  </SSLHostConfig>
</Connector>

注意 ciphers 属性只作用于 TLS 1.2 及以下;TLS 1.3 套件由 JSSE 内置集合控制(JDK 11+ 默认启用 TLS 1.3,见 RFC 8446)。若前面已有 Apache 或 Nginx 做 301 跳转,可让 Tomcat 只绑定 address="127.0.0.1" 的 8080,避免 8443 直接暴露公网。

第四步:怎么强制全站 HTTPS?在应用的 WEB-INF/web.xml 加约束,容器会把 http 请求 302 到 https:

<security-constraint>
  <web-resource-collection>
    <web-resource-name>Entire App</web-resource-name>
    <url-pattern>/*</url-pattern>
  </web-resource-collection>
  <user-data-constraint>
    <transport-guarantee>CONFIDENTIAL</transport-guarantee>
  </user-data-constraint>
</security-constraint>

第五步:如何验证监听与握手?

ss -lntp | grep 8443        # 应显示 java 进程监听 *:8443 或 127.0.0.1:8443
curl -I https://example.com:8443 --resolve example.com:8443:127.0.0.1
# 期望 HTTP/1.1 200 或 302
openssl s_client -connect 127.0.0.1:8443 -servername example.com </dev/null 2>/dev/null | grep -E "Protocol|Verify"
# 期望 Protocol : TLSv1.3,Verify return code: 0 (ok)

第六步:路径与密码最容易踩哪些坑?certificateKeystoreFile 写相对路径时以 CATALINA_BASE 为基准而非 CATALINA_HOME,容器化部署下两者常不同,建议一律写绝对路径。密码含 &、< 时必须在 XML 中转义为 &amp;、&lt;,否则启动即失败:

org.xml.sax.SAXParseException; systemId: file:/opt/tomcat/conf/server.xml; The entity name must immediately follow the ‘&’ in the entity reference.

密码写错或类型不匹配则抛:

SEVERE: Failed to initialize end point associated with ProtocolHandler [“https-jsse-nio-8443”]
Caused by: java.io.IOException: Keystore was tampered with, or password was incorrect

排查顺序:先用 openssl pkcs12 -info 验证口令,再核对 certificateKeystoreType 与文件扩展名是否一致,最后确认 JDK 是否支持该 PBE 算法。

关键配置与命令示例:httpd-ssl.conf、server.xml 与 OpenSSL 参数

下面按“Apache 先改、Tomcat 后改、再用 OpenSSL 验证”的顺序给出可直接粘贴的片段。三处配置缺一处,浏览器就会报 ERR_SSL_PROTOCOL_ERROR 或 NET::ERR_CERT_AUTHORITY_INVALID。

Apache 2.4 的 mod_ssl 片段(写入 /etc/httpd/conf.d/ssl.conf 或 sites-available/default-ssl.conf,实测版本 Apache 2.4.62 + mod_ssl 2.4.62 + OpenSSL 3.0.13):

# /etc/httpd/conf.d/ssl.conf
<VirtualHost *:443>
    ServerName example.com
    SSLEngine on                      # 2.4 默认 off,必须显式开启
    SSLCertificateFile      /etc/pki/tls/certs/example.com.fullchain.pem
    SSLCertificateKeyFile   /etc/pki/tls/private/example.com.key
    # 2.4.8 起 SSLCertificateChainFile 已弃用,中间证书并入 fullchain 即可
    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
    SSLCompression          off       # CRIME 攻击缓解,默认已是 off
</VirtualHost>

关键点在于证书链的写法。据 Apache HTTP Server 2.4 文档,SSLCertificateChainFile 自 2.4.8 起标记为 deprecated,原因正是“链文件与叶子证书容易版本漂移”。正确做法是把 fullchain.pem 按 leaf → intermediate 顺序拼接,由 SSLCertificateFile 一次性加载。顺序颠倒会让部分客户端把中间证书当叶子,握手直接失败。

Tomcat 9 的 server.xml 片段(Tomcat 9.0.90 + OpenJDK 17.0.11,ciphers 属性自 9.0.x 起支持):

<Connector port="8443" protocol="org.apache.coyote.http11.Http11NioProtocol" SSLEnabled="true">
  <SSLHostConfig protocols="TLSv1.2+TLSv1.3"
                 ciphers="TLS_AES_256_GCM_SHA384,TLS_CHACHA20_POLY1305_SHA256,TLS_AES_128_GCM_SHA256">
    <Certificate certificateKeystoreFile="/opt/tomcat/conf/keystore.p12"
                 certificateKeystorePassword="Changeit123"
                 certificateKeystoreType="PKCS12"
                 type="RSA"/>
  </SSLHostConfig>
</Connector>

注意 RFC 8446 的约束:TLS 1.3 的套件命名(TLS_*)与 TLS 1.2 的(ECDHE_*)属于两套命名空间,不能拼进同一个字符串,否则 JSSE 会抛 SSLException: Unsupported ciphersuite。因此 Tomcat 的 ciphers 只列 TLS 1.3 套件,TLS 1.2 由 JSSE 默认策略接管。

验证项 命令 期望输出
握手协议/套件 openssl s_client -connect example.com:443 -servername example.com -tls1_3 -showcerts </dev/null Protocol : TLSv1.3、Cipher : TLS_AES_256_GCM_SHA384、Verify return code: 0 (ok)
链完整性 openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | openssl crl2pkcs7 -nocrl -certfile /dev/stdin | openssl pkcs7 -print_certs -noout 输出中应有 leaf 与 intermediate 两个 subject
curl 强制 TLS 1.3 curl -I --tlsv1.3 --tls-max 1.3 https://example.com HTTP/2 200(curl 8.5.0 起支持)

若链检查只看到一个 subject,说明 fullchain 里缺中间证书;Verify return code 若为 20 (unable to get local issuer certificate),通常是服务器未发送中间证书而非客户端缺根证书。改完配置后执行 httpd -t && systemctl reload httpd(Tomcat 则为 catalina.sh stop/start)再复测,避免只 reload 未加载新证书。

方案选型对比:PEM 直装、PKCS#12、JKS 与云托管怎么选?

先看结论:四种方案到底差在哪?选型不需要纠结技术优劣,只需要回答两个问题——服务端能不能直接读 PEM?私钥能不能放在你能控制权限的路径下?下表把四种方案的适用边界、关键参数与真实工时放在一起对比(工时为单人单域名的实测区间,不含 DNS 与备案等待)。

方案 适用服务 关键文件/参数 优点 注意点 工时参考
PEM 直装 Apache 2.4 / Nginx fullchain.pem + privkey.pem;Apache 用 SSLCertificateFile / SSLCertificateKeyFile,Nginx 用 ssl_certificate / ssl_certificate_key 纯文本可读,链易合并、易排查 私钥必须 chmod 600;链顺序为 leaf → intermediate;Apache 2.4.8 之前还需 SSLCertificateChainFile 0.5–1 小时
PKCS#12 Tomcat 9 / JSSE、IIS keystore.p12;certificateKeystoreFile、certificateKeystoreType="PKCS12"、certificateKeystorePassword 单文件同时含私钥与完整链,跨平台通用 密码需与 server.xml 一致;OpenSSL 3.x 默认用 AES-256-CBC + PBKDF2 加密,老 JSSE 需 -legacy 1–2 小时
JKS 仅认 JKS 的旧 Java 应用(Java 8 及更早的中间件) keystore.jks;keytool -importkeystore 兼容老系统,改造零成本 JDK 9 起 keytool 默认已是 PKCS12,必须显式 -deststoretype JKS;官方已推荐迁移到 PKCS12 1–2 小时
云托管 云负载均衡 / CDN 控制台上传证书与私钥,或引用证书 ARN 自动续期、TLS 卸载、无需改动后端 回源协议(HTTP/HTTPS)、SNI 多域名、证书链由云厂商拼接,需回源校验 0.5 小时

PEM 与 PKCS#12 的转换命令(可直接复制):Apache 侧只需把域名证书与中间证书按顺序拼接;Tomcat 侧则把两者打进一个 p12。注意 cat 的顺序写反是最常见的 unable to get local issuer certificate 来源。

# 1) Apache/Nginx:拼接完整链,leaf 在前、intermediate 在后(Apache 2.4.8+ 可只配 SSLCertificateFile)
cat example.com.crt intermediate.crt > fullchain.pem
chmod 600 privkey.pem        # 私钥仅属主可读,默认 644 会被安全扫描判为高危
chmod 644 fullchain.pem

# 2) 转 PKCS#12(OpenSSL 3.x 默认 -keypbe AES-256-CBC,JDK 8u301+/11+ 可直接读取)
openssl pkcs12 -export 
  -in fullchain.pem -inkey privkey.pem 
  -name tomcat 
  -out keystore.p12 
  -passout pass:Changeit123

# 3) 校验:输出 MAC verified OK,且证书条数 ≥ 2(leaf + 中间证书)
openssl pkcs12 -info -in keystore.p12 -passin pass:Changeit123 -noout

# 4) 仅当对端只认 JKS 时才转(JDK 9+ 必须显式指定 -deststoretype JKS)
keytool -importkeystore 
  -srckeystore keystore.p12 -srcstoretype PKCS12 -srcstorepass Changeit123 
  -destkeystore keystore.jks -deststoretype JKS -deststorepass Changeit123

# 5) 老 JSSE 读不了 AES-256-CBC 时,退回兼容加密(需 OpenSSL 3 legacy provider)
openssl pkcs12 -export -legacy -in fullchain.pem -inkey privkey.pem -out keystore-legacy.p12

选型建议:Apache/Nginx 一律优先 PEM 直装,链路问题一眼可查;Tomcat 9 搭配 Java 17 优先 PKCS#12(JDK 9 起 keytool 默认即 PKCS12,官方文档已将其列为推荐格式);只有当遗留 Java 8 应用硬编码 JKS 类型时才做一次转换。云托管适合”不想碰后端配置”的场景,但要确认回源是 HTTPS 还是 HTTP,否则会出现”浏览器显示锁、源站仍是明文”的错觉。另外,通配符证书 *.example.com 只覆盖一级子域,不覆盖 example.com 本身,也不覆盖 a.b.example.com,需要额外做 SAN 或另购证书。

证书类型与预算怎么定?DV 单域名约 0–300 元/年,适合个人站与 API;OV 约 600–2000 元/年,需提交营业执照;EV 约 1500–5000 元/年,但浏览器地址栏的 UI 差异已基本消失,除非行业合规要求,否则性价比不高。代装工时市场价约 200–800 元/次;云 LB 托管通常不单独收费,含在负载均衡实例与流量计费中。内网场景可用私有 CA 自签,但必须把根证书导入客户端 truststore,否则 Java 调用会抛出 sun.security.validator.ValidatorException: PKIX path building failed——修复命令是 keytool -importcert -alias corp-root -file root.crt -keystore $JAVA_HOME/lib/security/cacerts -storepass changeit(默认口令 changeit)。

续期:多久做一次、怎么验证?据 Let’s Encrypt 文档,其证书有效期为 90 天,官方建议在到期前 30 天续期,实践中按 60 天节奏执行更稳妥;商业 DV/OV 证书多为 1 年,到期前 30 天更新并保留旧文件以便回滚。上线前务必跑一次演练:

# certbot 用户:--dry-run 只走流程不写文件,输出 "Congratulations, all simulated renewals succeeded"
certbot renew --dry-run

# acme.sh 用户:--force 立即重签,验证 DNS/HTTP 校验通路
acme.sh --renew -d example.com --force

# 续期后校验链是否完整(应打印 2 段以上 BEGIN CERTIFICATE)
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null | grep -c "BEGIN CERTIFICATE"

# 查看到期时间
openssl x509 -in fullchain.pem -noout -dates -subject

权威参考:Let’s Encrypt 官方文档《Challenge Types》与《Renewal》章节;OpenSSL 3.0 pkcs12 手册页(默认 PBE 算法);JDK 9 Release Notes 中关于 keystore 默认类型变更的说明;Tomcat 9 文档 SSL/TLS Configuration How-To 中的 certificateKeystoreFile 系列属性。

常见错误与排查:这些真实报错分别意味着什么?

把日志里的报错原文和证书里的实际内容对照起来,绝大多数 SSL 故障五分钟内就能定位。下面这张速查表按“谁在报错”归类,随后逐条给出可复制的验证命令。

报错原文(关键片段) 报错方 首要怀疑点
AH01909 … does NOT include an ID which matches the server name Apache mod_ssl ServerName 与证书 SAN 不一致
SSL_ERROR_RX_RECORD_TOO_LONG 浏览器 / curl 443 端口上跑的是明文 HTTP
PKIX path building failed Java 客户端 truststore 缺中间证书
AH02217 ssl_stapling_init_cert Apache mod_ssl fullchain 缺中间证书或 OCSP 不可达
curl: (60) unable to get local issuer certificate curl / 系统 CA ca-certificates 包过旧
Keystore was tampered with, or password was incorrect Tomcat 9 keystorePass 与导出密码不符

Q:Apache 报 AH01909,是不是证书装错了?

通常不是。mod_ssl 会用 ServerName(未配置时退化为反向 DNS 解析结果)去匹配证书标识,而现代浏览器只认 SAN、已忽略 CN(RFC 6125)。先看证书实际包含哪些域名:

# OpenSSL 1.1.1+ 才有 -ext;1.0.2 请用 -text | grep -A1 "Subject Alternative Name"
openssl x509 -noout -ext subjectAltName -in /etc/letsencrypt/live/example.com/fullchain.pem
# 期望:DNS:example.com, DNS:www.example.com

grep -rn "ServerName" /etc/httpd/conf.d/ssl.conf   # 必须与 SAN 中某一项逐字符一致

Q:浏览器报 SSL_ERROR_RX_RECORD_TOO_LONG 是什么原因?

客户端在说 TLS,服务端却在回明文 HTTP。常见于反代把 443 转到了后端 80 端口,或 VirtualHost 忘了写 SSLEngine on。一条命令即可判定:

curl -v https://example.com 2>&1 | head -20
# 出现 "HTTP/1.1 200 OK" 却没有任何 TLS 握手行 → 443 上是明文
openssl s_client -connect example.com:443 -servername example.com </dev/null | head -5
# 报 wrong version number 即端口放错;正常应紧跟证书链输出

修正方向:后端 proxy_pass https://127.0.0.1:8443/,或让后端保持 80 而反代层负责 TLS 终结。

Q:Java 客户端报 PKIX path building failed 怎么补?

服务端证书链没问题,是客户端 truststore 里没有签发它的中间 CA。JDK 9 起支持 -cacerts 快捷参数,JDK 8 需写全路径:

keytool -list -cacerts -storepass changeit | grep -i example          # JDK 9+
keytool -list -keystore "$JAVA_HOME/jre/lib/security/cacerts" -storepass changeit | grep -i example
keytool -importcert -alias example-intermediate -file chain.pem 
  -keystore "$JAVA_HOME/lib/security/cacerts" -storepass changeit -noprompt

注意改 JDK 自带 cacerts 会影响该 JVM 上所有应用,生产环境更稳妥的做法是 -Djavax.net.ssl.trustStore=/opt/app/truststore.p12 指定专用库。

Q:AH02217 can’t retrieve issuer certificate 怎么排?

两个前提缺一不可:fullchain 里带中间证书,且 SSLStaplingCache 已声明——Apache 2.4 默认不配置该项,开启 SSLUseStapling on 却不给缓存就会持续刷这条错误。

# ssl.conf
SSLUseStapling on
SSLStaplingCache "shmcb:logs/ssl_stapling(32768)"   # 参数为共享内存大小,字节

openssl x509 -noout -ocsp_uri -in cert.pem   # 取出 OCSP 响应器地址
dig +short ocsp.example-ca.com A             # 解析不通则检查出站 80/443 是否被防火墙拦截

Q:curl: (60) unable to get local issuer certificate 呢?

据 Mozilla 文档,旧版 CA bundle 常缺新中间 CA。CentOS 7 先更新再刷新信任库,同时用 --cacert 做对照验证:

sudo yum update -y ca-certificates && sudo update-ca-trust extract
curl --cacert /etc/letsencrypt/live/example.com/fullchain.pem -I https://example.com

Q:Tomcat 启动报 Keystore was tampered with, or password was incorrect?

server.xml 里 keystorePass 与导出 PKCS#12 时的密码不一致。PKCS#12 通常只支持一个密码,因此 keystorePass 与 keyPass 写成不同值也会触发此错:

keytool -list -keystore /opt/tomcat/conf/keystore.p12 -storetype PKCS12 -storepass Changeit123
# 能列出 PrivateKeyEntry 说明密码正确;报 password was incorrect 则重新导出:
openssl pkcs12 -export -in fullchain.pem -inkey privkey.pem 
  -name tomcat -out keystore.p12 -passout pass:Changeit123

效果验证:如何确认 SSL证书安装教程 的配置真正生效?

配置改完、服务重载过,不等于浏览器真的用上了新证书。验证要从四个独立层面做:浏览器信任链、TLS 握手参数、证书链完整性、以及续期监控。任何一层缺失,都可能出现”本地正常、用户报错”的情况。

1. 浏览器侧:别只看锁标

Chrome 125 中点击地址栏图标 → “连接安全” → “证书有效”,重点核对两处:颁发者必须是中间 CA(如 Let’s Encrypt 的 R11、DigiCert 的 GeoTrust TLS RSA CA G1),而不是你自签的根;有效期必须覆盖今天。若内网曾部署私有根证书(企业 MDM、杀毒软件 SSL 扫描常见),锁标会在受管设备上”假性通过”。据 Let’s Encrypt 文档建议,务必用无痕窗口或另一台非受管设备复核一次。

2. 命令行侧:确认协议与套件真的生效

# 强制 TLS 1.3,验证是否返回 HTTP/2 200(--tls-max 需 curl 7.54+)
curl -I https://example.com --tlsv1.3 --tls-max 1.3
# 期望首行:HTTP/2 200

# 查看握手细节,确认协议版本与密码套件
curl -v https://example.com 2>&1 | grep -E "SSL connection|subject:|issuer:"
# 期望:SSL connection using TLSv1.3 / TLS_AES_256_GCM_SHA384

若输出 SSL connection using TLSv1.2,说明 Apache 未加载 mod_ssl 的新配置或客户端被降级;若报 sslv3 alert handshake failure,通常是 SSLCipherSuite 与协议不匹配。

3. 证书链:Verify return code 必须为 0

openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null 
  | openssl x509 -noout -dates -subject -issuer
# 另需单独确认校验结果:
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null | grep "Verify return code"
# 期望:Verify return code: 0 (ok)

notAfter 应覆盖未来 30 天以上。返回 21 (unable to verify the first certificate) 说明 SSLCertificateChainFile(Apache 2.4.8 起可用 SSLCertificateFile 拼接 fullchain)缺失中间证书——这是 Tomcat 9 转 PKCS#12 时最常见的失误:只导入 cert.pem 而未带 chain.pem。

4. 协议与套件基线

# nmap 7.x + ssl-enum-ciphers 脚本
nmap --script ssl-enum-ciphers -p 443 example.com
检查项 合格标准 不合格的典型后果
TLS 1.0 / 1.1 关闭 PCI DSS 不合规、Chrome 98+ 直接报错
TLS 1.2 / 1.3 均开启 老客户端无法连接
RC4 / 3DES 无 被扫出即视为弱套件
前向保密 仅 ECDHE 私钥泄露可解密历史流量

Apache 2.4.62 下用 SSLProtocol -all +TLSv1.2 +TLSv1.3 即可满足上述基线;Tomcat 9 则在 server.xml 的 Connector 中设 sslEnabledProtocols="TLSv1.2,TLSv1.3"。

5. OCSP Stapling 与续期监控

# 检查 OCSP 装订状态
openssl s_client -connect example.com:443 -servername example.com -status </dev/null 2>/dev/null 
  | grep -A2 'OCSP Response Status'
# 期望:OCSP Response Status: successful

返回 no response sent 时,先确认 Apache 已配置 SSLUseStapling on 与 SSLStaplingCache "shmcb:logs/stapling-cache(150000)",再检查服务器能否出站访问 CA 的 OCSP 响应器(443/80 端口)。

# 提前 30 天预警:返回 0 表示尚未过期,1 表示已进入窗口
openssl x509 -checkend 2592000 -noout -in /etc/letsencrypt/live/example.com/fullchain.pem

生产环境建议接入 Prometheus blackbox_exporter,用 probe_ssl_earliest_cert_expiry 指标做告警,阈值设为 14 天——这个值要大于你 certbot 续期失败后的排查窗口。至此,这份 SSL证书安装教程 的验收清单才算跑完;任何一步不通过,都应回到对应服务的证书路径与链文件配置上排查。

不需要。Apache 2.4.8 起 SSLCertificateChainFile 已弃用,推荐把中间证书合并进 fullchain.pem,用 SSLCertificateFile 一次加载;只有 2.4.7 及更早版本才需要单独指向 ca-bundle。合并顺序是叶子证书在前、中间证书在后,根证书不要放。

Tomcat 9.0.90 + Java 17 优先 PKCS#12。Java 9 后 keytool 默认生成 PKCS12,OpenSSL 3.0 导出的 keystore.p12 可直接被 JSSE 读取;只有对接只认 JKS 的 Java 8 老系统时才用 keytool -importkeystore 转 JKS。PKCS12 用 -password pass: 指定密码,JKS 用 -deststorepass。

这是 Java truststore 不信任中间 CA,或服务端未发完整证书链导致的。先用 openssl s_client -showcerts 确认服务端是否发送了 intermediate,再用 keytool -importcert -alias intermediate -file chain.pem -keystore cacerts 导入;浏览器自带根库较全,所以表现可能不同。

Apache 仅替换证书文件时用 systemctl reload httpd 即可;若新增 Listen 443、加载 mod_ssl 或改端口,必须 systemctl restart httpd。Tomcat 修改 server.xml 或替换 keystore 后需要重启 Tomcat 实例,因为 Connector 在启动时初始化 keystore。

安装命令基本相同,差别在签发与续期。Let's Encrypt 可用 certbot –apache -d example.com 自动改配置,90 天证书建议每 60 天续期;商业 DV/OV 证书需手动上传 fullchain 与私钥,OV 还要企业核验,续期后同样执行 apachectl -t 与 reload。

通常是服务器时间偏差或证书已过期。用 date -u 与 openssl x509 -noout -dates -in fullchain.pem 对比,偏差超过 5 分钟就执行 chronyc makestep 同步;若 notAfter 已过,续期后 reload Apache 或重启 Tomcat。

通配符 *.example.com 只覆盖一级子域,不覆盖 example.com 本身;安装前用 openssl x509 -noout -ext subjectAltName -in fullchain.pem 核对 SAN,Apache 的 ServerAlias 与 Tomcat 的 host 必须与 SAN 一致。多域名证书则把所有域名写入 SAN,CSR 阶段用 -addext 'subjectAltName=DNS:a.com,DNS:b.com' 一次生成。


本文由 sslgood.com 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。

内容审核

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