Sectigo SSL 证书 Kubernetes 部署、续期与排错实战
问题背景与根因
在 Kubernetes 中部署 Sectigo SSL 证书,真正容易出问题的环节通常不是 CA 签发,而是 Secret 类型、键名、证书链、Ingress 引用和控制器缓存。Ingress 通过 kubernetes.io/tls 类型的 Secret 读取 tls.crt 与 tls.key;kubectl create secret tls 会用 --cert 和 --key 生成这两个键。常见根因包括:只上传叶子证书导致链不完整;证书与私钥不匹配;Secret 与 Ingress 不在同一 namespace;secretName 写错;ingress-nginx 未感知 Secret 更新;以及把 Sectigo 商业证书误当成 ACME 证书自动续期。
先做三项检查:openssl x509 -in fullchain.pem -noout -subject -issuer -dates 确认主体、签发者和有效期;openssl rsa -in example.com.key -check -noout 确认私钥可读;kubectl get secret example-com-tls -n prod -o jsonpath='{.type}' 应返回 kubernetes.io/tls。注意公共信任 TLS 证书最长有效期为 398 天,Let’s Encrypt 为 90 天;Sectigo DV 通常分钟级签发,OV 约 1-3 个工作日,EV 约 3-5 个工作日,保障金最高约 50 万美元。证书链不完整时,浏览器可能正常,但 curl、Java、小程序会报 unable to get local issuer certificate。
准备 Sectigo 证书文件与创建 TLS Secret
建议固定目录和文件名,避免把叶子证书当 fullchain。Sectigo 交付包通常包含 example.com.crt、中间 CA 和私钥;部署到 K8s 时合并为 fullchain.pem(叶子证书在前,中间 CA 在后,通常不放根证书),私钥保持 example.com.key。执行:
mkdir -p ~/sectigo/example.com && cd ~/sectigo/example.com
cat example.com.crt intermediate.crt > fullchain.pem
openssl x509 -in fullchain.pem -noout -subject -issuer -dates
openssl rsa -in example.com.key -check -noout
openssl x509 -noout -modulus -in fullchain.pem | openssl md5
openssl rsa -noout -modulus -in example.com.key | openssl md5
kubectl create namespace prod --dry-run=client -o yaml | kubectl apply -f -
kubectl create secret tls example-com-tls --cert=fullchain.pem --key=example.com.key -n prod --dry-run=client -o yaml | kubectl apply -f -
kubectl describe secret example-com-tls -n prod
两条 modulus 的 MD5 必须一致,否则会报 tls: private key does not match public key。Secret 创建后检查类型和键:kubectl get secret example-com-tls -n prod -o yaml,应看到 type: kubernetes.io/tls、tls.crt、tls.key。更新证书时不要直接 edit Secret,使用 --dry-run=client -o yaml | kubectl apply -f - 滚动替换,避免 base64 手工编码出错。若报 error: failed to find any PEM data in certificate input,优先检查 --cert 是否指向了空文件、DER 格式或加密私钥。
Ingress 引用 Secret 与 TLS 终止配置
Ingress 只能引用同 namespace 的 TLS Secret,跨 namespace 需要复制 Secret 或在对应 namespace 重新创建。以下示例把 TLS 终止放在 ingress-nginx,后端 Service 仍走 HTTP 80:
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
name: example-ingress
namespace: prod
annotations:
nginx.ingress.kubernetes.io/ssl-redirect: 'true'
nginx.ingress.kubernetes.io/force-ssl-redirect: 'true'
spec:
ingressClassName: nginx
tls:
- hosts:
- example.com
secretName: example-com-tls
rules:
- host: example.com
http:
paths:
- path: /
pathType: Prefix
backend:
service:
name: web
port:
number: 80
应用并检查:kubectl apply -f ingress.yaml、kubectl describe ingress example-ingress -n prod、kubectl get ingress -n prod。若使用其他控制器,ingressClassName 要改成对应值;没有 ingressClassName 的旧集群可能依赖默认控制器。TLS 终止后,Ingress 到后端是明文 HTTP,因此不要在 Ingress 上再配置后端 HTTPS 端口,除非后端本身启用了 TLS。Secret 更新后 ingress-nginx 通常会监听并重载,但旧版本或缓存异常时需 kubectl rollout restart deployment/ingress-nginx-controller -n ingress-nginx。验证配置中 secretName 与 Secret 名称、namespace 完全一致。
cert-manager 自动签发与续期(推荐)
cert-manager 能自动管理 ACME 证书,例如 Let’s Encrypt 90 天证书;但 Sectigo 商业 OV/EV 证书通常不是 ACME 自动签发,除非 Sectigo 账户明确提供 ACME directory 或 External Issuer。不要把人工签发的 Sectigo 证书配置成 ACME Issuer 后期待自动续期。若使用 Sectigo ACME,server 必须填控制台提供的 directory URL;若使用 Let’s Encrypt,可用 HTTP-01 示例:
apiVersion: cert-manager.io/v1
kind: ClusterIssuer
metadata:
name: letsencrypt-prod
spec:
acme:
server: https://acme-v02.api.letsencrypt.org/directory
email: ops@example.com
privateKeySecretRef:
name: letsencrypt-prod-account-key
solvers:
- http01:
ingress:
class: nginx
---
apiVersion: cert-manager.io/v1
kind: Certificate
metadata:
name: example-com
namespace: prod
spec:
secretName: example-com-tls
duration: 2160h
renewBefore: 720h
commonName: example.com
dnsNames:
- example.com
issuerRef:
name: letsencrypt-prod
kind: ClusterIssuer
应用后查看:kubectl apply -f issuer-cert.yaml、kubectl get certificate,order,challenge -n prod、kubectl describe certificate example-com -n prod。Ready=True 且 Secret 生成后,Ingress 仍引用 example-com-tls。注意 duration 不能超过 CA 实际签发上限:Let’s Encrypt 固定 90 天,公共 TLS 上限 398 天;renewBefore 建议 720h(30 天)。Sectigo 商业证书若人工续期,则用新 fullchain 和私钥重新执行 Secret 滚动替换,并观察控制器日志。
手动 Secret、cert-manager 与外部 TLS 方案对比
选择方案时重点看证书来源、续期责任和故障边界。Sectigo 商业证书适合需要 OV/EV 品牌信任、保障金和多域名/通配符的场景;Let’s Encrypt 适合可接受 90 天短周期且能自动化的场景。对比如下:
| 方案 | 适用场景 | 签发与续期 | 优点 | 主要风险 |
|---|---|---|---|---|
| 手动创建 TLS Secret | Sectigo DV/OV/EV 人工交付 | 人工更新 fullchain 与私钥,kubectl apply 滚动替换 |
流程直观,证书品牌与类型可控 | 易忘续期;fullchain/私钥配错;无自动监控 |
| cert-manager + ACME | Let’s Encrypt 或 Sectigo ACME(若提供) | 自动签发,90 天或 CA 上限内自动续期 | 自动化程度高,Certificate 状态可观测 | HTTP-01/DNS-01 失败;商业证书未必支持 |
| 外部 TLS 终止 | 云 LB、CDN、API 网关 | 在外部平台上传/托管证书 | K8s 无需管理私钥,卸载 TLS 压力 | 链路分段排查复杂;Ingress 看不到证书 |
如果使用手动 Secret,至少增加证书到期监控;如果使用 cert-manager,关注 Certificate 的 Ready、renewTime 和 Order/Challenge。外部 TLS 终止时,K8s Ingress 可只处理 HTTP,但客户端到 LB 的证书链、SNI 和回源协议要单独验证。不要把“浏览器能打开”当成唯一验收标准,Java、Go、小程序对中间证书更敏感。
常见错误排查(含真实报错)
按“证书文件 → Secret → Ingress → 控制器 → 客户端”顺序排查,常见报错与处理如下:
curl: (60) SSL certificate problem: unable to get local issuer certificate:服务端未发送中间 CA。用openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null查看链,确认 Secret 的tls.crt是 fullchain,不是单张叶子证书。x509: certificate signed by unknown authority:客户端信任库不认根证书,或链不完整。先补中间证书;Java 还需确认 truststore 包含对应根 CA。tls: private key does not match public key:证书与私钥不配对。执行openssl x509 -noout -modulus -in fullchain.pem | openssl md5和openssl rsa -noout -modulus -in example.com.key | openssl md5,两个 MD5 必须一致。error: failed to find any PEM data in certificate input:--cert文件为空、DER 格式或私钥被加密。用openssl x509 -in fullchain.pem -text -noout验证 PEM。local SSL certificate prod/example-com-tls was not found:Ingress 与 Secret 的 namespace/名称不一致,或 Secret 尚未创建。用kubectl get secret -n prod和kubectl describe ingress example-ingress -n prod对照。x509: certificate has expired or is not yet valid:检查openssl x509 -noout -dates -in fullchain.pem与节点时间;续期后未重载控制器时执行kubectl rollout restart deployment/ingress-nginx-controller -n ingress-nginx。- cert-manager 报
Order ... is pending或Challenge ... pending:用kubectl describe challenge -n prod查看 HTTP-01/DNS-01 记录,确认域名解析、80 端口和 Ingress 可达。
排查时同时看控制器日志:kubectl logs -n ingress-nginx deploy/ingress-nginx-controller --tail=100。若日志显示证书已加载但客户端仍旧证书,优先怀疑 DNS 解析到旧 IP、CDN 缓存或负载均衡器未更新。
效果验证与续期监控
部署后不要只看浏览器地址栏。先看 K8s 对象:kubectl get certificate -A 应 Ready=True;kubectl get secret example-com-tls -n prod 应存在;kubectl describe ingress example-ingress -n prod 的 TLS 段应显示正确 Secret。再从集群外验证:
curl -vI https://example.com
echo | openssl s_client -connect example.com:443 -servername example.com -showcerts 2>/dev/null | openssl x509 -noout -subject -issuer -dates
openssl s_client -connect example.com:443 -servername example.com -verify_return_error </dev/null
curl -vI 重点看 SSL certificate verify ok、证书 subject/issuer 和有效期;openssl s_client 确认返回链中包含中间 CA。若 Secret 已更新但输出旧证书,检查 DNS 是否指向旧入口、CDN 是否缓存、Ingress Controller 是否重载。续期监控建议:cert-manager 使用 Certificate 的 renewTime 和 Prometheus 指标 certmanager_certificate_expiration_timestamp_seconds;手动 Secret 用 blackbox_exporter 或脚本每日检查剩余天数,低于 30 天告警。公共 TLS 证书最长 398 天、Let’s Encrypt 90 天,续期窗口不要设置过短。
常见问题
Sectigo 证书在 K8s 中应挂 fullchain 还是叶子证书?应挂 fullchain,即叶子证书加中间 CA,通常不放根证书。创建 Secret 时使用 --cert=fullchain.pem 和 --key=example.com.key;只挂叶子证书会让 curl、Java、小程序报 unable to get local issuer certificate。
Secret 更新后 Ingress 仍返回旧证书怎么办?先确认 Ingress 与 Secret 同 namespace、secretName 一致,再用 openssl s_client 验证。ingress-nginx 通常会监听 Secret 更新,旧版本或缓存异常时执行 kubectl rollout restart deployment/ingress-nginx-controller -n ingress-nginx,并检查 DNS/CDN 是否指向旧入口。
cert-manager 能自动续期 Sectigo 商业证书吗?取决于 Sectigo 是否提供 ACME 或 External Issuer。普通 OV/EV 商业证书通常人工签发,cert-manager 不能凭空续期;若需全自动,可对 Let’s Encrypt 90 天证书使用 ACME,或外部签发后滚动更新 Secret。
公共 TLS 证书最长有效期和续期窗口是多少?公共信任 TLS 证书最长 398 天,Let’s Encrypt 为 90 天。cert-manager 的 duration 不能超过 CA 实际签发上限,renewBefore 建议 720h(30 天);手动 Secret 应监控剩余天数并提前 30 天更新。
报 tls: private key does not match public key 怎么排查?比较证书与私钥模数:openssl x509 -noout -modulus -in fullchain.pem | openssl md5 与 openssl rsa -noout -modulus -in example.com.key | openssl md5,两个 MD5 必须一致;不一致说明私钥不匹配,需重新签发或找回对应私钥。
Ingress 报 secret not found 如何处理?Ingress 只能引用同 namespace 的 TLS Secret。检查 kubectl get secret example-com-tls -n prod,确认名称、namespace、type=kubernetes.io/tls,并确保先创建 Secret 再 apply Ingress;跨 namespace 需在目标 namespace 复制 Secret。