容器与云原生 / 系统课时
配置 HTTPS 证书
配置 HTTPS 证书
这一节完成一条可验证的 HTTPS 入口:为 app.example.com 准备证书与私钥,创建 Kubernetes TLS Secret,把证书绑定到 Ingress,并从客户端确认实际返回的证书确实覆盖该域名。
学习目标
- 创建类型为
kubernetes.io/tls的 Secret,并理解证书与私钥的对应关系。 - 在 Ingress 的
spec.tls中完成 HTTPS 终止配置。 - 验证证书 SAN、Ingress 主机名和客户端访问域名三者是否一致。
前置检查
示例假设命名空间为 demo,其中已经存在名为 web、端口为 80 的 Service,并且集群中已经安装可处理该 Ingress 的控制器。域名 app.example.com 最终需要解析到 Ingress 控制器的入口地址;实验时也可以用 curl --resolve 临时指定地址。
先确认 Service 与 IngressClass:
kubectl get service web -n demo
kubectl get ingressclass预期输出:
NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE
web ClusterIP <IP> <none> 80/TCP <TIME>
NAME CONTROLLER PARAMETERS AGE
nginx k8s.io/ingress-nginx <none> <TIME>实际的 IP、AGE 和 IngressClass 名称可能不同,后续清单中的 ingressClassName 必须填写你集群真实存在的类。
生成证书并创建 TLS Secret
实验环境可以先生成一张自签名证书。关键点不是 Common Name,而是证书的 Subject Alternative Name 必须包含客户端实际访问的域名。
openssl req -x509 -nodes -newkey rsa:2048 -keyout tls.key -out tls.crt -days 30 -subj "/CN=app.example.com" -addext "subjectAltName=DNS:app.example.com"
kubectl create secret tls app-tls --cert=tls.crt --key=tls.key -n demo预期输出:
secret/app-tls createdkubectl create secret tls 会校验证书和私钥能否作为 TLS 材料读取。生产环境通常由受信任 CA 或证书控制器签发证书,不应长期使用这里的自签名证书。
配置 Ingress 的 HTTPS 终止
TLS 终止发生在 Ingress 控制器:客户端与控制器建立 HTTPS,控制器解密后再把请求转发给后端 Service。secretName 引用的 Secret 必须与 Ingress 位于同一命名空间。

创建 ingress-https.yaml:
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
name: web-https
namespace: demo
spec:
ingressClassName: nginx
tls:
- hosts:
- app.example.com
secretName: app-tls
rules:
- host: app.example.com
http:
paths:
- path: /
pathType: Prefix
backend:
service:
name: web
port:
number: 80应用并查看状态:
kubectl apply -f ingress-https.yaml
kubectl get ingress web-https -n demo预期输出:
ingress.networking.k8s.io/web-https created
NAME CLASS HOSTS ADDRESS PORTS AGE
web-https nginx app.example.com <IP> 80, 443 <TIME>ADDRESS 可能需要一段时间才出现,也可能显示主机名而不是 IP。出现 443 说明对象声明了 TLS,但仍应继续验证控制器实际返回的证书。
验证证书和域名匹配
先直接检查本地证书的 SAN:
openssl x509 -in tls.crt -noout -subject -ext subjectAltName预期输出:
subject=CN = app.example.com
X509v3 Subject Alternative Name:
DNS:app.example.com再取得 Ingress 地址,并让 curl 在不修改 DNS 的情况下把域名解析到该地址。把 <IP> 替换成 kubectl get ingress 得到的入口 IP:
curl --resolve app.example.com:443:<IP> --cacert tls.crt https://app.example.com/health预期输出:
<BACKEND_RESPONSE>只要 TLS 握手成功且没有出现主机名不匹配错误,就说明客户端访问域名与证书 SAN 匹配;响应正文由后端 /health 接口决定,因此这里用 <BACKEND_RESPONSE> 表示实际内容可能不同。
常见失败怎么定位
若出现 secret not found,先检查 Ingress 与 Secret 是否在同一命名空间;若控制器返回默认证书,检查 secretName 拼写和控制器事件;若浏览器提示域名不匹配,优先查看证书 SAN,而不是只看 CN。
kubectl describe ingress web-https -n demo
kubectl get secret app-tls -n demo -o jsonpath='{.type}{"\n"}'预期输出:
<INGRESS_DETAILS>
kubernetes.io/tls<INGRESS_DETAILS> 中应能看到 TLS 主机、Secret 引用和控制器事件。完成这些检查后,HTTPS 是否可用就能被拆成三个独立问题:证书内容是否正确、Secret 是否被正确引用、入口域名是否真正到达该 Ingress。