首页/云/Kubernetes 速查/IPv4/IPv6 双栈 Service 要点
网络与服务55 条

IPv4/IPv6 双栈 Service 要点

双栈集群中 Service 可同时拥有 IPv4/IPv6 地址,由 ipFamilyPolicy 与 ipFamilies 控制;单栈集群里这些字段按默认行为即可。

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

双栈 Service

双栈 Service
spec:
  ipFamilyPolicy: PreferDualStack   # SingleStack | PreferDualStack | RequireDualStack
  ipFamilies: ["IPv4", "IPv6"]
  ports:
    - port: 80

查看地址族

查看地址族
kubectl get svc web -o jsonpath='{.spec.ipFamilyPolicy} {.spec.ipFamilies}'
kubectl get svc web -o jsonpath='{.spec.clusterIPs}'
kubectl get nodes -o jsonpath='{range .items[*]}{.metadata.name} {.spec.podCIDRs}{"\n"}{end}'
要求集群本身以双栈配置(双 Service CIDR / Pod CIDR)创建,单栈集群改字段不会凭空获得 IPv6。

易错点

  • 应用与中间件对 IPv6 支持不齐时,双栈反而引入解析歧义(返回 AAAA 但不可达)
  • 迁移双栈要同步验证 DNS、NetworkPolicy 与外部依赖

数据来源与参考

  • Kubernetes 官方文档 · IPv4/IPv6 dual-stack
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌