App 后端接口 SSL 证书配置实战:Nginx/OpenSSL 参数、选型对比与报错排查
App 后端接口应使用受信任 CA 签发的 DV/OV 证书,Nginx 配置 fullchain.pem 并启用 TLSv1.2/TLSv1.3,再用 openssl s_client -connect api.example.com:443 -servername api.example.com 验证 Verify return code: 0 (ok)。 证书成本:Let's Encrypt DV 免费、90 天自动续期;单域名 DV 约 0-300 元/年,OV 约 800-3000 元/年,通配符 DV 约 500-2000 元/年。 Nginx 1.18+ 关键参数:ssl_protocols TLSv1.2 TLSv1.3; ssl_session_cache shared:SSL:10m; ssl_session_timeout 1d; ssl_certificate 指向 fullchain.pem 而非单证书。 App 端 certificate verify failed 多数是中间证书缺失:用 openssl s_client -showcerts 检查链,fullchain.pem 顺序为服务器证书→中间 CA。 验证命令:curl -I --tlsv1.2 --tls-max 1.2 https://api.example.com/health 返回 200;nmap --script ssl-enum-ciphers -p 443 api.example.com 确认未开 TLS1.0/1.1。
为什么 App 后端接口会报 SSL 证书错误?根因有哪些?
排查 App 后端接口 SSL 证书错误时,先别急着换证书——90% 的报错能归到下面六类根因之一。下面每条都给出可直接复制的定位命令。
1. 证书链不完整(最常见)。Nginx 的 ssl_certificate 只配了 leaf 证书,没拼中间 CA。Android 7+ 的 OkHttp 走系统信任库校验,会直接抛 CertPathValidatorException: Trust anchor for certification path not found;而浏览器/curl 常能自动补链,所以“浏览器正常、App 报错”是典型特征。据 Let’s Encrypt 文档,fullchain.pem 必须按“服务器证书 → 中间 CA”顺序拼接。
# 1) 验证 leaf 是否由 fullchain 中的中间 CA 签发(期望输出 api.crt: OK)
openssl verify -CAfile fullchain.pem api.crt
# 2) 更贴近 App 的校验路径:系统根库 + 只含中间 CA 的 chain.pem
openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt -untrusted chain.pem api.crt
# 3) 确认顺序:第一张必须是域名证书,共 2 张(leaf + 中间 CA)
openssl crl2pkcs7 -nocrl -certfile fullchain.pem | openssl pkcs7 -print_certs -noout
2. 域名 / SAN 不匹配。App 请求 https://api.example.com,证书 SAN 里只有 example.com 和 www.example.com,握手后主机名校验失败。注意通配符 *.example.com 只覆盖一级子域,不覆盖 api.dev.example.com。
openssl x509 -in fullchain.pem -noout -text | grep -A1 'Subject Alternative Name'
3. 协议版本过旧。据 RFC 8996(2021 年 3 月),TLS 1.0/1.1 已正式废弃;Android 10+ 与 iOS 13+ 默认禁用。Nginx 1.23.4 之前 ssl_protocols 默认值含 TLSv1,必须显式覆盖。
# /etc/nginx/conf.d/api.conf —— 适用 nginx 1.23.4+
server {
listen 443 ssl;
http2 on; # nginx < 1.25.1 写作 listen 443 ssl http2;
server_name api.example.com;
ssl_certificate /etc/nginx/ssl/fullchain.pem; # 关键:指向 fullchain 而非 api.crt
ssl_certificate_key /etc/nginx/ssl/api.key;
ssl_protocols TLSv1.2 TLSv1.3; # 默认值 1.23.4 起为 TLSv1.2 TLSv1.3
ssl_ciphers HIGH:!aNULL:!MD5; # 默认值,可按 Mozilla 中间兼容档收紧
}
# 探测服务端是否仍开 TLS1.1:能握手成功说明配置未生效
openssl s_client -connect api.example.com:443 -servername api.example.com -tls1_1 </dev/null
4. 根证书与系统时间。2021 年 9 月 DST Root CA X3 过期,导致大量 Android 7.1 以下设备对 Let’s Encrypt ISRG Root X1 的交叉签名链校验失败,报 certificate expired。App 后端接口 SSL 证书本身没过期,也可能因设备时间偏差报 not yet valid。
date -u # 与证书有效期对比
openssl x509 -in fullchain.pem -noout -dates
timedatectl status | grep -i synchronized # systemd 系统
chronyc tracking # chrony 系统
5. 链路中间有 CDN / SLB。TLS 在 SLB 终止、回源走 HTTP,若 App 直连源站域名而源站没配证书,或 SLB 上证书未随续签更新,就会只在部分入口报错。检查 DNS CNAME、SLB 443 监听绑定的证书 ID、回源协议是否为 HTTPS。
dig +short api.example.com CNAME
curl -sSv https://api.example.com/health 2>&1 | grep -E 'subject:|issuer:|expire'
6. 生产环境用自签证书。Android 7+ 发布版不信任用户安装的 CA,iOS ATS 还强制 TLS 1.2+ 与 SHA-256。自签只应出现在 debug:Android 用 network_security_config 的 <debug-overrides> 覆盖,生产必须换公共 CA 签发。
| App 端报错 / 现象 | 根因 | 一条命令定位 |
|---|---|---|
Trust anchor for certification path not found |
缺中间证书 | openssl verify -CAfile fullchain.pem api.crt |
Hostname ... not verified |
SAN 不含该域名 | openssl x509 -in fullchain.pem -noout -text | grep -A1 'Subject Alternative Name' |
SSL handshake aborted |
服务端仅 TLS1.0/1.1 | openssl s_client -tls1_1 -connect ... |
certificate expired |
时间偏差 / 根证书过期 | date -u + openssl x509 -noout -dates |
| 仅部分机型或地区复现 | SLB 证书未更新 / 回源 HTTP | dig +short ... CNAME + curl -sv |
从申请到上线:App 后端接口 SSL 证书的完整实操步骤
本节按”盘点→选 CA→验证→合并链→部署→灰度”六步走完,每一步都给可直接粘贴的命令。据 Let’s Encrypt 官方文档,证书有效期 90 天、续期建议在剩余 30 天内完成,这是整条流水线的时间基线。
步骤 1:先盘点域名,再决定证书形态。把 App 内所有 API 入口列全:api.example.com、gateway.example.com、upload.example.com、ws.example.com。据 RFC 6125,单域名证书只匹配 1 个 FQDN;通配符 *.example.com 只覆盖一级子域,a.b.example.com 不被匹配。生成 CSR(OpenSSL 1.1.1 / 3.x 通用):
# -nodes 表示私钥不加密,便于 Nginx 自动加载;-subj 避免交互式输入
openssl req -new -newkey rsa:2048 -nodes
-keyout api.key -out api.csr
-subj '/CN=api.example.com'
# 校验 CSR 内容
openssl req -in api.csr -noout -subject -text | head -20
步骤 2:选 CA 与验证级别。测试/内部环境用 Let’s Encrypt(certbot 2.6+ 或 acme.sh 3.0+,90 天有效,可自动续期);生产对外按合规要求选 DV 或 OV:
| 类型 | 价格区间 | 签发时长 | 所需材料 | 适用场景 |
|---|---|---|---|---|
| Let’s Encrypt DV | 免费 | 1–2 分钟 | 域名控制权 | 测试、内部、中小生产 |
| 商业 DV | 0–300 元/年 | 约 10 分钟 | 域名控制权 | 对外 App 接口 |
| OV | 800–3000 元/年 | 1–3 个工作日 | 营业执照 + 法人核验 | 金融、政企、应用商店合规 |
步骤 3:完成域名验证。DNS-01 在域名商添加 TXT 记录 _acme-challenge.api.example.com,TTL 设 60–300 秒(据 RFC 8555,CA 会轮询多次,TTL 过大会拖慢签发):
dig TXT _acme-challenge.api.example.com +short # 应返回 "校验值"
# 用 certbot 走 DNS-01(手动模式,适合没有 API 权限的域名商)
certbot certonly --manual --preferred-challenges dns -d api.example.com
HTTP-01 则要求 80 端口可达 /.well-known/acme-challenge/,且该路径不能被 301 强制跳转到 HTTPS,否则校验失败并报 Invalid response from ...: 301。
步骤 4:合并证书链。CA 一般直接给 fullchain.pem 与 privkey.pem;若只给了 api.crt 和 intermediate.crt,必须按”服务器证书在前、中间证书在后”的顺序拼接(根证书不要放进去):
cat api.crt intermediate.crt > fullchain.pem
# 用系统根证书库验证整条链
openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt fullchain.pem
# 期望输出:fullchain.pem: OK
步骤 5:部署与重载。文件放 /etc/nginx/ssl/,私钥权限收紧:
chmod 600 /etc/nginx/ssl/privkey.pem
chown root:root /etc/nginx/ssl/privkey.pem
# nginx.conf 的 server 块内(Nginx 1.20+ 语法一致)
# ssl_certificate /etc/nginx/ssl/fullchain.pem; # 必须是全链
# ssl_certificate_key /etc/nginx/ssl/privkey.pem;
nginx -t && systemctl reload nginx
注意 ssl_certificate 指向的应是 fullchain.pem 而非单证书,否则 Android 7 以下与部分 Java 客户端会报 unable to get local issuer certificate。
步骤 6:灰度与回滚。先切预发域名或 10% 流量,旧证书保留 7 天。上线后立刻确认实际生效的到期时间:
openssl s_client -connect api.example.com:443
-servername api.example.com -showcerts </dev/null 2>/dev/null
| openssl x509 -noout -dates -subject
# 输出示例:notBefore=... / notAfter=...(应与新证书一致)
随后观察 30 分钟 App 崩溃率与 5xx 比例;若握手失败率上升,把 Nginx 配置回退到旧 fullchain.pem 并 systemctl reload nginx 即可,无需重启进程。这一步是 app 后端接口 SSL 证书上线风险最低的保障手段,建议写进发布 checklist。
Nginx 与 OpenSSL 具体怎么配?给出可复制的命令和参数
Q:Nginx 上一份能直接抄的配置长什么样?
下面这段在 nginx 1.18.0(CentOS/RHEL 8 自带)与 1.24.0(Debian 12 / 官方 stable)上均可用,前提是编译所用 OpenSSL ≥ 1.1.1,否则 ssl_protocols 里写 TLSv1.3 会直接启动失败。
# /etc/nginx/conf.d/api.conf
server {
listen 443 ssl; # nginx ≥1.25.1 可写 listen 443 ssl; http2 on;
http2 on; # 1.18/1.24 请改用 listen 443 ssl http2;
server_name api.example.com;
ssl_certificate /etc/nginx/ssl/fullchain.pem; # leaf 在前、中间证书在后,顺序反了部分安卓机报 chain 错误
ssl_certificate_key /etc/nginx/ssl/api.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; # 默认 off;开启反而让移动端多耗电
ssl_session_cache shared:SSL:10m; # 默认 none,10m 约存 4 万条会话
ssl_session_timeout 1d; # 默认 5m
ssl_session_tickets off; # 默认 on,关闭便于轮换 ticket key
# TLS1.3 套件由 OpenSSL 管,ssl_ciphers 对它无效(nginx ≥1.19.4 才支持该指令)
# ssl_conf_command Ciphersuites TLS_AES_128_GCM_SHA256:TLS_CHACHA20_POLY1305_SHA256;
}
这是 app 后端接口 SSL 证书最容易踩的坑:很多人把 CHACHA20 写进 ssl_ciphers 就以为覆盖了 TLS1.3,实际握手仍由 OpenSSL 的默认套件列表决定,据 OpenSSL 官方文档 Ciphersuites 才是 TLS1.3 的入口。
Q:RSA 还是 ECDSA?密钥和 CSR 怎么生成?
openssl genrsa -out api.key 2048 # RSA 2048,兼容性最广
openssl ecparam -genkey -name prime256v1 -out api.key # ECDSA P-256,握手更快
openssl req -new -key api.key -out api.csr -subj "/CN=api.example.com"
| 维度 | RSA 2048 | ECDSA P-256 |
|---|---|---|
| 握手体积 | 约 1.2 KB 签名 | 约 0.3 KB,弱网首包更快 |
| 服务端 CPU | 基准 1.0 | 约 0.1–0.2 |
| 兼容性 | 全平台 | Android 5.0+/iOS 9+ 起可用 |
| 建议 | 老客户端兜底,双证书并存 | 主力证书(Let’s Encrypt 已支持) |
Q:OpenSSL 3.0 下老客户端握手失败怎么办?
OpenSSL 3.0 把默认安全级别提到 2(@SECLEVEL=2),低于 112 bit 强度的算法直接拒绝。若线上还有 Android 4.x 或旧 JDK,可临时追加 :@SECLEVEL=1 到 ssl_ciphers 末尾,但它会放行 1024 位 RSA 与 SHA1 签名,只应作为过渡,问题定位后立刻移除。
Q:配完怎么验证链和协议版本?
# 看证书链:应出现 leaf + 1~2 个 intermediate
openssl s_client -connect api.example.com:443 -servername api.example.com -showcerts /dev/null
| grep -E 'Certificate chain|s:|i:'
# 期望输出形如:
# Certificate chain
# 0 s:CN=api.example.com
# i:C=US, O=Let's Encrypt, CN=R3
# 1 s:C=US, O=Let's Encrypt, CN=R3
# i:C=US, O=Internet Security Research Group, CN=ISRG Root X1
# 强制走 TLS1.2,返回 "Protocol : TLSv1.2" 即正常
openssl s_client -connect api.example.com:443 -tls1_2 -servername api.example.com /dev/null | grep Protocol
Q:OCSP Stapling 怎么开、怎么确认生效?
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; # 默认无 resolver,不配则 stapling 静默失效
# 验证:输出 OCSP Response Status: successful (0x0) 才算成功
openssl s_client -connect api.example.com:443 -servername api.example.com -status /dev/null
| grep 'OCSP Response Status'
若 nginx -t 报 "ssl_stapling" ignored, issuer certificate not found,说明 fullchain.pem 里漏了中间证书,补齐即可。
Q:客户端(Java / Go)侧要配什么?
// Go 1.20+:显式锁下限,避免继承过时默认值
srv := &http.Server{Addr: ":8443", TLSConfig: &tls.Config{MinVersion: tls.VersionTLS12}}
// Java 11+ 默认已启用 TLS1.2/1.3,无需额外代码
// OkHttp 4.12 默认走系统 TrustManager,不要自建信任所有证书的 SSLSocketFactory
InsecureSkipVerify = true(Go)或自签 TrustManager(Java)只能出现在 debug 构建里,靠 build tag / 变体隔离,绝不能进生产包——这正是 app 后端接口 SSL 证书被中间人抓包的头号原因。
Q:HSTS 能不能一步到位写一年?
不建议。先短后长:
add_header Strict-Transport-Security 'max-age=300; includeSubDomains' always;
# 观察 24 小时无异常后改为:
# add_header Strict-Transport-Security 'max-age=31536000; includeSubDomains' always;
HSTS 一旦下发,浏览器在 max-age 内强制 HTTPS 且用户无法点“继续访问”;includeSubDomains 会连带覆盖所有子域,上线前必须确认每个子域都有有效证书,否则整片子域直接不可访问。
DV、OV、通配符和免费证书怎么选?参数对比表
Q:App 后端接口的证书,DV、OV、通配符、免费证书到底怎么选?
先看一张覆盖价格与限制的对比表(价格为中国区代理商 2024–2025 年常见报价区间,仅作选型参考,非官方定价):
| 类型 | 价格区间 | 签发时长 | 覆盖范围 | 验证方式 | 典型用途 |
|---|---|---|---|---|---|
| Let’s Encrypt DV(免费) | 0 元 | 1–3 分钟 | 单域名或通配符(通配符须 DNS-01) | 域名控制权 | 绝大多数 App 后端 API 入口 |
| 付费单域名 DV | 0–300 元/年 | 10 分钟内 | 1 个 FQDN | DNS-01 / HTTP-01 / 文件验证 | 需要发票、SLA 或商业支持 |
| OV 单域名 | 800–3000 元/年 | 1–3 个工作日 | 1 个 FQDN | 组织验证 + 域名验证 | 金融、政企、需展示企业主体 |
| 通配符 DV | 500–2000 元/年 | 10 分钟 | *.example.com | DNS-01 | 多子域 API(api、gw、open…) |
| 多域名 SAN | 1000–5000 元/年 | 1–3 个工作日 | 5–100 个域名 | 取决于 DV 还是 OV | 多品牌、多租户后端 |
| EV | 1500–6000 元/年 | 3–7 个工作日 | 1 个 FQDN | 强组织验证 | 合规要求明确指定时 |
Q:DV 和 OV 的验证流程差在哪?
DV 只验证“你能控制这个域名”,三条路径任选:DNS-01(加 TXT 记录)、HTTP-01(放 /.well-known/acme-challenge/ 文件)、文件验证。OV 在此之上还要提交营业执照、经办人信息,并接受 CA 电话回访或提供邓白氏(D-U-N-S)编码,这就是它要 1–3 个工作日的原因。据 Let’s Encrypt 官方文档,该 CA 只签发 DV,不提供 OV/EV;因此如果合规部门要求 OV,免费方案无法替代。
Q:有效期和密钥算法该怎么定?
CA/Browser Forum Baseline Requirements 自 2020-09-01 起将公开信任证书有效期上限定为 398 天(此前为 825 天),Let’s Encrypt 则固定 90 天。付费 DV 虽常卖 1–3 年,实际单张证书仍受 398 天约束,到期需重签。算法上建议 ECDSA P-256 与 RSA 2048 双证书并存:Nginx 1.11.0+ 允许重复写 ssl_certificate,按客户端能力自动协商,兼顾老 Android 与 IoT 设备。
# /etc/nginx/conf.d/api.conf
# 适用:Nginx 1.11.0+(1.11.0 起支持多张 ssl_certificate 自动协商)
server {
listen 443 ssl http2;
server_name api.example.com;
# 首选 ECDSA P-256,握手更省 CPU
ssl_certificate /etc/nginx/ssl/api.ecdsa.fullchain.pem;
ssl_certificate_key /etc/nginx/ssl/api.ecdsa.key;
# 兜底 RSA 2048,覆盖不支持 ECDSA 的旧客户端
ssl_certificate /etc/nginx/ssl/api.rsa.fullchain.pem;
ssl_certificate_key /etc/nginx/ssl/api.rsa.key;
ssl_protocols TLSv1.2 TLSv1.3; # 默认值随版本变化,务必显式声明
ssl_ciphers ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256;
}
Q:免费证书省了钱,运维成本怎么控?
靠自动续期。acme.sh 安装时默认写入一条每天 00:00 执行的 cron(crontab -l 可见),配合 --reloadcmd 实现签发即生效:
# 通配符必须走 DNS-01,以 Cloudflare API 为例(dns_cf 插件)
export CF_Token="你的 Cloudflare API Token"
acme.sh --issue -d example.com -d '*.example.com' --dns dns_cf --keylength ec-256
# 安装证书并注册续期后的重载动作(重载命令只在首次执行时记录一次)
acme.sh --install-cert -d example.com --ecc
--key-file /etc/nginx/ssl/api.ecdsa.key
--fullchain-file /etc/nginx/ssl/api.ecdsa.fullchain.pem
--reloadcmd "nginx -t && systemctl reload nginx"
# 手动验证续期链路是否通(不真正签发)
acme.sh --renew -d example.com --ecc --dry-run
OV 证书续期仍需重新组织验证,建议提前 30 天启动,别等到过期前一周。
Q:SAN 数量有什么坑?
多域名证书默认只含 1 个 FQDN,每增加一个 SAN 约 50–200 元/年。更常见的坑是通配符:*.example.com 不覆盖二级子域,api.dev.example.com 必须单独加入 SAN,否则客户端会直接报 NET::ERR_CERT_COMMON_NAME_INVALID(Chrome/Android WebView 常见)或 OpenSSL 的 verify error:num=62:hostname mismatch。选型结论:app后端接口ssl证书 的加密与信任需求,DV 单域名或通配符已经完全够用;只有需要对外展示组织主体(金融、政企招投标)才值得为 OV 付溢价。EV 在 Chrome 与 Safari 早已不展示组织名(据 CA/Browser Forum 与各浏览器厂商公告),预算有限时不必为“绿色地址栏”买单。证书链与 OCSP、HSTS 等配置细节,可结合 Mozilla Server Side TLS 推荐配置一并落地。
App 端常见 SSL 报错怎么排查?真实错误信息对照
同一张证书,iOS 能过、Android 报 PKIX path building failed,问题通常不在证书本身,而在”服务端发了什么、客户端信什么”。先按报错原文定位层级,再逐条验证:
| 报错原文(客户端/服务端) | 出错层 | 根因 | 一条命令定位 |
|---|---|---|---|
| PKIX path building failed / unable to get local issuer certificate | 证书链 | 缺中间证书 | openssl s_client -showcerts |
| Trust anchor for certification path not found | 客户端信任库 | Android 7+ 不信任用户 CA | 查 network_security_config.xml |
| NSURLErrorDomain Code=-1202 | ATS/域名 | 域名不匹配、自签、链不全 | nscurl --ats-diagnostics |
SSL_CTX_use_PrivateKey_file ... key values mismatch |
Nginx 启动 | 证书与私钥不配对 | openssl x509/rsa -modulus |
certificate has expired or is not yet valid |
有效期 | 过期或本机时间偏差 | openssl x509 -dates + date -u |
问:Android 报 PKIX path building failed,怎么确认是缺中间证书?
据 Let’s Encrypt 文档,其签发的证书必须随附中间证书 R3/E1 一并下发,否则 JSSE 的 PKIX 校验器无法构建到根 CA 的路径。检查(OpenSSL 1.1.1 / 3.x 均可用):
# 输出链上每张证书的 subject;正常应有 2 行及以上(叶子 + 中间)
openssl s_client -connect api.example.com:443 -servername api.example.com
-showcerts /dev/null | grep -E '^ *[0-9]+ s:'
只有一行即为断链。修复只需让 Nginx 指向拼接好的 fullchain.pem(叶子在前、中间在后,顺序颠倒同样报错):
server {
listen 443 ssl;
server_name api.example.com;
# 关键:fullchain.pem = 域名证书 + 中间证书,不要只写 cert.pem
ssl_certificate /etc/nginx/ssl/fullchain.pem;
ssl_certificate_key /etc/nginx/ssl/privkey.pem;
}
# 校验并热加载,不中断现有连接
nginx -t && nginx -s reload
问:OkHttp 报 Trust anchor for certification path not found,但浏览器正常?
Android 7.0(API 24)起默认只信任系统 CA,不信任用户手动安装的 CA——这是 app 后端接口 SSL 证书必须走公共 CA 的根本原因。debug 包才用配置文件放行:
<!-- app/src/debug/res/xml/network_security_config.xml,仅放在 debug 变体目录 -->
<network-security-config>
<debug-overrides>
<trust-anchors>
<certificates src="user"/> <!-- 信任用户安装的 CA,仅 debug 生效 -->
<certificates src="system"/>
</trust-anchors>
</debug-overrides>
</network-security-config>
问:curl: (60) unable to get local issuer certificate 是不是服务端的问题?
先排除客户端:curl -V 看链接的 OpenSSL 版本与 CA 路径,再升级 CA 包。Debian/Ubuntu 用 apt-get update && apt-get install --only-upgrade ca-certificates,CentOS/RHEL 用 yum update ca-certificates。升级后仍报错,再回到上一条的 s_client 查链。
问:iOS 报 -1202 The certificate for this server is invalid 怎么查?
Apple 的 ATS 要求 TLS 1.2 及以上、SHA-256 签名、RSA 至少 2048 位(ECC 至少 256 位)。用系统自带工具逐项诊断:
nscurl --ats-diagnostics https://api.example.com
# 输出中 "Result : PASS" 的组合即为当前 ATS 可接受的配置,FAIL 项会附带原因
问:Nginx 启动报 key values mismatch,怎么确认证书和私钥是一对?
# 两条命令输出的 MD5 必须完全一致
openssl x509 -noout -modulus -in /etc/nginx/ssl/fullchain.pem | openssl md5
openssl rsa -noout -modulus -in /etc/nginx/ssl/privkey.pem | openssl md5
问:报 certificate has expired or is not yet valid,证书没过期也报?
date -u # 对比 UTC 时间是否准确
timedatectl status # 看 System clock synchronized: yes
openssl x509 -noout -dates -in /etc/nginx/ssl/fullchain.pem # notBefore / notAfter
容器或嵌入式设备时钟漂移、未启 NTP 时,即便证书有效也会被判为”尚未生效”。续期后务必 nginx -s reload,否则 Nginx 仍持有旧证书的内存副本——这是 app 后端接口 SSL 证书续期后”明明换了却没生效”的最常见原因。
怎么确认配置生效?6 个验证命令与检查点
把证书装上、Nginx reload 成功,并不等于app后端接口ssl证书就真的生效了——reload 只证明配置语法通过,不证明链完整、协议正确、SNI 命中。下面 6 个检查点按”从外到内”的顺序执行,任何一个失败都别急着上线。
检查点 1:curl 能不能用 TLS 1.2 / 1.3 各握手一次?这是最快的黑盒验证,前提是 curl ≥ 7.54(低于此版本没有 --tls-max)。
# 强制只用 TLS1.2,看 HTTP 状态码;-I 只取响应头,避免拉全量 body
curl -I --tlsv1.2 --tls-max 1.2 https://api.example.com/health
# 期望首行:HTTP/2 200 或 HTTP/1.1 200
# 强制 TLS1.3,验证服务端确实开了 1.3(Nginx 需 OpenSSL 1.1.1+ 且 ssl_protocols 含 TLSv1.3)
curl -I --tlsv1.3 https://api.example.com/health
# -v 看协商细节,关键行:SSL connection using TLSv1.3 / AEAD-AES128-GCM-SHA256
curl -v --tlsv1.3 https://api.example.com/health 2>&1 | grep -i 'SSL connection'
若 TLS1.2 报 sslv3 alert handshake failure,多半是 Nginx 的 ssl_ciphers 把 1.2 套件配成了仅 1.3 可用;注意 Nginx 1.23.4 起 ssl_protocols 默认值才改为 TLSv1.2 TLSv1.3,更早版本默认含 TLSv1/1.1,必须显式收紧。
检查点 2:证书链是否完整?这是生产环境最高频的问题,尤其在只配了 ssl_certificate 叶子证书、漏配中间证书时。
# 用系统根库校验;Debian/Ubuntu 路径为 /etc/ssl/certs/ca-certificates.crt
# RHEL/CentOS 为 /etc/pki/tls/certs/ca-bundle.crt;macOS 可用 /etc/ssl/cert.pem
openssl s_client -connect api.example.com:443
-servername api.example.com
-CAfile /etc/ssl/certs/ca-certificates.crt </dev/null
# 通过标准(输出末尾):
# Verify return code: 0 (ok)
# 失败典型:Verify return code: 20 (unable to get local issuer certificate) → 链不完整
# Verify return code: 10 (certificate has expired) → 已过期
返回 20 时,把中间证书按”叶子在前、中间在后”的顺序拼进 ssl_certificate 指向的 fullchain 文件即可;Let’s Encrypt 文档明确要求使用 fullchain.pem 而非 cert.pem。
检查点 3:证书里的 CN/SAN 和有效期对不对?
# 取服务端实际下发的证书并解析;-showcerts 会打印整条链
openssl s_client -connect api.example.com:443 -servername api.example.com -showcerts </dev/null 2>/dev/null
| openssl x509 -noout -subject -issuer -dates -ext subjectAltName
# 单独判断剩余有效期是否 > 30 天(2592000 秒),返回 0 表示未临近过期
openssl s_client -connect api.example.com:443 -servername api.example.com </dev/null 2>/dev/null
| openssl x509 -noout -checkend 2592000
重点看 subjectAltName 是否覆盖 App 实际请求的域名(Android 7+ 与 iOS 均已忽略 CN,只看 SAN),以及 notAfter 是否比当前时间多 30 天以上——短于 30 天就该安排续期了。
检查点 4:还残留 TLS 1.0/1.1 或弱套件吗?
# nmap 7.x + ssl-enum-ciphers 脚本,会逐个列出协议与套件及强度等级
nmap --script ssl-enum-ciphers -p 443 api.example.com
# sslyze 5.x(--regular 已废弃,改用 mozilla 配置档)
python -m sslyze --mozilla_config=intermediate api.example.com:443
通过标准:输出中只应出现 TLSv1.2 / TLSv1.3,TLSv1.0、TLSv1.1 应标注为 disabled,且不出现 3DES、RC4、CBC 类套件。
检查点 5:第三方评分作为交叉验证。浏览器打开 https://www.ssllabs.com/ssltest/analyze.html?d=api.example.com,Overall Rating 应为 A 或 A+,Chain issues 必须为 None;也可用 API 免交互获取:curl "https://api.ssllabs.com/api/v3/analyze?host=api.example.com&all=done"。提醒一句:HSTS 预加载列表(hstspreload.org)不要随手提交,一旦进入 Chrome 内置列表,回滚要等数月且需逐个版本下发。
检查点 6:App 端到底报了什么?服务端全绿但 App 仍失败时,问题往往在客户端信任库或 SNI。
# Android:过滤 OkHttp / 系统 SSL 栈日志
adb logcat | grep -iE 'ssl|okhttp|certificate'
# iOS:用 Console.app 选中真机,过滤 NSURLError / TrustKit 相关关键字
# 抓包定位握手阶段(需 root/管理员权限)
tcpdump -i any port 443 -w api.pcap
在 Wireshark 里看 Client Hello 的 SNI 字段是否与证书 SAN 一致(不一致会拿到默认站点证书,直接 SSL_ERROR_BAD_CERT_DOMAIN),再看 Server Hello 之后是否下发了完整链。iOS 的 ATS 还要求 TLS 1.2+ 与 ECDHE 套件,配置过老会直接抛 NSURLErrorSecureConnectionFailed (-1200)。
| 检查点 | 核心命令 | 通过标准 | 失败典型输出 |
|---|---|---|---|
| 协议可用性 | curl -I --tlsv1.3 |
HTTP/2 200 | sslv3 alert handshake failure |
| 证书链 | openssl s_client -CAfile … |
Verify return code: 0 | code 20 / 10 / 21 |
| 有效期与 SAN | openssl x509 -checkend 2592000 |
返回 0,SAN 覆盖域名 | certificate has expired |
| 协议/套件 | nmap --script ssl-enum-ciphers |
仅 TLSv1.2/1.3 | 出现 TLSv1.0 enabled |
| 在线评分 | SSL Labs | A/A+,Chain issues: None | B(弱套件)/ T(不受信) |
| 客户端 | adb logcat / Console.app |
无 SSL 相关错误 | -1200、CERTIFICATE_UNKNOWN |
顺序建议:先用检查点 1、2 判断”能不能通”,再用 3、4、5 判断”配置是否合规”,最后用 6 定位”为什么只有 App 不通”。这套流程同样适用于排查 app后端接口ssl证书 续期后客户端仍报旧证书的情况——多数是 CDN 或前置 LB 未同步热加载 fullchain。
不一定。DV 证书能完成域名验证与加密,浏览器/App 信任链正常,适合大多数 API 入口;OV 增加组织验证,适合金融、政企或合规要求,价格约 800-3000 元/年,签发 1-3 个工作日。
可以。Let's Encrypt 证书 90 天有效,用 acme.sh 或 certbot 自动续期即可;但 Android 7.1 以下设备对 ISRG Root X1 的信任依赖交叉签名,老客户端需评估或升级。
先执行 openssl s_client -connect api.example.com:443 -servername api.example.com -showcerts 看是否返回完整链,再检查 SAN 与系统时间;OkHttp 打开 HttpLoggingInterceptor,Android 仅在 debug 的 network_security_config 中信任用户 CA。
不能。*.example.com 只匹配一级子域,api.dev.example.com 属于二级子域,需要单独 SAN 或多域名证书;通配符 DV 常见价格 500-2000 元/年。
常见。CDN 或 SLB 可能只在前端终止 TLS、回源走 HTTP,或 443 监听仍挂旧证书;检查 DNS CNAME、SLB 证书 ID、回源协议 HTTPS,并用 openssl s_client -connect 源站 IP:443 -servername 域名 对比。
可以开,但先用 max-age=300 测试 24 小时,再逐步提高到 31536000;HSTS 一旦下发,浏览器在有效期内强制 HTTPS,includeSubDomains 要确认所有子域都有证书。App 原生请求不读 HSTS,WebView 会。
建议同时开。Nginx 1.18+ 配 ssl_protocols TLSv1.2 TLSv1.3;TLS1.3 握手 1-RTT、默认前向保密,TLS1.2 兼容 Android 5/6 等老客户端。用 openssl s_client -tls1_2 和 -tls1_3 分别验证。
本文由 sslgood.com 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。