SSL证书购买怎么配置:从下载包到Nginx/Apache上线的8步实操与验收清单
SSL证书购买怎么配置的核心是:把CA交付的服务器证书与中间证书合并为fullchain,私钥单独保存,在Nginx 1.24用ssl_certificate指向fullchain、ssl_certificate_key指向私钥,reload后用openssl s_client -connect 域名:443 -servername 域名验证,看到Verify return code: 0 (ok)才算链完整。 购买后先数文件:单域名DV通常交付domain.crt、ca-bundle.crt、fullchain.crt、private.key或PFX;Nginx只认fullchain+key两个文件,Apache 2.4.58认SSLCertificateFile fullchain与SSLCertificateKeyFile key。 合并命令用cat domain.crt ca-bundle.crt > fullchain.crt,顺序不能反;用openssl verify -CAfile ca-bundle.crt domain.crt应返回OK,grep -c BEGIN CERTIFICATE fullchain.crt通常为2。 配置后必须做三项验收:nginx -t输出syntax is ok;curl -I https://域名返回200;openssl x509 -in fullchain.crt -noout -checkend 2592000确认30天内不过期。
先看一个真实场景:你在购买页选了 DV 单域名证书,付款后收到一个 zip,里面有 domain.crt、ca-bundle.crt、fullchain.crt、private.key、domain.pfx 五个文件。你把 domain.crt 填进 Nginx 的 ssl_certificate,nginx -t 通过、浏览器绿锁也正常,但 Android 7 客户端和 Java 8 的 HttpsURLConnection 抛出 unable to get local issuer certificate。问题不在证书买错,而在交付文件与服务器信任链不匹配。
根因一:交付包五类文件的分工,和服务器指令不是一对一
| 文件 | 实际内容 | 该填到哪 |
|---|---|---|
domain.crt |
仅服务器(叶子)证书 | 不可单独用于 Nginx;缺中间证书 |
ca-bundle.crt |
中间证书(可能多张) | Apache 2.4.8 以下配 SSLCertificateChainFile |
fullchain.crt |
叶子证书 + 中间证书 | Nginx ssl_certificate、Apache 2.4.8+ SSLCertificateFile |
private.key |
私钥(PKCS#8 或 PKCS#1) | ssl_certificate_key,权限 600 |
.pfx / .p12 |
证书 + 私钥 + 链(PKCS#12) | IIS 10 导入;Nginx 需先转换 |
据 Let’s Encrypt 文档,链文件应包含服务器证书与中间证书,不应包含根证书——根证书由客户端自带,重复下发反而增大握手包并可能触发部分客户端的链校验告警。Nginx 1.24.0 的 ssl_certificate 只读取一个文件,所以标准做法是把 fullchain 交给它,私钥另配。用下面这条命令确认链里到底有几张证书(正常应为 2~3 张):
# 统计 fullchain 中的证书数量:叶子 + 中间证书,不应含根证书
grep -c "BEGIN CERTIFICATE" fullchain.crt
# 查看链中每一张证书的 subject / issuer,确认顺序为 叶子 -> 中间
openssl crl2pkcs7 -nocrl -certfile fullchain.crt
| openssl pkcs7 -print_certs -noout
根因二:CSR 与私钥生成位置不一致
若由 CA 代生成 CSR,私钥可能藏在交付包的 .pfx 里、或只存在于 CA 后台,你手里的 private.key 根本不是配对的那把。此时 nginx -t 会直接报 SSL_CTX_use_PrivateKey() failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch)。部署前务必比对:
# 分别导出证书公钥与私钥公钥,输出必须逐字节一致
openssl x509 -in fullchain.crt -noout -pubkey > /tmp/cert.pub
openssl pkey -in private.key -pubout > /tmp/key.pub
diff /tmp/cert.pub /tmp/key.pub && echo "MATCH: 私钥与证书配对"
# 确认证书覆盖范围:通配符 *.example.com 不含 example.com 裸域
openssl x509 -in fullchain.crt -noout -ext subjectAltName
证书类型不改变指令,只改变覆盖范围:DV 单域名通常 5~15 分钟签发;SAN 多域名必须在购买时同时勾选 example.com 与 www.example.com,事后无法免费追加;OV 需 1~3 个工作日组织验证,但 Nginx/Apache 配置参数与 DV 完全相同;通配符 *.example.com 不覆盖 example.com,上面那条 -ext subjectAltName 就是用来验收这一点的。
服务器版本决定参数名,抄错版本等于白配:
| 服务器版本 | 证书指令 | 私钥 / 链 | HTTP/2 写法 |
|---|---|---|---|
Nginx 1.24.0(1.25.1 起 http2 独立成 http2 on;) |
ssl_certificate fullchain.crt; |
ssl_certificate_key private.key;(无独立链指令) |
listen 443 ssl http2; |
| Apache 2.4.58 | SSLCertificateFile fullchain.crt |
SSLCertificateKeyFile private.key;SSLCertificateChainFile 自 2.4.8 起不再必需 |
Protocols h2 http/1.1 |
| IIS 10 | 导入 .pfx 后在 443 绑定中勾选 SNI |
PFX 内含私钥,无需单独文件 | 由 Windows 版本决定 |
那么配置不生效时按什么顺序查?经验上 90% 不是证书买错,而是文件、权限、443 监听、防火墙、CDN 回源这五处之一。先 openssl version 确认是 OpenSSL 3.0.x(Ubuntu 22.04 默认版本),再按”文件核对 → 权限 600 → nginx -t → reload → openssl s_client“逐级排查:
# 1. 私钥权限:Nginx worker 以非 root 运行,但仍建议 600 + root 属主
chmod 600 private.key && chown root:root private.key
# 2. 语法检查(会同时校验证书与私钥是否配对)
nginx -t
# 3. 平滑重载,而非 restart
systemctl reload nginx
# 4. 从外部验证实际下发的证书链与有效期
openssl s_client -connect example.com:443 -servername example.com
-showcerts /dev/null | openssl x509 -noout -subject -dates
单域名 + Nginx 的熟练配置,从解压到 s_client 验证通过通常 0.5~1 小时;时间几乎全花在核对 fullchain 与私钥配对上,而不是改配置本身。Mozilla SSL Configuration Generator 给出的 1.24.0 模板可直接作为基线,但记得把 ssl_certificate 指向 fullchain 而非 domain.crt。
SSL证书购买怎么配置的完整8步实操:从CSR到reload
“证书压缩包解压后一堆 .crt,哪个该配到 Nginx?”这是 SSL 证书购买怎么配置时最高频的卡点。下面 8 步按真实交付顺序走一遍,命令可直接复制,每一步都给出可判读的输出。
步骤 1:核对 CSR 与私钥。先进入 CA 交付目录执行 ls -l,私钥必须是 -rw-------(600)。若 CA 没有下发私钥,说明你提交的是自己生成的 CSR——这正确,因为 CSR 只含公钥与主体信息,私钥必须留在本机,任何要求你上传私钥的流程都应视为风险信号。用 OpenSSL 3.0.13(openssl version 可查)生成:
# -nodes:私钥不加密,便于 Nginx/Apache 开机自动加载
# -addext 需 OpenSSL 1.1.1 及以上;www 子域务必进 SAN,CN 已不被浏览器采信
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"
chmod 600 example.com.key && chown root:root example.com.key
ls -l example.com.key # 期望 -rw------- 1 root root
购买页的 SAN 输入框要再填一次 www.example.com,CA 以页面填写为准,不以 CSR 为准。
步骤 2:提交 CA 验证。DV 证书可选 DNS TXT 记录或 /.well-known/pki-validation/ 下的 HTTP 文件;通配符证书按 CA/B Forum 基线要求只能用 DNS-01。OV 还需上传营业执照并接听组织核验电话。据 Let’s Encrypt 与主流商业 CA 的公开说明,DV 通常 5–15 分钟,OV 约 1–3 个工作日。验证通过后立即下载,切勿重复提交,否则会生成多张并存证书、续期时选错文件。
步骤 3:识别下载包。不同 CA 命名不一,对应关系如下:
| 文件名 | 内容 | 用途 |
|---|---|---|
| domain.crt / example.com.crt | 仅服务器(叶子)证书 | 不可单独上线 |
| ca-bundle.crt / chain.crt | 中间证书 | 拼接用 |
| fullchain.crt | 叶子 + 中间(顺序固定) | Nginx 直接用 |
| private.key | 私钥 | 权限 600 |
| *.pfx | 含私钥的 PKCS#12 | IIS / Tomcat 导入 |
openssl x509 -in domain.crt -noout -subject -issuer -dates -ext subjectAltName
# 核对:subject 的 CN、issuer 是否为该 CA 中间证书、notAfter 到期日、SAN 是否含 www
步骤 4:合并并校验 fullchain。顺序必须服务器证书在前、中间证书在后,反了浏览器会报 NET::ERR_CERT_AUTHORITY_INVALID:
cat domain.crt ca-bundle.crt > fullchain.crt
grep -c "BEGIN CERTIFICATE" fullchain.crt # 通常返回 2(含交叉证书可能为 3)
openssl verify -CAfile ca-bundle.crt domain.crt
# 期望:domain.crt: OK
# 报 unable to get local issuer certificate → 中间证书缺失或顺序错误
步骤 5:上传赋权。目录 700、私钥 600,避免 Nginx worker 之外的可读面:
install -d -m 700 /etc/nginx/ssl
install -m 600 -o root -g root fullchain.crt example.com.key /etc/nginx/ssl/
步骤 6:写入 server 块。ssl_certificate 指向 fullchain,ssl_certificate_key 指向私钥(Nginx 1.25.1+ 用 http2 on;,旧版写在 listen 443 ssl http2;):
server {
listen 443 ssl;
http2 on;
server_name example.com www.example.com;
ssl_certificate /etc/nginx/ssl/fullchain.crt; # 必须含中间证书
ssl_certificate_key /etc/nginx/ssl/example.com.key;
ssl_protocols TLSv1.2 TLSv1.3;
ssl_session_cache shared:SSL:10m;
}
步骤 7:语法检查。执行 nginx -t,须看到 syntax is ok 与 test is successful;若报 PEM_read_bio_X509_AUX() failed,多为文件路径错或复制时混入 HTML。Apache 用 apachectl configtest,返回 Syntax OK。
步骤 8:平滑重载并首验。reload 不断连接,restart 会瞬断,生产环境一律用前者:
systemctl reload nginx # Apache:systemctl reload httpd
curl -I https://example.com
# 期望首行 HTTP/2 200;再用 curl -vI https://example.com 看证书链是否完整
到这里,SSL 证书购买怎么配置的主链路已闭环;链不完整、SAN 缺失、私钥权限过宽这三类问题,占实际工单的绝大多数,上面每条命令都对应其中一项的可验证证据。
SSL证书购买怎么配置的Nginx/Apache命令示例与参数(含版本)
“证书文件已经下载了,Nginx 和 Apache 到底改哪几行?”这是 SSL 证书购买怎么配置时最容易卡住的一步。先给结论:证书链用 fullchain.crt(服务器证书 + 中间证书),私钥单独放,协议只留 TLSv1.2/TLSv1.3,改完先 nginx -t 或 apachectl configtest,通过后再 reload,不要直接 restart 生产环境。
Nginx 1.24.0 最小可用片段(放在 /etc/nginx/conf.d/example.conf):
server {
listen 443 ssl http2; # 1.24 仍用此写法;1.25.1+ 可改为 listen 443 ssl; + http2 on;
server_name example.com www.example.com;
ssl_certificate /etc/nginx/ssl/fullchain.crt; # 必须含中间证书
ssl_certificate_key /etc/nginx/ssl/example.com.key; # 权限 600,禁止放网站根目录
ssl_protocols TLSv1.2 TLSv1.3; # 1.23.4 起默认值即为此;旧版本默认含 TLSv1/1.1
ssl_session_cache shared:SSL:10m; # 默认 none;10m 约可缓存 4 万个会话
ssl_session_timeout 1d;
add_header Strict-Transport-Security "max-age=31536000" always; # HSTS,确认全站 HTTPS 后再开
}
据 Mozilla SSL Configuration Generator,面向一般客户端的 intermediate 配置显式限定 TLSv1.2 与 TLSv1.3,兼容性覆盖主流浏览器;Nginx 的 ssl_protocols 未写时按编译版本取默认值,显式声明可避免升级后行为漂移。
Apache 2.4.58 片段(/etc/httpd/conf.d/ssl.conf):
<VirtualHost *:443>
SSLEngine on
SSLCertificateFile /etc/httpd/ssl/fullchain.crt # 2.4.8 起链文件可并入此处
SSLCertificateKeyFile /etc/httpd/ssl/example.com.key
SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1 # 2.4 默认 all -SSLv3,仍建议显式收紧
SSLCipherSuite HIGH:!aNULL:!MD5 # 2.4 默认值,可按 Mozilla intermediate 替换
Header always set Strict-Transport-Security "max-age=31536000"
</VirtualHost>
2.4.8 起不再需要单独写 SSLCertificateChainFile,把中间证书拼进 fullchain.crt 即可;若仍写旧指令,2.4.58 会提示 AH02559: The SSLCertificateChainFile directive is deprecated。
| 项目 | Nginx 1.24.0 | Apache 2.4.58 |
|---|---|---|
| 证书指令 | ssl_certificate |
SSLCertificateFile |
| 私钥指令 | ssl_certificate_key |
SSLCertificateKeyFile |
| 协议控制 | ssl_protocols,默认 TLSv1.2/1.3 |
SSLProtocol,默认 all -SSLv3 |
| 配置检查 | nginx -t |
apachectl configtest |
| 错误日志 | /var/log/nginx/error.log |
/var/log/httpd/ssl_error_log |
面板与 Windows:宝塔面板 8.x 走“网站 → SSL → 其他证书”,证书框粘贴 fullchain.crt 全文、私钥框粘贴 example.com.key 全文;保存后确认 /www/server/panel/vhost/cert/域名/ 下生成 fullchain.pem 与 privkey.pem,再重载 Nginx。IIS 10 则把 PFX 导入“个人”证书存储,在 443 绑定里选该证书并勾选 SNI,否则多站点会串证。
权限与 SELinux:
install -m 600 -o root -g root example.com.key /etc/nginx/ssl/ # 私钥仅 root 可读
restorecon -Rv /etc/nginx/ssl # 恢复默认 SELinux 上下文
getenforce # Enforcing 时继续看下一步
chcon -t httpd_config_t /etc/nginx/ssl/example.com.key # 日志报 13 Permission denied 时使用
# 切勿 chmod 777,也不要把 .key 放进 /var/www 网站根目录
重载与排错:
nginx -t && systemctl reload nginx
journalctl -u nginx -n 50 --no-pager
tail -f /var/log/nginx/error.log
# Apache
apachectl configtest && systemctl reload httpd
tail -f /var/log/httpd/ssl_error_log
重载失败时先看 error.log 第一行,例如 nginx: [emerg] cannot load certificate ... SSL_CTX_use_certificate_chain_file() failed 多为路径错或证书与私钥不匹配;Apache 报 AH02572: Failed to configure at least one certificate and key 同理。可用 openssl x509 -noout -modulus -in fullchain.crt | openssl md5 与私钥的 modulus 对比确认配对。这也是 SSL 证书购买怎么配置里最值得写进验收清单的一步:配置检查通过、日志无 SSL 报错、浏览器显示锁标,三者齐全再切流量。
SSL证书购买怎么配置选型表:DV/OV/通配符交付物对应哪个参数
买完证书后最容易卡住的一步,不是付款,而是打开压缩包看到 domain.crt、ca-bundle.crt、fullchain.crt、example.com.key 四个文件,不知道哪个该填进哪个参数。先记住一条铁律:Web 服务器里永远填 fullchain + key,绝不只填 domain.crt。只填站点证书会丢中间证书,Android 和部分 Java 客户端会直接报 unable to get local issuer certificate(OpenSSL 校验失败)或浏览器 NET::ERR_CERT_AUTHORITY_INVALID。
| 证书类型 | 典型交付文件 | Nginx 参数 | Apache 参数 | 配置注意 |
|---|---|---|---|---|
| DV 单域名 | domain.crt、ca-bundle.crt、fullchain.crt、私钥 key | ssl_certificate fullchain.crt; |
SSLCertificateFile fullchain.crt |
5–15 分钟签发;带 www 必须在购买时把 www.example.com 加进 SAN,事后无法补 |
| OV 单域名 | 同上,另附组织验证记录(邮件/订单号) | 参数不变 | 参数不变 | 验证需 1–3 个工作日;合规场景保留验证邮件与订单号;主题含 O=,用 openssl x509 -noout -subject 核对 |
| 通配符 | *.example.com 的 fullchain 与 key |
server_name 可列多个子域 |
用 ServerAlias 列子域 |
走 DNS-01 验证;*.example.com 不覆盖 example.com,购买时把根域加进 SAN 或另配一张证书 |
| 多域名 / SAN | 一张证书含多个 SAN 条目 | 一个 server 块写多个 server_name |
多个 ServerAlias |
参数仍是 fullchain + key;不同主域共用一张证书时,旧客户端不支持 SNI(RFC 6066)需独立 IP |
| CDN / 负载均衡 | fullchain + key(上传到控制台) | 源站仍需配证书,或仅信任回源 CA | 同左 | 回源协议选 HTTPS;IIS/Tomcat 用 PFX/PKCS12,Tomcat 10.1 在 server.xml 配 keystoreFile 与 keystorePass |
上线前先做两件核对,比改配置更省时间。第一件是确认 fullchain 真的是“全链”——按 OpenSSL 文档,一个 PEM 文件里可顺序放多张证书:
# 期望输出 2 或 3(站点证书 + 1~2 张中间证书);只输出 1 说明你拿错了文件
grep -c "BEGIN CERTIFICATE" fullchain.crt
# 核对主题里的 O= 是否为你的组织(只有 OV/EV 才有 O 字段)
openssl x509 -in domain.crt -noout -subject -issuer -dates
# 示例输出:subject=CN = example.com, O = 某某科技有限公司, C = CN
# issuer=C = US, O = DigiCert Inc, CN = DigiCert ...
第二件是把参数写对。Nginx 侧注意 http2 on; 是 1.25.1 起的新写法,旧版仍用 listen 443 ssl http2;;Apache 从 2.4.8 起 SSLCertificateFile 可直接指向全链文件,不再需要单独的 SSLCertificateChainFile。
# Nginx:通配符/SAN 证书把全部域名写进 server_name
server {
listen 443 ssl;
http2 on; # nginx < 1.25.1 请改用 listen 443 ssl http2;
server_name example.com www.example.com; # *.example.com 不含根域,根域要单独列
ssl_certificate /etc/nginx/ssl/fullchain.crt; # 必须是全链
ssl_certificate_key /etc/nginx/ssl/example.com.key; # 权限建议 600,属主 root
ssl_protocols TLSv1.2 TLSv1.3; # 参照 Mozilla SSL Configuration Generator 中间档
}
# Apache 2.4.8+:全链直接放进 SSLCertificateFile
<VirtualHost *:443>
ServerName example.com
ServerAlias www.example.com *.example.com
SSLCertificateFile /etc/httpd/ssl/fullchain.crt
SSLCertificateKeyFile /etc/httpd/ssl/example.com.key
</VirtualHost>
选型时还有一个常被忽略的对应关系:证书类型决定的是“交付物和验证流程”,而 Nginx/Apache 的参数名在 DV、OV、通配符、SAN 之间完全不变,永远是 fullchain + key。真正会变的只有 server_name/ServerAlias 里列多少个域名,以及 DNS-01 通配符必须走 TXT 记录这条验证路径——据 Let’s Encrypt 文档,通配符只能通过 DNS-01 签发,HTTP-01 不支持。
- SSL证书申请 · SSL证书购买 · SSL证书安装配置
- HTTPS证书申请 · SSL证书安装部署 · 证书续费
- 代购 SSL 证书 · DigiCert / GeoTrust / RapidSSL 单域名与通配符
- NGINX / APACHE / TOMCAT / IIS 证书配置 · SSL证书安装
- HTTPS配置 · SSL证书安装服务(各种服务器)
- APP/小程序 HTTPS · SSL网站加密证书 · CA证书配置
SSL证书购买怎么配置后常见报错:PEM routines、key values mismatch怎么排
证书买完、包也下载了,配置 SSL证书购买怎么配置 的最后一段往往卡在 Nginx/Apache 的启动报错上。下面按真实报错原文逐条拆。
Q1:nginx: [emerg] PEM_read_bio_X509_AUX() failed (SSL: error:0480006C:PEM routines::no start line) 是什么原因?
这是 OpenSSL 在读取 ssl_certificate 指向的文件时,第一行没有找到 -----BEGIN CERTIFICATE-----。最常见的原因是下载到的其实是 DER 二进制或未解压的 ZIP 包。先确认:
# 检查首行是否为 PEM 头;正常应输出 -----BEGIN CERTIFICATE-----
head -1 fullchain.crt
# 判断真实文件类型:应为 "PEM certificate",若为 "data" 多半是 DER
file fullchain.crt
# DER 转 PEM(.cer/.crt 后缀都可能是 DER)
openssl x509 -inform DER -in cert.cer -out cert.pem
# 转换后校验
openssl x509 -in cert.pem -noout -subject -dates
据 OpenSSL 官方文档,PEM_read_bio_X509_AUX() 只接受 Base64 编码的 PEM 结构,DER 会直接报 no start line。
Q2:SSL_CTX_use_PrivateKey_file(…) failed (SSL: error:0A00018E:SSL routines::key values mismatch) 怎么办?
证书公钥和私钥不配对,通常是重签后仍用旧私钥,或多域名包里拿错了 key。用公钥比对法一分钟定位:
# 分别导出公钥再 diff,无输出即配对成功
openssl x509 -in fullchain.crt -noout -pubkey > cert.pub
openssl pkey -in example.com.key -pubout > key.pub
diff cert.pub key.pub
# 也可直接看模数 MD5,两者应一致
openssl x509 -in fullchain.crt -noout -modulus | openssl md5
openssl rsa -in example.com.key -noout -modulus | openssl md5
有差异就重新下载私钥或重签证书,不要试图”修复”。
Q3:curl 报 (60) SSL certificate problem: unable to get local issuer certificate?
只部署了 domain.crt,中间证书缺失导致链不完整。先用 s_client 数一数服务端返回几张证书(正常为 2 张:站点证书 + 中间证书):
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | grep -c "BEGIN CERTIFICATE"
修复:把 ca-bundle.crt 内容追加到站点证书后生成 fullchain,顺序必须是「站点证书 → 中间证书」,不要放根证书(根证书已在客户端信任库,多余会拖慢握手并可能触发 Q6 的 AUTHORITY_INVALID)。Nginx 用 ssl_certificate fullchain.crt;,Apache 2.4.8+ 用 SSLCertificateFile /etc/ssl/fullchain.crt。
Q4:BIO_new_file(…private.key) failed (SSL: error:8000000D:system library::Permission denied)?
Nginx master 以 root 启动后 worker 降权为 nginx/www-data,读不到 600 权限的私钥。正确姿势:私钥 600 root:root、所在目录 700;SELinux 为 Enforcing 时补上下文:
chmod 600 /etc/ssl/private/example.com.key
chmod 700 /etc/ssl/private
# SELinux 场景(getenforce 为 Enforcing 时执行)
chcon -t httpd_config_t /etc/ssl/private/example.com.key
restorecon -Rv /etc/ssl/private
切勿 chmod 777,也绝不把私钥放进网站根目录。
Q5:Apache 报 AH02217: ssl_stapling_init_cert: can’t retrieve issuer certificate!?
开了 SSLUseStapling on 却取不到签发者,因为 SSLCertificateFile 只含叶子证书。Apache 2.4.58 下把 fullchain 写入该指令即可;老版本或需分离文件时显式指定链文件,然后必须跑 apachectl configtest 验证(输出 Syntax OK 才算过)。
Q6:浏览器报 NET::ERR_CERT_DATE_INVALID 或 NET::ERR_CERT_AUTHORITY_INVALID?
date -u # 先排除系统时间漂移,UTC 偏差会导致 DATE_INVALID
openssl x509 -in fullchain.crt -noout -dates -issuer -subject
核对 notBefore/notAfter 是否覆盖当前时间;若报 AUTHORITY_INVALID,则查证书链顺序是否颠倒或误塞根证书——据 Mozilla Server Side TLS 建议,服务端只需发送叶子 + 中间证书。
| 报错关键字 | 根因 | 一句话修复 |
|---|---|---|
| PEM routines::no start line | 文件是 DER/ZIP | 解压或 openssl x509 -inform DER 转 PEM |
| key values mismatch | 证书与私钥不配对 | diff 两份 pubkey,重下私钥或重签 |
| unable to get local issuer certificate | 缺中间证书 | 合并成 fullchain 并改指该文件 |
| system library::Permission denied | worker 无读权限 | 600 root:root + 目录 700 + SELinux 上下文 |
| AH02217 | Stapling 找不到签发者 | SSLCertificateFile 指向 fullchain 后 configtest |
| ERR_CERT_DATE_INVALID | 系统时间或证书过期 | date -u 校准,再查 -dates |
排查顺序建议固定为:openssl x509 -noout -text 看文件本身 → openssl s_client -showcerts 看服务端实际下发链 → 再看 Web 服务器 error_log。前两步能覆盖本节 90% 的 SSL证书购买怎么配置 后报错。
SSL证书购买怎么配置后怎么验证生效?openssl与curl验收清单
为什么 Verify return code: 0 (ok) 出现了也不能算通过?因为 OpenSSL 1.1.1 起 s_client 默认只打印校验结果、不改变退出码——握手失败或链不完整时进程依然返回 0。所以验收必须“读输出文本”,而不是看 $?。想让它失败即报错,可加 -verify_return_error。这也是 SSL 证书购买怎么配置完成后,最容易自欺欺人的一步。
第一关:链与主体(OpenSSL 1.1.1 / 3.x 通用)
# /dev/null 屏蔽噪音
openssl s_client -connect example.com:443 -servername example.com -showcerts /dev/null
| openssl x509 -noout -subject -issuer -dates -ext subjectAltName
# 期望:subject=CN = example.com
# issuer = 中间 CA(如 Let's Encrypt R11、DigiCert G2)
# SAN 同时含 example.com 与 www.example.com
# 末尾另需看到:Verify return code: 0 (ok)
# 若出现 verify error:num=20:unable to get local issuer certificate,说明 Nginx 只配了站点证书、漏了中间证书
第二关:协议与套件
for v in tls1_2 tls1_3; do
openssl s_client -connect example.com:443 -servername example.com -$v /dev/null
| grep "Verify return code" # 两条都应输出 0 (ok)
done
openssl s_client -connect example.com:443 -servername example.com -tls1_1 /dev/null
# 已禁用时应失败:alert protocol version / no protocols available
nmap --script ssl-enum-ciphers -p443 example.com # 结果中不得出现 SSLv3、TLSv1.0、TLSv1.1 段
第三关:HTTP 层(curl 7.79+ 支持 HTTP/2)
curl -sSI https://example.com | head -n 5
# 期望首行 HTTP/2 200 或 HTTP/1.1 200,并含 strict-transport-security: max-age=31536000
curl -sv https://example.com 2>&1 | grep -E 'SSL certificate verify|subject:'
# 期望 * SSL certificate verify ok. 与 * subject: CN=example.com
第四关:本地信任库——内部客户端不认公共 CA,就得手动导。
openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt fullchain.crt # fullchain.crt: OK
keytool -importcert -alias intermediate -file ca-bundle.crt
-keystore "$JAVA_HOME/lib/security/cacerts" -storepass changeit -noprompt
# cacerts 默认口令 changeit;Java 8u301+ 才完整支持 TLS 1.3
第五关:到期与自动续期
openssl x509 -in fullchain.crt -noout -checkend 2592000
# 30 天内到期返回退出码 1 并输出 certificate will expire
certbot renew --dry-run # certbot 2.11.0,验证钩子能否执行
systemctl reload nginx # 续期后必须 reload,否则内存里仍是旧证书
| 客户端 | 最低验证版本 | 检查点 | 通过标准 |
|---|---|---|---|
| Chrome / Edge | 120+ | 地址栏锁标、SAN 匹配 | 无 NET::ERR_CERT_* |
| Android | 7.0(API 24) | 系统信任链 | 无“证书颁发机构不受信任” |
| Java 客户端 | 8u301 / 11.0.12+ | cacerts 是否含中间 CA | 握手成功、无 PKIX 异常 |
| SSLLabs | 在线扫描 | 协议、套件、HSTS | A/A+,无 SSLv3、TLS 1.0/1.1 |
据 Let’s Encrypt 文档,HSTS 首次上线建议 max-age=300,稳定后逐级加到 31536000;一旦提交预加载列表(hstspreload.org)就无法快速回退。据 RFC 6797,浏览器对 HSTS 头只在 HTTPS 响应中生效,HTTP 下发的会被忽略。最后留档:openssl x509 -in fullchain.crt -noout -serial -enddate,把验收时间、序列号与 notAfter 记进变更单——下次续期前比对,能立刻发现证书是否被换错。这也是 SSL 证书购买怎么配置闭环的最后一环。
Nginx只需fullchain.crt与example.com.key两个文件,ssl_certificate指fullchain、ssl_certificate_key指私钥;Apache 2.4.58用SSLCertificateFile指fullchain、SSLCertificateKeyFile指私钥;IIS 10导入PFX。CSR、根证书和ZIP压缩包不要上传到Web目录。
先看交付包是否含private.key或PFX;若只有PFX,用openssl pkcs12 -in cert.pfx -nocerts -nodes -out key.pem导出私钥,再用openssl pkey -in key.pem -pubout与证书公钥比对。都没有就重新生成CSR并重签,不能凭证书反推私钥。
*.example.com只匹配a.example.com这类子域,不匹配example.com。用openssl x509 -in fullchain.crt -noout -ext subjectAltName确认SAN;购买时把example.com加入SAN,或为根域单独部署一张证书并在Nginx增加server_name。
配置入口基本一致,都是fullchain+私钥;区别在签发验证、有效期和续期方式。Let's Encrypt有效期90天,用certbot renew –dry-run自动续期;商业DV常见1年,OV需1-3个工作日组织验证,到期前30天手动续期并替换fullchain。
先确认文件是PEM且首行为—–BEGIN CERTIFICATE—–,用file fullchain.crt和head -1检查;若为DER或压缩包,解压或执行openssl x509 -inform DER转换。再检查nginx.conf路径是否写错、权限是否可读,nginx -t通过后再reload。
多数是服务端链不完整,Java默认不自动补中间证书。把Nginx的ssl_certificate改为fullchain、Apache的SSLCertificateFile改为fullchain;若客户端使用独立truststore,还需用keytool把中间CA导入cacerts。
证书有效期从签发时间开始算,DV常见1年、OV常见1年,越早配置剩余有效期越长。建议签发后7天内上线,并在notAfter前30天完成续期;用openssl x509 -noout -dates记录起止时间,纳入监控。
本文由 sslgood.com 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。