kube-proxy 镜像文档

镜像概述

registry.k8s.io/kube-proxy 是 Kubernetes ***提供的网络代理组件镜像，运行在 Kubernetes 集群的每个节点上。作为 Kubernetes 网络模型的关键组件，kube-proxy 负责实现 Service 资源定义的网络规则，包括流量转发、负载均衡和会话保持等功能，确保集群内部及外部对 Pod 的网络访问能够正确路由。

核心功能和特性

核心功能

• Service 实现：通过维护节点网络规则（如 iptables、ipvs 规则），将 Service 的 ClusterIP、NodePort 等访问方式映射到后端 Pod
• 流量转发：支持 TCP、UDP 协议的流量转发，实现 Service 到 Pod 的请求路由
• 负载均衡：对后端多个 Pod 实例提供简单的负载均衡能力（基于规则的轮询或会话亲和性）
• 会话亲和性：支持基于客户端 IP 的会话亲和性（Session Affinity），确保同一客户端请求定向到同一 Pod

主要特性

• 多代理模式：支持 iptables（默认）、ipvs、userspace 三种代理模式，适应不同性能和功能需求
• 动态配置更新：通过监听 Kubernetes API Server，实时感知 Service 和 Endpoints 资源变化，动态更新网络规则
• 健康检查集成：与 Kubernetes 健康检查机制联动，自动剔除异常 Pod 实例
• 高可用性：以 DaemonSet 形式部署，确保每个节点均运行一个实例，保障网络代理服务的高可用

使用场景和适用范围

典型使用场景

• Kubernetes 集群部署：作为必选组件，随集群初始化自动部署
• Service 网络访问：实现集群内 Pod 间通过 Service 名称/ClusterIP 通信
• 外部访问集群服务：通过 NodePort 或 Load*** 类型 Service 暴露服务供外部访问
• 多节点网络协同：跨节点 Pod 通信的网络规则维护

适用范围

• 所有 Kubernetes 集群环境（包括自建集群、云厂商托管集群等）
• 对网络性能有不同需求的场景（可通过选择代理模式调整）
• 需要标准 Service 功能的 Kubernetes 应用部署

使用方法和配置说明

基本部署方式

kube-proxy 通常由 Kubernetes 集群部署工具（如 kubeadm）以 DaemonSet 形式自动部署，无需手动执行 docker run。典型的 DaemonSet 配置片段如下：

yaml
apiVersion: apps/v1
kind: DaemonSet
metadata:
  name: kube-proxy
  namespace: kube-system
spec:
  selector:
    matchLabels:
      k8s-app: kube-proxy
  template:
    metadata:
      labels:
        k8s-app: kube-proxy
    spec:
      containers:
      - name: kube-proxy
        image: registry.k8s.io/kube-proxy:v1.28.0  # 需指定具体版本标签
        command:
        - kube-proxy
        - --proxy-mode=iptables  # 指定代理模式
        - --kubeconfig=/var/lib/kube-proxy/kubeconfig.conf  # kubeconfig 文件路径
        securityContext:
          privileged: true  # 需要特权模式以操作网络规则
        volumeMounts:
        - name: kubeconfig
          mountPath: /var/lib/kube-proxy
        - name: xtables-lock
          mountPath: /run/xtables.lock
        - name: lib-modules
          mountPath: /lib/modules
      volumes:
      - name: kubeconfig
        configMap:
          name: kube-proxy
      - name: xtables-lock
        hostPath:
          path: /run/xtables.lock
          type: FileOrCreate
      - name: lib-modules
        hostPath:
          path: /lib/modules

配置参数说明

常用命令行参数

环境变量

kube-proxy 通常通过 kubeconfig 或命令行参数配置，环境变量使用较少，主要包括：

• KUBERNETES_SERVICE_HOST：API Server 的主机地址（自动注入）
• KUBERNETES_SERVICE_PORT：API Server 的端口（自动注入）

代理模式说明

iptables 模式（默认）

• 基于 Linux iptables 规则实现流量转发
• 优点：轻量、内核态处理、性能较好
• 缺点：规则复杂时更新效率低，不支持高级负载均衡算法

ipvs 模式

• 基于 Linux ipvs 模块实现，支持更丰富的负载均衡算法
• 优点：支持轮询、加权轮询、最少连接等算法，规则更新效率高，性能优于 iptables
• 缺点：需要内核支持 ipvs 模块，部署稍复杂

userspace 模式（已废弃）

• 基于用户态进程实现流量转发
• 缺点：性能较差，已不再推荐使用，仅用于兼容性场景

部署注意事项

1. 权限要求：kube-proxy 需要以特权模式运行，以修改节点网络规则
2. 内核依赖：使用 ipvs 模式时，需确保节点内核已加载 ipvs 相关模块（如 ip_vs、ip_vs_rr 等）
3. 版本匹配：kube-proxy 版本需与 Kubernetes 集群版本保持一致，避免兼容性问题
4. 资源配置：根据集群规模调整 CPU 和内存资源限制，大规模集群建议使用 ipvs 模式并适当增加资源分配