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

SSL 证书安装教程对比:Nginx、Apache、宝塔面板与云平台一键部署实测(SSL Certificate Installation Comparison)

ssl证书 安装教程 comparison — SSL 证书安装教程对比:Nginx、Apache、宝塔面板与云平台一键部署实测(SSL Certificate Installation Comparison)
核心结论

SSL 证书安装的本质只有三件事:证书链完整、私钥与证书匹配、443 端口可达;Nginx 用 ssl_certificate 指向 fullchain.pem,Apache 2.4.8 之后用 SSLCertificateFile 指向含链文件即可,两者都不必再单独指定中间证书。 证书链顺序错了会让 Java 8 与 Android 7 以下客户端报 PKIX path building failed,正确合并命令是 cat example.com.crt intermediate.crt > fullchain.pem,可用 openssl crl2pkcs7 -nocrl -certfile fullchain.pem | openssl pkcs7 -print_certs -noout 校验顺序。 Nginx 改完先跑 nginx -t,再 systemctl reload nginx;Apache 跑 apachectl configtest 后 systemctl reload httpd。reload 不断开现有连接,restart 会,生产环境别用 restart。 配置是否生效只看一条:openssl s_client -connect example.com:443 -servername example.com </dev/null 输出 Verify return code: 0 (ok)。 curl 报 (28) Operation timed out 基本与证书无关,是安全组或防火墙没放行 443,或者 AAAA 记录指向了未监听 IPv6 的服务器。

为什么同一张 SSL 证书,在 Nginx、Apache、宝塔和云平台上装法完全不同?

先问一个最常见的问题:同一张证书,为什么 Nginx 教程里只有两行配置,Apache 教程却要填三个文件路径?

因为证书本身是死的,读取方式是活的。一份签发完成的证书,落地到你手里的其实就是两个文件:

  • 公钥证书:X.509 结构,PEM 编码(Base64 文本),以 -----BEGIN CERTIFICATE----- 开头,扩展名 .pem / .crt / .cer 只是习惯差异。
  • 私钥:RSA 2048 位或 ECDSA P-256,以 -----BEGIN PRIVATE KEY-----(PKCS#8)或 -----BEGIN RSA PRIVATE KEY-----(PKCS#1)开头,权限必须是 600。

所有”装法不同”的分歧,都发生在中间证书(Intermediate CA)往哪儿放这件事上——这是 Nginx 与 Apache 教程对不上的首要原因。

Nginx 的答案:一个文件全包。从 1.18 起(实际早于此,但 1.18 是主流发行版默认版本),ssl_certificate 支持并推荐一次性指定”叶子证书 + 中间证书”,Nginx 会按文件内顺序把整条链下发给客户端:

# /etc/nginx/conf.d/example.conf  适用 Nginx 1.18+
server {
    listen 443 ssl;
    http2 on;                                  # 1.25.1+ 写法;旧版用 listen 443 ssl http2;
    server_name example.com;

    ssl_certificate     /etc/nginx/ssl/fullchain.pem;  # 叶子证书在前,中间证书在后
    ssl_certificate_key /etc/nginx/ssl/privkey.pem;    # 权限 600,属主 root
    ssl_protocols       TLSv1.2 TLSv1.3;               # 默认值随版本变化,建议显式声明
    ssl_session_cache   shared:SSL:10m;                # 默认 none,开启后可显著降低握手开销
}
# 改完必须 nginx -t 校验,再 nginx -s reload;直接 reload 失败会静默沿用旧配置

Apache 的答案:分版本。2.4.8 之前,中间证书只能用 SSLCertificateChainFile 单独指定;2.4.8 之后该指令被标记为 deprecated,允许把链直接拼进 SSLCertificateFile。这就解释了为什么 2015 年前后的老教程至今仍在流传三行写法:

# Apache 2.4.8+ 推荐写法(httpd-ssl.conf 或站点 vhost 内)
SSLEngine on
SSLCertificateFile      /etc/httpd/ssl/fullchain.pem   # 叶子+中间证书拼接在同一文件
SSLCertificateKeyFile   /etc/httpd/ssl/privkey.pem
# SSLCertificateChainFile 在 2.4.8+ 已不必要;若仍配置,链会被重复下发

# 老版本(< 2.4.8)才需要:
# SSLCertificateFile    /etc/httpd/ssl/cert.pem
# SSLCertificateChainFile /etc/httpd/ssl/chain.pem

只部署 cert.pem 会怎样?据 Let’s Encrypt 官方文档,certbot 产出的 fullchain.pem 必须同时包含叶子证书与中间证书;只挂 cert.pem 时,桌面 Chrome 常因本地缓存或 AIA 抓取而”看起来正常”,但 Android 7 以下与 Java 8 客户端会直接抛出:

javax.net.ssl.SSLHandshakeException: sun.security.validator.ValidatorException:
PKIX path building failed: unable to find valid certification path to requested target

所以只用浏览器验证是这篇 SSL 证书安装教程 comparison 里最容易踩的坑,务必用 openssl s_client -connect example.com:443 -servername example.com -showcerts 确认返回了 2 张以上证书。

云平台”一键部署”改的是哪儿?它通过 API 把证书写进负载均衡(SLB/CLB)或 CDN 节点,完全不碰你 ECS 上的 nginx.conf。如果你又在服务器上手工配了一份,就会出现两个生效点、两份证书,排障时 DNS 指向谁、请求落在哪一层,必须先厘清。宝塔面板则相反:证书内容存在 /www/server/panel/vhost/cert/域名/,由模板渲染出 nginx.conf——手工改完配置再在面板点一次「保存」,改动即被覆盖,这是面板环境最典型的配置回滚。

环境 证书落地位置 链的配置方式 典型失效点
Nginx 1.18+ 自选目录,如 /etc/nginx/ssl/ fullchain 合并进 ssl_certificate 忘记 nginx -t,reload 失败仍跑旧配置
Apache 2.4.8+ /etc/httpd/ssl/ 链拼进 SSLCertificateFile 沿用老教程多配 ChainFile,链重复
Apache < 2.4.8 同上 SSLCertificateChainFile 独立文件 漏配该指令 → 中间证书缺失
宝塔面板 /www/server/panel/vhost/cert/域名/ 面板渲染模板 手改 nginx.conf 后被面板覆盖
云 SLB / CDN 云侧证书管理服务 控制台粘贴或 API 上传 与源站手工配置并存,双生效点

443 不通,先别怀疑证书。用 curl 区分两类现象:安全组/防火墙未放行时是 curl: (28) Connection timed out after 20001 milliseconds;服务根本没监听时是 curl: (7) Failed to connect to example.com port 443: Connection refused。只有 TCP 通了、TLS 握手阶段才报错(如 sslv3 alert handshake failure、certificate has expired),才是证书问题。这一判断顺序,在任何一种部署方式下都通用。

SSL 证书安装的完整实操步骤(以 Nginx 为主线,标注 Apache 与面板差异)

这一节用一台 CentOS 7(OpenSSL 1.1.1)和一台 Ubuntu 24.04(OpenSSL 3.0.13)、Nginx 1.26 做主线,把 6 步走完;Apache、宝塔、阿里云 SLB 只标注“哪一步不一样”。据 Let’s Encrypt 官方文档,证书文件的私钥权限与证书链顺序是自动化签发后最高频的两个故障点,所以下面每一步都带校验动作。

  1. 生成私钥与 CSR。CN 已不参与现代浏览器的主机名校验,必须带 SAN:
# 适用 OpenSSL 1.1.1 / 3.0.x;3.0.x 默认摘要已是 SHA-256,
# 显式写 -sha256 是为了兼容 CentOS 7 上仍为 1.1.1 的环境
openssl req -new -newkey rsa:2048 -sha256 -nodes 
  -keyout example.com.key -out example.com.csr 
  -subj "/C=CN/ST=Zhejiang/L=Hangzhou/O=Example/CN=example.com" 
  -addext "subjectAltName=DNS:example.com,DNS:www.example.com"
# -nodes(no DES)表示私钥不加口令,否则 Nginx 启动会要求交互输入 passphrase
  1. 拼接证书链。cat example.com.crt intermediate.crt > fullchain.pem,顺序必须是叶子证书在前、中间证书在后;反了会让部分客户端握手直接失败。交叉签名证书不要重复拼接——同一份中间证书出现两次,Android 7 及更早版本可能报 SSL handshake aborted。
  2. 校验私钥与证书是否配对。两条命令输出的 32 位 MD5 必须完全一致:
openssl x509 -noout -modulus -in example.com.crt | openssl md5
openssl rsa  -noout -modulus -in example.com.key | openssl md5
# ECC 证书没有 modulus,改用公钥比对(OpenSSL 1.0.0+ 均支持)
openssl x509 -in example.com.crt -noout -pubkey | openssl md5
openssl pkey -in example.com.key -pubout | openssl md5

不配对时 Nginx 的真实报错:nginx: [emerg] SSL_CTX_use_PrivateKey("/etc/nginx/ssl/example.com.key") failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch)。这条报错 90% 是拿错了环境(测试/生产)的私钥。

  1. 上传并收紧权限。私钥可被其他用户读取会被 SSL Labs 记为配置风险项:
install -d -m 700 /etc/nginx/ssl
chown root:root /etc/nginx/ssl/example.com.key /etc/nginx/ssl/fullchain.pem
chmod 600 /etc/nginx/ssl/example.com.key   # 私钥:仅 root 可读写
chmod 644 /etc/nginx/ssl/fullchain.pem     # 证书链:可公开
  1. 写入 server 块并校验。Nginx 1.26 的 reload 是平滑重载,不中断已有连接:
server {
    listen 443 ssl;
    http2 on;                                   # 1.25.1+ 新写法;1.24 及更早写 listen 443 ssl http2;
    server_name example.com;
    ssl_certificate     /etc/nginx/ssl/fullchain.pem;   # 必须是含中间证书的链文件
    ssl_certificate_key /etc/nginx/ssl/example.com.key;
    ssl_protocols       TLSv1.2 TLSv1.3;        # 默认仅 TLSv1.2/1.3(1.23.4+)
    ssl_session_cache   shared:SSL:10m;         # 默认 none,开启后握手性能提升明显
}
nginx -t            # 期望输出:syntax is ok / test is successful
systemctl reload nginx

Apache 的对应动作是 apachectl configtest 通过后 systemctl reload httpd;注意 Apache 2.4.8 起 SSLCertificateChainFile 已废弃,中间证书直接按顺序追加进 SSLCertificateFile 指向的文件即可。

  1. 面板与云平台路径。宝塔 8.x 在「网站 → 设置 → SSL → 其他证书」,证书栏粘贴 fullchain.pem 全文、私钥栏粘贴 key 全文——只贴叶子证书会导致只下发单张证书,浏览器地址栏虽正常但 SSL Labs 判为 Chain issues: Incomplete。阿里云 SLB 在「证书管理 → 上传服务器证书」同时填公钥与私钥,私钥必须是无口令 PEM,带 passphrase 会直接报证书解析失败。
平台 证书文件形态 校验命令 生效方式
Nginx 1.26 fullchain.pem + key nginx -t systemctl reload nginx
Apache 2.4 证书+中间证书合并进一个文件 apachectl configtest systemctl reload httpd
宝塔 8.x 两个文本框粘贴全文 保存时面板校验 自动 reload
阿里云 SLB 公钥 / 私钥分离上传 上传即解析 控制台配置下发

按上面这套流程走,是几种 ssl证书 安装教程 comparison 里最容易复现的一条;如果你只在面板点“一键部署”,至少要回到第 3 步手工做一次配对校验,否则出问题时分不清是证书链还是私钥的问题。想看证书链是否真的完整,用 openssl s_client -connect example.com:443 -servername example.com -showcerts 看返回的证书张数,与 Mozilla SSL Configuration Generator 给出的推荐配置逐项对齐即可。

配置与命令示例:Nginx 1.26 与 Apache 2.4.57 可直接复制的片段

把证书文件放到服务器上只是第一步,真正决定握手能否成功的是 Web 服务器那几行配置。下面给出可直接复制的片段,并在关键行用注释说明适用版本。

Nginx 1.26 最小可用配置(写入 /etc/nginx/conf.d/example.com.conf):

server {
    listen 443 ssl;                 # 1.25.1+ 不再把 http2 写在 listen 后面
    http2 on;                       # 1.24 及以前必须写成 listen 443 ssl http2;
    server_name example.com;

    ssl_certificate     /etc/nginx/ssl/fullchain.pem;      # 必须含中间证书
    ssl_certificate_key /etc/nginx/ssl/example.com.key;

    ssl_protocols       TLSv1.2 TLSv1.3;                   # 默认值仅 TLSv1.2 TLSv1.3(1.23.4 起)
    ssl_session_cache   shared:SSL:10m;                    # 10m ≈ 4 万个会话
    ssl_session_timeout 1d;
    ssl_session_tickets off;                               # 关闭票据,牺牲部分性能换取前向安全

    # OCSP Stapling:缺 resolver 会静默失败
    ssl_stapling on;
    ssl_stapling_verify on;
    ssl_trusted_certificate /etc/nginx/ssl/fullchain.pem;
    resolver 223.5.5.5 valid=300s;

    add_header Strict-Transport-Security "max-age=300" always;   # 先小步试跑
}

加密套件直接照抄 Mozilla SSL Configuration Generator v5.7 的 Intermediate 档即可:兼容 Firefox 27、Chrome 31、Android 4.4.2 及以上,已禁用 TLS 1.0/1.1。需要提醒的是,该档位里的 ssl_prefer_server_ciphers on 对 TLS 1.3 无效——据 RFC 8446,TLS 1.3 的套件顺序由客户端决定,这行只影响 TLS 1.2 握手。

Apache 2.4.57 片段(/etc/httpd/conf.d/ssl.conf 或 VirtualHost 内):

SSLEngine on
SSLCertificateFile      /etc/httpd/ssl/fullchain.pem   # 2.4.8 起中间证书也放这里
SSLCertificateKeyFile   /etc/httpd/ssl/example.com.key
# SSLCertificateChainFile 已废弃,写了会报 AH02559 警告
SSLProtocol             all -SSLv3 -TLSv1 -TLSv1.1
SSLUseStapling          on
SSLStaplingCache        "shmcb:logs/ssl_stapling(32768)"
Header always set Strict-Transport-Security "max-age=300"

修改后务必 nginx -t && nginx -s reload 或 apachectl configtest && systemctl reload httpd,再用一条命令验证证书链是否完整:

openssl s_client -connect example.com:443 -showcerts -servername example.com 
  </dev/null 2>/dev/null | grep -E "Verify return code|s:"
# 正常输出:Verify return code: 0 (ok),且至少有 2 行 "s:"(叶子证书 + 中间证书)
# 若只有 1 行 s:,说明漏配中间证书,Android 与部分 Java 客户端会直接握手失败

这也是本系列 ssl证书 安装教程 comparison 里最容易被忽略的一步:面板和云平台一键部署会替你拼好链,手工配置则要自己验证。HSTS 尤其要克制——据 RFC 6797,一旦下发 max-age 并被浏览器缓存,回滚只能等缓存自然过期,所以先用 300 秒观察 24 小时、确认无子域 HTTP 依赖后,再改成 max-age=31536000; includeSubDomains。

四条安装路径怎么选?Nginx / Apache / 宝塔 / 云平台一键部署对比表

同样是”装个证书”,有人 2 分钟收工,有人折腾一下午——差别往往不在证书本身,而在你把证书链和重载动作交给了谁。先把四条路径摊开对比:

方案 证书链写法 生效命令 单站点耗时 适合场景
Nginx 1.24+ ssl_certificate 指向 fullchain.pem nginx -t && systemctl reload nginx 5-10 分钟 自建站点、反代、需要精细控制 TLS 参数
Apache 2.4.57 SSLCertificateFile 指向 fullchain.pem(2.4.8+) apachectl configtest && systemctl reload httpd 5-10 分钟 老业务系统、.htaccess 依赖重的站点
宝塔面板 8.x 面板 SSL 页粘贴全文,证书链框不可留空 面板点保存自动 reload 2-3 分钟 单机多站点、不想手写配置的站长
阿里云 SLB / 腾讯云 CLB 证书上传到证书管理,绑定监听器 控制台点确定即生效 1-2 分钟 多台后端、需要卸载 TLS 与统一续期

为什么”证书链写法”这一列最要命?据 Let’s Encrypt 文档,签发目录里的 fullchain.pem = 站点证书 + 中间证书,cert.pem 只有站点证书。只填后者时,桌面 Chrome 常因缓存中间证书而”看起来正常”,但 Java 客户端、旧版 Android 和 curl 会直接报 unable to get local issuer certificate。Nginx 与 Apache 2.4.8+ 都接受把中间证书拼接在同一文件里,这是最省心的做法。

# /etc/nginx/conf.d/example.conf  —— Nginx 1.24+ 实测可用
server {
    listen 443 ssl;
    # 1.25.1 起用 http2 on;  1.24 及以下写 listen 443 ssl http2;
    server_name example.com;

    ssl_certificate     /etc/nginx/ssl/fullchain.pem;  # 必须含中间证书
    ssl_certificate_key /etc/nginx/ssl/privkey.pem;
    ssl_protocols       TLSv1.2 TLSv1.3;   # 1.23.4 起的默认值,旧版默认还含 TLSv1/1.1
    ssl_session_cache   shared:SSL:10m;    # 默认 none,开启后复用握手
}

# 校验语法后热加载,不中断现有连接
nginx -t && systemctl reload nginx
# /etc/httpd/conf.d/ssl.conf  —— Apache 2.4.57
<VirtualHost *:443>
    ServerName example.com
    SSLEngine on
    # 2.4.8+ 支持站点证书与中间证书写在同一文件
    SSLCertificateFile    /etc/httpd/ssl/fullchain.pem
    SSLCertificateKeyFile /etc/httpd/ssl/privkey.pem
    # 2.4.8 之前必须单独指定链文件,否则同样缺中间证书
    # SSLCertificateChainFile /etc/httpd/ssl/chain.pem
</VirtualHost>

apachectl configtest && systemctl reload httpd   # Debian/Ubuntu 服务名为 apache2

路径写错或权限不足时,两个服务的报错长这样,照抄去搜即可定位:

nginx: [emerg] cannot load certificate "/etc/nginx/ssl/fullchain.pem":
BIO_new_file() failed (SSL: error:8000000D:system library::Permission denied)

AH00526: Syntax error on line 5 of /etc/httpd/conf.d/ssl.conf:
SSLCertificateFile: file '/etc/httpd/ssl/fullchain.pem' does not exist or is empty

云平台一键部署的隐藏坑:阿里云 SLB、腾讯云 CLB 上传证书时同样要传”站点证书 + 中间证书”的完整内容,只传叶子证书时健康检查通过、但部分移动端握手失败;另外证书在证书管理中续期后,若监听器绑定的是旧证书 ID,需要重新绑定或启用自动更新,否则到期当天才炸。

选型与成本怎么算?单机自建优先 Nginx 手工配置,可控性最高,改 TLS 版本、加 HSTS、开 OCSP Stapling 都只动一处;多机集群用云负载均衡绑定证书,续期只换一次,不必逐台 reload。这也是各类 SSL 证书安装教程 comparison 里最常被忽略的成本项——人工时间。价格参考国内云厂商公开报价:Let’s Encrypt DV 免费,商业 DV 单域名约 100-400 元/年,DV 通配符约 600-1500 元/年,OV 约 800-2000 元/年,具体以购买页为准。

常见追问:“宝塔保存后提示成功但浏览器仍显示旧证书?”多半是 CDN 或 SLB 在前面终止了 TLS,源站证书不参与握手,需在 CDN 侧也更新;”Apache 改了配置为什么没生效?”先看 apachectl configtest 是否返回 Syntax OK,再确认 systemctl reload 而非 restart,reload 才会平滑加载新证书。更多 TLS 参数调优可对照 Mozilla 的 SSL Configuration Generator 与 RFC 8446(TLS 1.3)核对默认值。

安装 SSL 证书时最常见的 6 个真实报错与排查顺序

这六个报错有一个共同规律:报错文本本身已经指明了出错层级。按“文件层 → 密钥层 → 证书链层 → 网络层 → 协议扩展层”的顺序排查,比反复重装证书快得多。下面的 SSL 证书安装教程对比(comparison)在多平台实测中都复现了同样的失败模式,命令以 Nginx 1.18+/OpenSSL 1.1.1 为准(CentOS 7 自带 OpenSSL 1.0.2k 的 `openssl pkey` 语法略有差异,见文末说明)。

报错关键字 出错层 根因 首查命令
PEM_read_bio_X509_AUX … no start line 文件层 证书文件为空或内容错误 head -1 fullchain.pem
X509_check_private_key:key values mismatch 密钥层 私钥与证书不配对 openssl x509 -noout -modulus
ERR_CERT_AUTHORITY_INVALID / PKIX path building failed 证书链层 只部署了叶子证书 grep -c "BEGIN CERT"
curl: (60) unable to get local issuer certificate 链/客户端 CA 库 链不全或 CA 库过旧 curl --cacert
curl: (28) timed out after 20001 ms 网络层 安全组/firewalld/IPv6 黑洞 ss -lntp | grep 443
“ssl_stapling” ignored, issuer certificate not found 协议扩展层 缺中间证书或未配 trusted_certificate openssl s_client

1. 报 no start line,是不是证书文件坏了? 多数情况不是文件损坏,而是内容为空,或把私钥贴进了证书文件。据 OpenSSL 文档,`PEM_read_bio_X509_AUX()` 只接受以 `—–BEGIN CERTIFICATE—–` 开头的块,任何其他首行都会触发 `error:0909006C`:

# 首行必须是 -----BEGIN CERTIFICATE-----,若为 BEGIN PRIVATE KEY 说明贴错了
head -1 /etc/nginx/ssl/fullchain.pem

# 证书块数量应 ≥2(叶子 + 中间证书);等于 1 就是链不全
grep -c "BEGIN CERTIFICATE" /etc/nginx/ssl/fullchain.pem

2. key values mismatch 怎么确认配对? RSA 证书比 modulus 的 MD5,ECDSA 证书比公钥(Let’s Encrypt 2015 年后默认签发 ECDSA 或 RSA-2048,两者方法不同):

# RSA:两条命令输出的 md5 必须完全一致
openssl x509 -noout -modulus -in fullchain.pem | openssl md5
openssl rsa  -noout -modulus -in example.com.key | openssl md5

# ECDSA(或通用写法,OpenSSL 1.1.1+ 支持 pkey)
openssl x509 -pubkey -noout -in fullchain.pem | openssl md5
openssl pkey -pubout -in example.com.key   | openssl md5

3. 浏览器报 AUTHORITY_INVALID、Java 报 PKIX path building failed,为什么同一个站有的客户端正常? 因为浏览器有 AIA 自动补链能力,Java 和 curl 不会。据 Let’s Encrypt 文档,服务端必须下发叶子证书 + 全部中间证书(根证书不必下发),顺序为叶子在前。验证方式是直接数握手返回的证书数量:

openssl s_client -connect example.com:443 -servername example.com -showcerts /dev/null 
  | grep -c "BEGIN CERTIFICATE"   # 期望 ≥2

# 用完整链自校验,能通过说明链顺序与内容都正确
openssl verify -CAfile fullchain.pem -untrusted fullchain.pem example.com.crt

4. curl: (60) 到底是服务端问题还是客户端问题? 先用服务端自己的链做 CA 库,一次性区分责任方:

# 用 fullchain.pem 当信任锚,能通过 = 服务端链没问题,问题在客户端 CA 库
curl -sS -o /dev/null -w '%{http_code}n' --cacert fullchain.pem https://example.com

# CentOS 7 的 ca-certificates 常年未更新,更新后再试
yum update -y ca-certificates && update-ca-trust

5. curl: (28) 超时,怎么分清防火墙和 IPv6? 先确认本地真的在监听 443,再分别用 IPv4/IPv6 测试,因为 AAAA 记录指向一台没监听 IPv6 的机器时,curl 默认会先试 IPv6 然后卡满超时:

ss -lntp | grep 443                    # 无输出 = Nginx 没起来或 listen 写错
firewall-cmd --list-ports              # 确认 443/tcp 已放行
curl -4 -m 5 -I https://example.com    # 只走 IPv4
curl -6 -m 5 -I https://example.com    # 只走 IPv6,超时则删掉 AAAA 记录

6. ssl_stapling 被 ignored 怎么办? Nginx 的 `ssl_stapling` 默认 `off`,`ssl_stapling_verify` 默认 `off`,且只有同时提供 `ssl_trusted_certificate`(默认未设置)和 `resolver` 时才会真正生效。缺中间证书时它找不到颁发者,直接静默降级:

ssl_certificate           /etc/nginx/ssl/fullchain.pem;  # 叶子 + 中间证书
ssl_certificate_key       /etc/nginx/ssl/example.com.key;
ssl_trusted_certificate   /etc/nginx/ssl/fullchain.pem;   # 缺这行 stapling 必然失效
ssl_stapling on;
ssl_stapling_verify on;
resolver 223.5.5.5 valid=300s;                            # 无默认值,必须显式配置

改完统一走一遍收尾验证,`nginx -t` 通过再 reload,避免把可用站点 reload 成 502:

nginx -t && systemctl reload nginx
openssl s_client -connect example.com:443 -servername example.com -verify_return_error </dev/null
# 输出末尾出现 Verify return code: 0 (ok) 即链路完整

版本提示:CentOS 7 自带 OpenSSL 1.0.2k 没有 openssl pkey,请改用 openssl ec -pubout;宝塔面板与云平台一键部署会把证书写到自己的目录(如 /www/server/panel/vhost/cert/),手工替换文件后需在面板内点一次“保存”才会重新生成 vhost 配置,否则 reload 后仍是旧证书——这也是多平台 SSL 证书安装教程对比中最容易踩的坑。

怎么确认 SSL 证书真的装好了?6 条可复现的验证命令

装完证书、浏览器出现小锁,就等于配好了吗?并不等于。本文这套 ssl证书 安装教程 comparison 覆盖了 Nginx、Apache、宝塔面板和云平台一键部署四种方式,但无论走哪条路,验收标准是同一套:下面 6 条命令可以复现,任何一条不通过都说明配置还有问题。

# 检查项 通过标准 最常见失败原因
1 连通与响应头 HTTP/2 200 且含 strict-transport-security add_header 被内层 location 覆盖
2 协议版本 TLS 1.1 失败,1.2/1.3 成功 ssl_protocols 仍保留 TLSv1/TLSv1.1
3 套件枚举 无 TLS_RSA_WITH_* 静态 RSA 套件 密码套件未排除 aRSA
4 OCSP Stapling OCSP Response Status: successful 缺 ssl_stapling on 或信任链文件
5 到期监控 -checkend 退出码为 0 Let’s Encrypt 90 天证书未自动续期
6 综合评分 SSL Labs 评级 A 及以上 中间证书缺失、DH 参数过弱
# 1) 连通与响应头:期望 HTTP/2 200,并出现 strict-transport-security
curl -sI https://example.com | head -5

# 2) 协议版本:TLS 1.1 必须失败(OpenSSL 3.x 提示 no protocols available)
openssl s_client -connect example.com:443 -tls1_1 </dev/null
openssl s_client -connect example.com:443 -tls1_2 </dev/null | grep Protocol
openssl s_client -connect example.com:443 -tls1_3 </dev/null | grep Protocol

# 3) 套件枚举(nmap 7.x,需安装 ssl-enum-ciphers 脚本)
nmap --script ssl-enum-ciphers -p 443 example.com

# 4) OCSP Stapling:返回 successful 表示服务端已装订响应
openssl s_client -connect example.com:443 -servername example.com -status /dev/null 
  | grep -A1 'OCSP Response Status'

# 5) 有效期 + 30 天到期告警(2592000 秒);退出码 0 表示仍有效,非 0 触发告警
echo | openssl s_client -connect example.com:443 2>/dev/null | openssl x509 -noout -dates -subject
echo | openssl s_client -connect example.com:443 2>/dev/null | openssl x509 -noout -checkend 2592000; echo "exit=$?"

# 6) 综合评分:浏览器打开 SSL Labs,或直接带参数
#    https://www.ssllabs.com/ssltest/analyze.html?d=example.com
#    再在 Chrome DevTools Console 过滤 "Mixed Content"

第 1 条最容易出问题:Nginx 的 add_header 只在 200、201、204、206、301、302、303、304、307、308 这些状态码下生效,而且只要内层 location 里写了任意一条 add_header,父级的 HSTS 头就会被整体覆盖、不再继承。这也是“证书明明装了却没有 HSTS”的典型原因,规范定义见 RFC 6797。

第 2、3 条检查的是同一件事的两个层面:RFC 8996 已正式弃用 TLS 1.0/1.1,所以 -tls1_1 必须失败;套件层面则要消除静态 RSA 密钥交换,否则不具备前向保密(RFC 8446 推荐 ECDHE)。可直接参考 Mozilla SSL Configuration Generator 的 intermediate 配置逐行比对。

第 4 条中,-servername 不能省,否则 SNI 未命中会拿到默认站点的证书;若返回 OCSP Response Status: successful 之外的 tryLater 或空值,先检查 ssl_trusted_certificate 是否指向完整链。第 5 条建议直接接入监控:据 Let’s Encrypt 文档,其证书有效期 90 天,官方建议在剩余 30 天时续期,2592000 正好是这个阈值。第 6 条以 Qualys SSL Labs 的评级为准,重点看 Certificate Chains、Protocol Support、Key Exchange 三项;DevTools 里残留的 HTTP 资源则会静默降级为混合内容。

把这 6 条串成脚本后,任何一种 ssl证书 安装教程 comparison 的结论都能被客观复核,而不是靠“打开网站看看有没有锁”。

证书文件格式怎么选?PEM、DER、PFX、JKS 的转换与部署场景对照

先看一条真实报错。很多人把 CA 下载包里的 cert.der 直接写进 ssl_certificate,Nginx 起不来:

nginx: [emerg] PEM_read_bio_X509_AUX("/etc/nginx/ssl/cert.der") failed
(SSL: error:0909006C:PEM routines:get_name:no start line:Expecting: TRUSTED CERTIFICATE)

no start line 的含义很直接:OpenSSL 在文件里找不到 -----BEGIN CERTIFICATE----- 这一行。据 OpenSSL 文档,Nginx 的 ssl_certificate、Apache 的 SSLCertificateFile 以及 HAProxy 的 crt 都只接受 PEM 编码(RFC 7468 定义的文本封装),后缀叫 .pem、.crt、.cer 都无所谓——判断格式要看内容,不看扩展名,用 head -1 cert.crt 或 file cert.crt 确认即可。这也是任何一份 ssl证书 安装教程 comparison 里最该前置的一步。

格式 编码 常见后缀 典型部署目标 含私钥 含中间链
PEM Base64 文本 .pem/.crt/.cer/.key Nginx、Apache、HAProxy、Caddy 分离存放 需手工拼接 fullchain
DER 二进制 ASN.1 .der/.cer 老式防火墙、部分 CA 下载包 否 否
PFX (PKCS#12) 二进制容器 .pfx/.p12 IIS、Tomcat、Windows 证书存储 是 取决于导出参数
JKS Java 专有二进制 .jks/.keystore Tomcat 7、老版 WebLogic/WebSphere 是 是

DER ↔ PEM:一条命令的事。按 RFC 7468,二者只是同一段 ASN.1 的编码差异,转换不涉及重新签发:

# DER 转 PEM(-inform 指定输入编码)
openssl x509 -inform DER -in cert.der -out cert.pem

# PEM 转 DER(-outform 指定输出编码)
openssl x509 -in cert.pem -outform DER -out cert.der

IIS 与 Tomcat 用 PFX。最容易踩的坑是漏掉 -certfile:不带它,导出的 PFX 里只有叶子证书,IIS 会报“证书链不完整”,Tomcat 客户端会看到 unable to find valid certification path。

# -certfile 传入中间证书;-passout 明文仅用于测试,生产建议用 file: 或交互输入
openssl pkcs12 -export -out example.pfx 
  -inkey example.com.key -in fullchain.pem -certfile intermediate.crt 
  -passout pass:1234

# OpenSSL 3.x 默认用 AES-256-CBC + PBKDF2,Windows Server 2012 及更早的 IIS 不认;
# 需兼容老系统时加 -legacy(或显式指定 3DES/SHA1)
openssl pkcs12 -export -legacy -out example.pfx 
  -inkey example.com.key -in fullchain.pem -certfile intermediate.crt -passout pass:1234

Java 环境转 JKS。自 JDK 9 起,java.security 中 keystore.type 的默认值已改为 pkcs12,Tomcat 8.5+ 也直接支持 PKCS12;只有中间件强制要求 JKS 时才需要显式写 -deststoretype JKS,否则会得到一个后缀是 .jks、内容却是 PKCS12 的文件,加载时报 java.io.IOException: Invalid keystore format。

keytool -importkeystore 
  -srckeystore example.pfx -srcstoretype PKCS12 -srcstorepass 1234 
  -destkeystore example.jks -deststoretype JKS 
  -deststorepass changeit -destkeypass changeit

转换后必须复验链是否完整。下面这条命令统计 PFX 中的证书条数,输出应 ≥2(叶子 + 中间证书),只输出 1 就说明 -certfile 漏了:

openssl pkcs12 -in example.pfx -nokeys -passin pass:1234 | grep -c "BEGIN CERTIFICATE"
# 期望输出:2 或更多

# 顺带确认私钥与证书配对(RSA;ECDSA 改用 -pubkey 比对)
openssl x509 -noout -modulus -in cert.pem | openssl md5
openssl rsa  -noout -modulus -in example.com.key | openssl md5

两行 MD5 一致才说明 key 与 cert 匹配。按 Mozilla 服务器端 TLS 配置建议,部署前还应确认 fullchain 中叶子证书在首位、中间证书在后,且不含根证书——这也是后续 Nginx 与 Apache 实操环节的公共前提。

先按 F12 看 Security 面板的具体报错。若是 NET::ERR_CERT_AUTHORITY_INVALID,基本是证书链不完整,把 fullchain.pem(叶子 + 中间证书)重新部署即可;若是“混合内容”,则是页面里还有 http:// 的图片或脚本,需要改成相对协议或 https。用 openssl s_client -connect 域名:443 -showcerts 看返回几张证书,是最快的判断方法。

Nginx 只需 ssl_certificate 指向 fullchain.pem 一行;Apache 2.4.8 之后同样把链拼进 SSLCertificateFile,但 2.4.8 之前必须额外写 SSLCertificateChainFile。两者工作量接近,差别在细节:Nginx 的 ssl_stapling 依赖 resolver 指令,Apache 的 OCSP 需要单独配 SSLStaplingCache。已有业务跑在哪个服务器上就继续用哪个,为装证书换 Web 服务器不划算。

步骤完全一样,都是拿到 fullchain.pem 和私钥后改配置 reload。差别在签发与续期:Let's Encrypt 有效期 90 天,通常用 certbot 的 systemd timer 或 acme.sh 自动续期并在续期后 reload Nginx;商业 DV 多为 1 年,需要手工重签再替换文件。选型上看你是否愿意维护自动化,能维护的话免费证书在功能上不输 DV。

单机多站点、不熟悉配置语法的选宝塔,2-3 分钟能上线,续期也由面板托管;但要注意面板会覆盖手工改动,且证书链文本框不能留空。需要自定义 TLS 套件、OCSP、HSTS 预加载或多级反代的,直接改 nginx.conf 更可控。折中做法是在面板里部署,再在站点配置的 include 片段里追加参数。

常见三种原因:一是安全组只放行了办公网 IP,curl 从另一台机器发起被拦;二是域名同时有 AAAA 记录,curl 优先走 IPv6 而服务器没监听 IPv6,用 curl -4 立刻能通;三是中间有代理,需要设 https_proxy。用 ss -lntp | grep 443 确认本地监听,再用 curl -v -4 与 curl -v -6 分别测试,两分钟能定位。

可以。证书绑定的是域名,不是 IP 或机器数量,同一张证书部署到 N 台服务器不受限制(单域名证书仅限该域名)。需要注意两点:私钥在多台机器间分发要控制权限(600、root 属主);多机环境下续期要保证所有节点同时替换,否则会出现部分节点证书过期。用配置管理工具或共享存储统一下发更稳。

需要替换文件,但不用重新走申请流程。certbot renew 或 acme.sh –renew 会把新的 fullchain.pem 写回原路径,只要配置里引用的是这个路径,执行一次 systemctl reload nginx 就生效。建议在续期钩子里加 –deploy-hook “systemctl reload nginx”,避免出现“证书已续期但服务仍在用旧证书”的情况,可用 openssl x509 -noout -dates 复查实际生效日期。


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

内容审核

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