跳到主要内容
Kubernetes

Sectigo SSL 证书 Kubernetes 部署实战:Secret、Ingress 配置与续期全流程

为什么 Sectigo 证书在 Kubernetes 里常常“装上了却不生效”

在 Kubernetes 中部署 Sectigo 证书,本质是把证书链和私钥写入一个 kubernetes.io/tls 类型的 Secret,再由 Ingress 的 spec.tls 引用。命令只有两条,但线上真正卡住的往往不是“创建 Secret”这一步,而是下面四类根因。

  1. 证书链不完整。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 会直接握手失败。
  2. 私钥格式不对。kubectl create secret tls 只接受未加密的 PEM 私钥,遇到 BEGIN ENCRYPTED PRIVATE KEY 会报错退出。
  3. 命名空间错位。secretName 只在 Ingress 所在命名空间内解析,写错或跨命名空间时 Ingress Controller 会静默回退到默认证书。
  4. 缓存与热更新。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 也要逐一列出。

内容审核

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