跳到主要内容
Kubernetes

GeoTrust SSL 证书在 Kubernetes 中的部署与续期实战(Ingress + Secret)

问题背景与根因:GeoTrust 证书在 Kubernetes 中为何常出现“浏览器正常、程序报错”

GeoTrust 现属 DigiCert 旗下,定位中端 OV 证书,审核稳定,适合需要组织验证但预算有限的企业。部署到 Kubernetes 时,TLS 通常在 Ingress Controller 处终止,证书以 Secret 形式挂载,Ingress 通过 secretName 引用。问题往往不在证书本身,而在链、私钥、命名空间和控制器缓存。自 2020 年 9 月起,公共 TLS 证书最长有效期被限制为 398 天;Let’s Encrypt 仍是 90 天。GeoTrust 商业证书到期前必须更新 Secret,否则会出现 x509: certificate has expired or is not yet valid。

常见根因有四类:一是只上传叶子证书,未带中间证书,浏览器会自动补链,但 curl、Java、小程序严格校验后报 unable to get local issuer certificate;二是证书与私钥不匹配,nginx 日志出现 key values mismatch;三是 Secret 与 Ingress 不在同一 namespace,控制器回退到 default-ssl-certificate;四是更新 Secret 后控制器未 reload 或本地 DNS/缓存仍指向旧证书。排查时先看 kubectl describe ingress 和 ingress-nginx 日志,再用 openssl s_client 看实际下发的证书链,不要只看浏览器锁标。

完整实操步骤:准备 GeoTrust 证书文件并做三项校验

从 CA 下载的文件通常包含 example.com.crt、example.com.key 和中间证书。部署前先合并 fullchain.pem:叶子证书在前,中间证书在后;不要放根证书。执行以下命令,输出应显示 subject、issuer 和 notAfter,且日期覆盖当前时间。

mkdir -p certs && cd certs
cat example.com.crt intermediate.crt > fullchain.pem
openssl x509 -in fullchain.pem -noout -subject -issuer -dates
awk 'BEGIN{c=0}/BEGIN CERTIFICATE/{c++}END{print c}' fullchain.pem
openssl x509 -in fullchain.pem -noout -modulus | openssl md5
openssl rsa -in example.com.key -noout -modulus | openssl md5

第二项统计 BEGIN CERTIFICATE 数量,OV 证书通常至少为 2;若为 1,说明缺中间证书。第三、四项的 md5 必须完全一致,否则私钥与证书不匹配。再验证链:openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt -untrusted fullchain.pem fullchain.pem,返回 OK 才可进入 Secret 创建。若系统 CA 路径不同,用 openssl version -d 查看。注意私钥权限设为 600,且不要提交到 Git。

创建与滚动更新 Kubernetes TLS Secret

Kubernetes 的 TLS Secret 类型为 kubernetes.io/tls,必须包含 tls.crt 和 tls.key 两个键。tls.crt 放 fullchain.pem,tls.key 放私钥。Secret 必须与 Ingress 同 namespace,否则 Ingress 无法引用。首次创建:

kubectl create namespace web
kubectl create secret tls example-com-tls --cert=fullchain.pem --key=example.com.key -n web
kubectl describe secret example-com-tls -n web

续期时不要直接 edit Secret,推荐用 dry-run 生成清单后 apply,实现滚动替换:

kubectl create secret tls example-com-tls --cert=fullchain.pem --key=example.com.key -n web --dry-run=client -o yaml | kubectl apply -f -

如果 Secret 被设为 immutable: true,apply 会报 field is immutable,需要先删除再创建,或提前去掉不可变标记。更新后用 kubectl get secret example-com-tls -n web -o yaml 检查 data.tls.crt 的 base64 是否变化;再用 kubectl get secret example-com-tls -n web -o jsonpath='{.data.tls.crt}’ | base64 -d | openssl x509 -noout -subject -dates 确认新证书。注意命令中的 jsonpath 需转义点号,否则取不到 tls.crt。

Ingress 配置示例:networking.k8s.io/v1 与 TLS 重定向

Kubernetes 1.19+ 使用 networking.k8s.io/v1。下面示例将 example.com 的 443 流量交给 Ingress Controller,再由控制器转发到 web Service 的 80 端口。tls.hosts 必须与 rules.host 一致,secretName 必须指向同 namespace 的 Secret。

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: example-ingress
  namespace: web
  annotations:
    nginx.ingress.kubernetes.io/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 web。Events 中若出现 does not contain a valid TLS certificate,优先检查 Secret 是否存在、namespace 是否一致、tls.crt 是否为完整链。Nginx Ingress Controller 会监听 Secret 变化并 reload;若使用其他控制器,需确认其支持 Secret 热加载。如果使用 AWS Load Balancer Controller,TLS 证书通常通过 annotation 绑定 ACM 证书 ARN,而不是 Secret;本示例针对 nginx-ingress。生产环境建议同时配置 HSTS 前先确认全站 HTTPS,避免子域回退导致访问失败。

对比表格:手动 Secret、cert-manager 与外部密钥管理

GeoTrust 商业 OV 证书通常不走 ACME,不能简单等同于 Let’s Encrypt 的 90 天自动续期。选择方案时重点看签发渠道、续期方式和密钥落盘位置。

方案 适用场景 续期方式 优点 限制与风险
手动 kubectl create secret tls 域名少、发布频率低 到期前人工更新 Secret 命令简单,易审计 易忘续期、易漏中间证书
cert-manager + ACME 公网域名、可自动验证 按 90 天周期自动续期 自动化程度高 主要面向 ACME CA,GeoTrust 商业证书通常不适用
cert-manager + Venafi/External Issuer 企业商业 CA、合规要求高 自动或半自动 可对接企业 CA 流程 配置复杂,需 Issuer 支持
External Secrets/Sealed Secrets + CI GitOps、多集群 流水线签发后同步 Secret 密钥不落 Git,可审计 依赖 CI 与密钥管理系统

如果只是单集群单域名,手动 Secret 加日历提醒足够;如果多集群、多域名,建议把签发、校验、更新 Secret 做成流水线,并在更新后自动执行 curl 和 openssl s_client 验证。不要在生产环境混用同一域名的旧 Secret 和新 Ingress,否则会出现部分节点下发旧证书。

常见错误排查:真实报错与定位命令

报错一:curl: (60) SSL certificate problem: unable to get local issuer certificate。说明服务端未下发中间证书。执行 openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null,检查输出证书数量;若只有 1 张,把中间证书合并进 fullchain.pem 后更新 Secret。

报错二:nginx: SSL_CTX_use_PrivateKey() failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch)。证书与私钥不匹配。分别执行 openssl x509 -in fullchain.pem -noout -modulus | openssl md5 和 openssl rsa -in example.com.key -noout -modulus | openssl md5,两个 md5 必须一致。

报错三:x509: certificate has expired or is not yet valid。检查 notBefore/notAfter,并确认节点时间同步。报错四:Ingress 日志出现 does not contain a valid TLS certificate,或浏览器显示 Kubernetes Ingress Controller Fake Certificate,通常是 Secret 不存在、namespace 不一致或 tls.crt 不是合法 PEM。用 kubectl get secret -n web、kubectl describe ingress example-ingress -n web、kubectl logs -n ingress-nginx deploy/ingress-nginx-controller –tail=100 | grep -i tls 定位。更新后仍不生效,执行 kubectl rollout restart deployment/ingress-nginx-controller -n ingress-nginx 并清理本地 DNS 缓存。

效果验证:从集群内到公网的完整检查清单

先验证 Secret 内容:kubectl get secret example-com-tls -n web -o yaml,确认 type 为 kubernetes.io/tls。再验证 Ingress 状态:kubectl get ingress example-ingress -n web -o wide;kubectl describe ingress example-ingress -n web。随后从集群外检查实际握手:curl -vI https://example.com,观察 subject、issuer 和 SSL certificate verify ok;再用 openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null | openssl x509 -noout -subject -issuer -dates,确认 issuer 为 GeoTrust/DigiCert 对应中间 CA,日期为新证书。

链验证看 Verify return code: 0 (ok)。若 Java、小程序或 Android 仍报错,检查是否只信任根证书、是否缺少中间证书、是否要求 TLS 1.2 以上。多节点场景用 dig 或 nslookup 确认 DNS 指向所有 Ingress 入口,并逐台执行 curl –resolve example.com:443:节点IP https://example.com。更新 Secret 后等待控制器 reload,再观察 ingress-nginx 日志中是否有 RELOAD 记录。最后把到期时间、Secret 名称、Ingress 名称写入监控告警,建议在到期前 30 天触发提醒。

常见问题

是。Ingress 的 tls.crt 应放叶子证书加中间证书。只放叶子证书时浏览器可能自动补链,但 curl、Java、小程序会报 unable to get local issuer certificate。可用 awk 统计 BEGIN CERTIFICATE 至少 2 段,并用 openssl verify 验证。


先确认 Secret 与 Ingress 同 namespace,且 Ingress 的 secretName 未写错;再查看 ingress-nginx 日志是否 reload。若仍不生效,执行 kubectl rollout restart deployment/ingress-nginx-controller -n ingress-nginx,并清理本地 DNS 与浏览器缓存,等待 1 到 2 分钟。


通常不能直接续期。cert-manager 的 ACME 主要签发 Let’s Encrypt 90 天证书;GeoTrust 商业 OV 证书需通过 Venafi/External Issuer 或 CI 流水线签发后更新 Secret。不要把 ACME 配置误用于商业 CA。


分别执行 openssl x509 -in fullchain.pem -noout -modulus | openssl md5 和 openssl rsa -in example.com.key -noout -modulus | openssl md5,两个输出一致即匹配;不一致时 nginx 会报 key values mismatch,必须重新签发或找回正确私钥。


公共 TLS 证书最长有效期为 398 天,GeoTrust 商业证书也受此限制;实际到期日以证书 notAfter 为准。Let’s Encrypt 仍为 90 天。建议在到期前 30 天更新 Secret,并监控 notAfter。

内容审核

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