首页/云/Kubernetes 速查/指定与更换 ClusterIP 的规则
本包目录(307 条)
kubectl 基础56 条工作负载36 条
网络与服务55 条
配置与存储54 条调度与资源52 条集群运维与排障54 条

指定与更换 ClusterIP 的规则

ClusterIP 可在创建时从 Service 网段内指定,创建后不可修改;删除重建通常会拿到新 IP,理解这一点对依赖固定 IP 的旧系统很重要。

Kubernetes 速查云更新于 2026-10-12

指定 clusterIP

指定 clusterIP
spec:
  clusterIP: 10.96.0.100     # 必须落在集群 Service CIDR 内且未占用
  ports:
    - port: 80

查看网段

查看网段
kubectl get svc kubernetes -n default -o jsonpath='{.spec.clusterIP}'
kubectl cluster-info dump | grep -i -m1 service-cluster-ip-range
依赖固定 ClusterIP 属于反模式:应依赖 DNS 名称(<svc>.<ns>.svc.cluster.local),DNS 名在重建后保持稳定。

易错点

  • clusterIP 属于不可变字段,改它必然报错,只能删除重建
  • 删除重建期间服务名短暂无后端,DNS 记录(虚拟 IP)也会变化

数据来源与参考

  • Kubernetes 官方文档 · Service(clusterIP 字段说明)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌