Sectigo SSL 证书 Kubernetes 部署实战:Secret、Ingress 配置与续期全流程
为什么 Sectigo 证书在 Kubernetes 里常常“装上了却不生效”
在 Kubernetes 中部署 Sectigo 证书,本质是把证书链和私钥写入一个 kubernetes.io/tls 类型的 Secret,再由 Ingress 的 spec.tls 引用。命令只有两条,但线上真正卡住的往往不是“创建 Secret”这一步,而是下面四类根因。
- 证书链不完整。Sectigo 签发的服务器证书是三级链:叶子证书 →
Sectigo RSA Domain Validation Secure Server CA(OV 为Sectigo RSA Organization Validation Secure Server CA)→USERTrust RSA Certification Authority根。交付 ZIP 中叶子和中间证书是两个独立文件,很多人只把叶子传给--cert。浏览器能自动补链所以显示正常,curl(部分 CA bundle)、Java、微信小程序、老版本 Android 会直接握手失败。 - 私钥格式不对。
kubectl create secret tls只接受未加密的 PEM 私钥,遇到BEGIN ENCRYPTED PRIVATE KEY会报错退出。 - 命名空间错位。
secretName只在 Ingress 所在命名空间内解析,写错或跨命名空间时 Ingress Controller 会静默回退到默认证书。 - 缓存与热更新。NGINX Ingress Controller 把证书缓存在内存里,Secret 变更后要等 watch 事件触发 reload 才生效;若证书以 volume 方式挂进自建网关,还要叠加 kubelet 约 60 秒的同步周期和进程不自动重载的问题。
还有一个常被忽略的硬性约束:公开信任的 TLS 证书最长有效期已被限制为 398 天,Sectigo 的 DV/OV/EV 都按此上限签发,Let’s Encrypt 只有 90 天。任何“手动传一次就不管”的方案,一年内必然踩到过期告警。
准备证书文件:从 Sectigo 交付包拼出可用的 fullchain.pem
完成域名或组织验证后,Sectigo 控制台下载的 ZIP 通常包含 example_com.crt(叶子证书)、SectigoRSADomainValidationSecureServerCA.crt(中间证书)、AAACertificateServices.crt(根证书)。私钥不在包里,是你在生成 CSR 时自己产生的。合并顺序必须是叶子 → 中间 → 根:
cat example_com.crt SectigoRSADomainValidationSecureServerCA.crt AAACertificateServices.crt > fullchain.pem
# 现代客户端只需要“叶子 + 中间”,根证书可带可不带
grep -c 'BEGIN CERTIFICATE' fullchain.pem # 输出 2 或 3 才算正常
ECC 证书的中间证书叫 Sectigo ECC Domain Validation Secure Server CA,千万别把 RSA 中间证书拼进 ECC 链,否则部分客户端会报 unable to get local issuer certificate。
上线前务必做三项校验:
# 1. 证书主体、签发者、有效期
openssl x509 -in fullchain.pem -noout -subject -issuer -dates
# 2. 证书与私钥是否配对(两个 md5 必须完全一致)
openssl x509 -in fullchain.pem -noout -modulus | openssl md5
openssl rsa -in example.com.key -noout -modulus | openssl md5
# 3. 链路是否可验证
openssl verify -untrusted SectigoRSADomainValidationSecureServerCA.crt -CAfile AAACertificateServices.crt example_com.crt
如果私钥带口令或为 PKCS#8 加密格式,先解密:openssl rsa -in encrypted.key -out example.com.key。确认 BEGIN RSA PRIVATE KEY 或 BEGIN PRIVATE KEY 且无 Proc-Type: 4,ENCRYPTED 头。文件权限建议 chmod 600 example.com.key,并且不要把私钥提交进 Git。
创建 TLS Secret:命令、幂等更新与验证
Secret 必须与 Ingress 在同一命名空间,且必须包含 tls.crt、tls.key 两个键,类型为 kubernetes.io/tls。首次创建:
kubectl create secret tls example-com-tls --cert=fullchain.pem --key=example.com.key -n your-namespace
证书续期或替换时,直接重跑上面的命令会失败并报 error: failed to create secret secrets "example-com-tls" already exists。正确做法是 dry-run 生成 YAML 再 apply,这是幂等更新:
kubectl create secret tls example-com-tls --cert=fullchain.pem --key=example.com.key -n your-namespace --dry-run=client -o yaml | kubectl apply -f -
创建后必须回读验证,而不是只看 kubectl get secret 的 READY 列:
# 查看 Secret 里实际存了几张证书
kubectl get secret example-com-tls -n your-namespace -o go-template='{{index .data "tls.crt"}}' | base64 -d | grep -c 'BEGIN CERTIFICATE'
# 查看实际生效的签发者与到期时间
kubectl get secret example-com-tls -n your-namespace -o go-template='{{index .data "tls.crt"}}' | base64 -d | openssl x509 -noout -subject -issuer -dates
常见坑:用 kubectl create secret generic 手工造 Secret 却忘了 --type=kubernetes.io/tls,Ingress Controller 会忽略它;或者 --cert 传了叶子证书、fullchain.pem 只放在别的目录,导致 grep -c 结果为 1。此时浏览器看起来一切正常,但 Java 客户端、Go 程序、小程序后台会在 TLS 握手阶段直接抛异常,排查成本极高。
Secret 名称建议带上环境前缀(如 prod-example-com-tls),避免多套环境共用集群时误引用测试证书。
完整 Ingress 配置示例(NGINX 与 Traefik 差异)
下面是一份可直接 kubectl apply 的生产级配置,包含强制跳转、TLS 版本限制与 HSTS:
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
name: example-ingress
namespace: your-namespace
annotations:
nginx.ingress.kubernetes.io/ssl-redirect: 'true'
nginx.ingress.kubernetes.io/force-ssl-redirect: 'true'
nginx.ingress.kubernetes.io/ssl-protocols: 'TLSv1.2 TLSv1.3'
nginx.ingress.kubernetes.io/hsts: 'true'
nginx.ingress.kubernetes.io/hsts-max-age: '31536000'
spec:
ingressClassName: nginx
tls:
- hosts:
- example.com
- www.example.com
secretName: example-com-tls
rules:
- host: example.com
http:
paths:
- path: /
pathType: Prefix
backend:
service:
name: web
port:
number: 80
四个要点:第一,tls.hosts 必须覆盖证书 SAN 中的每一个域名,漏写 www.example.com 会导致该域名继续返回默认证书并报 x509: certificate is valid for example.com, not www.example.com。第二,多 Ingress Controller 并存的集群必须显式写 ingressClassName,否则规则会被别的 class 接管,“证书传了但没生效”。第三,force-ssl-redirect 与 ssl-redirect 同时开启,才能覆盖后端返回 301 之外的场景。第四,HSTS 一旦下发就无法撤销,先确认所有子域都能走 HTTPS 再开启,hsts-max-age 建议先用 300 秒验证。
Traefik 的差异在于:spec.tls.secretName 写法一致,但默认证书需要在 TLSStore 资源里单独指定,否则未匹配 host 的请求会落到 Traefik 自签证书。若使用 Ingress 引用 Secret 后仍然返回自签证书,先检查 Controller 的 --default-ssl-certificate 参数。
手动续期与 cert-manager 自动续期的正确姿势
手动方案的核心是“替换 Secret + 让进程重载”。NGINX Ingress Controller 会 watch Secret 变化并自动 reload,通常秒级到 1 分钟内生效;但如果你把证书 volume 挂载到自建网关 Pod,kubelet 同步周期默认约 60 秒,且进程不会自动重载,必须补一条:
kubectl rollout restart deployment/ingress-nginx-controller -n ingress-nginx
# 自建 Nginx 网关:
kubectl exec -it deploy/gateway -- nginx -s reload
cert-manager 走的是 ACME 协议,最常用于 Let’s Encrypt(90 天)以及 ZeroSSL、Google 等公共 ACME 服务。Sectigo 的 DV/OV/EV 商业证书一般通过控制台或经销商 API 交付,不接入公共 ACME 自动签发流程,所以“买 Sectigo + 用 cert-manager 全自动续期”这个组合并不成立,需要自己写 CronJob 调 API 取新证书再 apply。若只是内网或测试域名,可直接用 cert-manager:
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:
ingressClassName: nginx
在 Ingress 上加注解 cert-manager.io/cluster-issuer: letsencrypt-prod,ingress-shim 会自动生成 Certificate 对象,Secret 名沿用你写的 tls.secretName(未写则默认为 <ingress-name>-tls)。cert-manager 默认在证书生命周期的 2/3 处开始续期,可通过 renewBefore 覆盖,例如 398 天的证书设 renewBefore: 720h,90 天的设 renewBefore: 360h。检查状态用 kubectl get certificate,certificaterequest,order,challenge -A,Certificate 的 READY 必须为 True。
三种部署方式横向对比
选型时不要只看“能不能自动续期”,还要看证书类型是否符合合规要求、失败时的影响面有多大。
| 对比维度 | 手动 kubectl Secret | cert-manager(ACME) | External Secrets / 云 ACM 同步 |
|---|---|---|---|
| 证书来源 | Sectigo 及任意 CA | Let’s Encrypt、ZeroSSL 等 ACME | Sectigo 控制台 + Vault / KMS / 云 ACM |
| 单次有效期 | 最长 398 天 | 90 天 | 最长 398 天 |
| 续期方式 | 人工替换 Secret | 全自动,到期前 2/3 触发 | 半自动,依赖定时任务或 webhook |
| 是否支持 Sectigo OV/EV | 支持 | 不支持(非公共 ACME 签发) | 支持 |
| 落地成本 | 两条命令,最低 | 需部署 CRD 与 webhook | 需部署 Operator 并打通密钥平台 |
| 主要风险 | 忘记续期、漏拼中间证书 | 80/443 被占、DNS 校验失败 | 权限过大、密钥泄露面扩大 |
| 适用场景 | 域名少、必须用 OV/EV 的业务 | 大量域名、测试与内部服务 | 多云、已有统一密钥管理平台 |
实践建议:面向公众的品牌站点、支付回调域名用 Sectigo OV/EV(398 天,含组织信息展示与最高约 50 万美元保障),配合 CronJob 做半自动替换;内部服务、灰度域名用 cert-manager + Let’s Encrypt 兜底,两套并存时用不同 ingressClassName 隔离,避免 Secret 互相覆盖。
常见错误排查(含真实报错)
1. error: failed to load key pair: tls: private key does not match public key。证书与私钥不是一对,多见于重新签发后仍使用旧私钥。用前面两条 -modulus | openssl md5 比对,不一致就重新下载私钥或重新签发。
2. curl: (60) SSL certificate problem: unable to get local issuer certificate。链不完整。用 openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | grep -c 'BEGIN CERTIFICATE' 检查,返回 1 说明只下发了叶子证书,重新拼 fullchain 并重建 Secret。
3. javax.net.ssl.SSLHandshakeException: PKIX path building failed: unable to find valid certification path to requested target。与第 2 条同源,Java 不自动补链,必须服务端下发完整链。
4. x509: certificate signed by unknown authority(Go 客户端)。同上,或客户端信任库缺失 USERTrust 根证书。
5. Ingress Controller 日志 local SSL certificate your-namespace/example-com-tls was not found 或 failed to find certificate for host。Secret 名、命名空间拼错,或 Secret 类型不是 kubernetes.io/tls。
6. cert-manager 报 Waiting for HTTP-01 challenge propagation: wrong status code '404', expected '200'。校验路径被 WAF、鉴权中间件或 ssl-redirect 拦截,临时放行 /.well-known/acme-challenge/ 即可。
7. 续期后仍是旧证书。先排除 CDN/负载均衡层缓存,再用 openssl s_client ... | openssl x509 -noout -serial -dates 对比 serial 与 Secret 中的 serial 是否一致,不一致说明 Controller 未 reload 或流量没打到该集群。
效果验证:四条命令确认真的生效
部署完成后不要只看浏览器地址栏的小锁,按下面顺序验证:
# 1. 集群内的证书对象是否正确
kubectl get secret example-com-tls -n your-namespace -o go-template='{{index .data "tls.crt"}}' | base64 -d | openssl x509 -noout -subject -issuer -serial -dates
# 2. cert-manager 场景看签发状态
kubectl get certificate -A
# 3. 从外部看实际下发的证书链
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | openssl x509 -noout -subject -issuer -dates
# 4. 协议与安全头
curl -sI https://example.com | grep -i strict-transport-security
curl -vI https://example.com --tlsv1.2 2>&1 | grep -E 'SSL connection|subject|issuer|expire'
判定标准:第 1、3 步的 serial 完全一致;第 3 步输出的 issuer 含 Sectigo;openssl s_client 的 -showcerts 输出中至少有两段 BEGIN CERTIFICATE;curl 能协商到 TLSv1.2 或 TLSv1.3;响应头出现 Strict-Transport-Security: max-age=31536000。最后用 SSL Labs 做一次完整评级,确认没有弱套件、没有证书透明(CT)缺失告警。若结果全部通过,再清理掉旧的 Secret 副本与本地私钥文件。
常见问题
不能直接实现。cert-manager 依赖 ACME 协议签发,Sectigo 的 DV/OV/EV 商业证书一般在控制台或经销商 API 续签,需自写 CronJob 拉取新证书后用 kubectl create secret tls –dry-run=client -o yaml 管道 apply 替换 Secret。
必须同命名空间。spec.tls.secretName 只在 Ingress 所在命名空间内解析,不能写成 namespace/name。跨命名空间共享证书只能各建一份,或用 Reflector、External Secrets 同步,写错时 Controller 会回退默认证书并记录 not found 日志。
公开信任的证书最长有效期为 398 天,Sectigo 的 DV、OV、EV 均按此上限签发;Let’s Encrypt 免费证书为 90 天。建议在到期前 30 天完成替换,并预留 Ingress Controller 与 CDN 的缓存刷新时间。
因为浏览器会自动补全缺失的中间证书,而 Java truststore、部分 Android 版本、小程序网络库不会。用 grep -c ‘BEGIN CERTIFICATE’ fullchain.pem 检查,正常应为 2;把中间证书拼进 –cert 指定的文件后重建 Secret 即可。
NGINX Ingress Controller 通过 watch 监听 Secret 变化,通常秒级到 1 分钟内完成 reload。以 volume 挂载证书的自建网关受 kubelet 同步周期影响(默认约 60 秒),且进程不自动重载,需执行 kubectl rollout restart 或 nginx -s reload。
不能。*.example.com 只匹配一级子域,如 api.example.com,不匹配 a.b.example.com,也不匹配裸域 example.com。下单时应在 SAN 中同时写入 example.com 和 *.example.com,Ingress 的 tls.hosts 也要逐一列出。