大网数据广告活动
Kubernetes 部署与运维

kube-proxy 配置 (v1alpha1)

· 52CE 我爱测

[Alpha] text 包含日志格式 "text" 的选项。 仅在启用了 `LoggingAlphaOptions` 特性门控时可用。 </p> </td> </tr> <tr><td><code>json</code> <B>[必需]</B><br/> <a href="#JSONOptions"><code>JSONOptions</code></a> </td> <td> <p>

资源类型 {#resource-types}

FormatOptions {#FormatOptions}

出现在:

<p>

FormatOptions 包含不同日志格式的选项。 </p>

<table class="table"> <thead><tr><th width="30%">字段</th><th>描述</th></tr></thead> <tbody>

<tr><td><code>text</code> <B>[必需]</B><br/> <a href="#TextOptions"><code>TextOptions</code></a> </td> <td> <p>

[Alpha] text 包含日志格式 "text" 的选项。 仅在启用了 LoggingAlphaOptions 特性门控时可用。 </p> </td> </tr> <tr><td><code>json</code> <B>[必需]</B><br/> <a href="#JSONOptions"><code>JSONOptions</code></a> </td> <td> <p>

[Alpha] JSON 包含日志格式 "json" 的选项。 仅在启用了 LoggingAlphaOptions 特性门控时可用。 </p> </td> </tr> </tbody> </table>

JSONOptions {#JSONOptions}

出现在:

<p>

JSONOptions 包含日志格式 "json" 的选项。 </p>

<table class="table"> <thead><tr><th width="30%">字段</th><th>描述</th></tr></thead> <tbody>

<tr><td><code>OutputRoutingOptions</code> <B>[必需]</B><br/> <a href="#OutputRoutingOptions"><code>OutputRoutingOptions</code></a> </td> <td> <span class="text-muted">

未提供描述。 </span></td> </tr> </tbody> </table>

LogFormatFactory {#LogFormatFactory}

<p>

LogFormatFactory 提供对某种额外的、非默认日志格式的支持。 </p>

LoggingConfiguration {#LoggingConfiguration}

出现在:

<p>

LoggingConfiguration 包含日志记录选项。 </p>

<table class="table"> <thead><tr><th width="30%">字段</th><th>描述</th></tr></thead> <tbody>

<tr><td><code>format</code> <B>[必需]</B><br/> <code>string</code> </td> <td> <p>

format 标志指定日志消息的结构。 格式的默认值是 <code>text</code>。 </p> </td> </tr> <tr><td><code>flushFrequency</code> <B>[必需]</B><br/> <a href="#TimeOrMetaDuration"><code>TimeOrMetaDuration</code></a> </td> <td> <p>

指定两次日志清洗之间的最大时间:

  • 如果是字符串,则被解析为持续时间(例如 "1s")。
  • 如果是整数,则表示最大纳秒数(例如 1s = 1000000000)。

如果选择的日志后端在写入日志消息时不进行缓冲,则此设置将被忽略。 </p> </td> </tr> <tr><td><code>verbosity</code> <B>[必需]</B><br/> <a href="#VerbosityLevel"><code>VerbosityLevel</code></a> </td> <td> <p>

verbosity 是决定哪些日志消息会被记录的阈值。 默认值为零,仅记录最重要的消息。更高的值会启用额外的消息记录。错误消息始终会被记录。 </p> </td> </tr> <tr><td><code>vmodule</code> <B>[必需]</B><br/> <a href="#VModuleConfiguration"><code>VModuleConfiguration</code></a> </td> <td> <p>

vmodule 为个别文件覆盖 verbosity 阈值。 仅支持 "text" 日志格式。 </p> </td> </tr> <tr><td><code>options</code> <B>[必需]</B><br/> <a href="#FormatOptions"><code>FormatOptions</code></a> </td> <td> <p>

[Alpha] options 包含特定于不同日志格式的附加参数。 只有与选中格式相关的选项会被使用,但所有选项都会被校验。 仅在启用了 LoggingAlphaOptions 特性门控时可用。 </p> </td> </tr> </tbody> </table>

LoggingOptions {#LoggingOptions}

<p>

LoggingOptions 可以与 ValidateAndApplyWithOptions 一起使用,以覆盖某些全局默认设置。 </p>

<table class="table"> <thead><tr><th width="30%">字段</th><th>描述</th></tr></thead> <tbody>

<tr><td><code>ErrorStream</code> <B>[必需]</B><br/> <a href="https://pkg.go.dev/io#Writer"><code>io.Writer</code></a> </td> <td> <p>

ErrorStream 可以用于覆盖默认的 os.Stderr。 </p> </td> </tr> <tr><td><code>InfoStream</code> <B>[必需]</B><br/> <a href="https://pkg.go.dev/io#Writer"><code>io.Writer</code></a> </td> <td> <p>

InfoStream 可以用于覆盖默认的 os.Stdout。 </p> </td> </tr> </tbody> </table>

OutputRoutingOptions {#OutputRoutingOptions}

出现在:

<p>

OutputRoutingOptions 包含同时被 "text" 和 "json" 日志格式支持的选项。 </p>

<table class="table"> <thead><tr><th width="30%">字段</th><th>描述</th></tr></thead> <tbody>

<tr><td><code>splitStream</code> <B>[必需]</B><br/> <code>bool</code> </td> <td> <p>

[Alpha] SplitStream 将错误消息重定向到 stderr,而信息消息则输出到 stdout,并且带有缓冲。 默认情况下,两者都写入 stdout,且不带缓冲。 仅在启用了 LoggingAlphaOptions 特性门控时可用。 </p> </td> </tr> <tr><td><code>infoBufferSize</code> <B>[必需]</B><br/> <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/api/resource#QuantityValue"><code>k8s.io/apimachinery/pkg/api/resource.QuantityValue</code></a> </td> <td> <p>

[Alpha] infoBufferSize 设置在使用分离流时信息流的缓冲区大小。默认值为零,表示禁用缓冲。 仅在启用了 LoggingAlphaOptions 特性门控时可用。 </p> </td> </tr> </tbody> </table>

TextOptions {#TextOptions}

出现在:

<p>

TextOptions 包含日志格式 "text" 的选项。 </p>

<table class="table"> <thead><tr><th width="30%">字段</th><th>描述</th></tr></thead> <tbody>

<tr><td><code>OutputRoutingOptions</code> <B>[必需]</B><br/> <a href="#OutputRoutingOptions"><code>OutputRoutingOptions</code></a> </td> <td> <span class="text-muted">

未提供描述。 </span></td> </tr> </tbody> </table>

TimeOrMetaDuration {#TimeOrMetaDuration}

出现在:

<p>

TimeOrMetaDuration 仅出于 flushFrequency 字段的向后兼容性而存在, 新字段应使用 metav1.Duration。 </p>

<table class="table"> <thead><tr><th width="30%">字段</th><th>描述</th></tr></thead> <tbody>

<tr><td><code>Duration</code> <B>[必需]</B><br/> <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration"><code>meta/v1.Duration</code></a> </td> <td> <p>

Duration 包含持续时间。 </p> </td> </tr> <tr><td><code>-</code> <B>[必需]</B><br/> <code>bool</code> </td> <td> <p>

SerializeAsString 控制值是被序列化为字符串还是整数。 </p> </td> </tr> </tbody> </table>

VModuleConfiguration {#VModuleConfiguration}

[]k8s.io/component-base/logs/api/v1.VModuleItem 的别名

出现在:

<p>

VModuleConfiguration 是个别文件名或模式及其对应 verbosity 阈值的集合。 </p>

VerbosityLevel {#VerbosityLevel}

(uint32 的别名)

出现在:

<p>

VerbosityLevel 表示 klog 或 logr 的日志详细程度(verbosity)阈值。 </p>

ClientConnectionConfiguration {#ClientConnectionConfiguration}

出现在:

ClientConnectionConfiguration 包含构造客户端所需要的细节信息。

<table class="table"> <thead><tr><th width="30%">字段</th><th>描述</th></tr></thead> <tbody>

<tr><td><code>kubeconfig</code> <B>[必需]</B><br/> <code>string</code> </td> <td>

<p><code>kubeconfig</code> 字段是指向一个 KubeConfig 文件的路径。</p> </td> </tr> <tr><td><code>acceptContentTypes</code> <B>[必需]</B><br/> <code>string</code> </td> <td>

<p><code>acceptContentTypes</code> 字段定义客户端在连接到服务器时所发送的 Accept 头部字段。 此设置值会覆盖默认配置 'application/json'。 此字段会控制某特定客户端与指定服务器的所有链接。</p> </td> </tr> <tr><td><code>contentType</code> <B>[必需]</B><br/> <code>string</code> </td> <td>

<p><code>contentType</code> 字段是从此客户端向服务器发送数据时使用的内容类型(Content Type)。</p> </td> </tr> <tr><td><code>qps</code> <B>[必需]</B><br/> <code>float32</code> </td> <td>

<p><code>qps</code> 字段控制此连接上每秒钟可以发送的查询请求个数。</p> </td> </tr> <tr><td><code>burst</code> <B>[必需]</B><br/> <code>int32</code> </td> <td>

<p><code>burst</code> 字段允许客户端超出其速率限制时可以临时累积的额外查询个数。</p> </td> </tr> </tbody> </table>

DebuggingConfiguration {#DebuggingConfiguration}

出现在:

DebuggingConfiguration 包含调试相关功能的配置。

<table class="table"> <thead><tr><th width="30%">字段</th><th>描述</th></tr></thead> <tbody>

<tr><td><code>enableProfiling</code> <B>[Required]</B><br/> <code>bool</code> </td> <td>

<p><code>enableProfiling</code> 字段通过位于 <code>host:port/debug/pprof/</code> 的 Web 接口启用性能分析。</p> </td> </tr> <tr><td><code>enableContentionProfiling</code> <B>[Required]</B><br/> <code>bool</code> </td> <td>

<p><code>enableContentionProfiling</code> 字段在 <code>enableProfiling</code> 为 true 时启用阻塞分析。</p> </td> </tr> </tbody> </table>

LeaderElectionConfiguration {#LeaderElectionConfiguration}

出现在:

LeaderElectionConfiguration 为能够支持领导者选举的组件定义其领导者选举客户端的配置。

<table class="table"> <thead><tr><th width="30%">字段</th><th>描述</th></tr></thead> <tbody>

<tr><td><code>leaderElect</code> <B>[必需]</B><br/> <code>bool</code> </td> <td>

<p> <code>leaderElect</code> 字段允许领导者选举客户端在进入主循环执行之前先获得领导者角色。 运行多副本组件时启用此功能有助于提高可用性。 </p> </td> </tr> <tr><td><code>leaseDuration</code> <B>[必需]</B><br/> <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration"><code>meta/v1.Duration</code></a> </td> <td>

<p> <code>leaseDuration</code> 字段是非领导角色候选者在观察到需要领导席位更新时要等待的时间; 只有经过所设置时长才可以尝试去获得一个仍处于领导状态但需要被刷新的席位。 这里的设置值本质上意味着某个领导者在被另一个候选者替换掉之前可以停止运行的最长时长。 只有当启用了领导者选举时此字段有意义。 </p> </td> </tr> <tr><td><code>renewDeadline</code> <B>[必需]</B><br/> <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration"><code>meta/v1.Duration</code></a> </td> <td>

<p> <code>renewDeadline</code> 字段设置的是当前领导者在停止扮演领导角色之前需要刷新领导状态的时间间隔。 此值必须小于或等于租约期限的长度。只有到启用了领导者选举时此字段才有意义。 </p> </td> </tr> <tr><td><code>retryPeriod</code> <B>[必需]</B><br/> <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration"><code>meta/v1.Duration</code></a> </td> <td>

<p> <code>retryPeriod</code> 字段是客户端在连续两次尝试获得或者刷新领导状态之间需要等待的时长。 只有当启用了领导者选举时此字段才有意义。 </p> </td> </tr> <tr><td><code>resourceLock</code> <B>[必需]</B><br/> <code>string</code> </td> <td>

<p><code>resourceLock</code> 字段给出在领导者选举期间要作为锁来使用的资源对象类型。</p> </td> </tr> <tr><td><code>resourceName</code> <B>[必需]</B><br/> <code>string</code> </td> <td>

<p><code>resourceName</code> 字段给出在领导者选举期间要作为锁来使用的资源对象名称。</p> </td> </tr> <tr><td><code>resourceNamespace</code> <B>[必需]</B><br/> <code>string</code> </td> <td>

<p><code>resourceNamespace</code> 字段给出在领导者选举期间要作为锁来使用的资源对象所在名字空间。</p> </td> </tr> </tbody> </table>

KubeProxyConfiguration {#kubeproxy-config-k8s-io-v1alpha1-KubeProxyConfiguration}

KubeProxyConfiguration 包含用来配置 Kubernetes 代理服务器的所有配置信息。

<table class="table"> <thead><tr><th width="30%">字段</th><th>描述</th></tr></thead> <tbody>

<tr><td><code>apiVersion</code><br/>string</td><td><code>kubeproxy.config.k8s.io/v1alpha1</code></td></tr> <tr><td><code>kind</code><br/>string</td><td><code>KubeProxyConfiguration</code></td></tr>

<tr><td><code>featureGates</code> <B>[必需]</B><br/> <code>map[string]bool</code> </td> <td>

<p><code>featureGates</code> 字段是一个功能特性名称到布尔值的映射表, 用来启用或者禁用测试性质的功能特性。</p> </td> </tr> <tr><td><code>clientConnection</code> <B>[必需]</B><br/> <a href="#ClientConnectionConfiguration"><code>ClientConnectionConfiguration</code></a> </td> <td> <p>

<code>clientConnection</code> 指定了代理服务器与 apiserver 通信时应使用的 <code>kubeconfig</code> 文件和客户端连接设置。 </p> </td> </tr> <tr><td><code>logging</code> <B>[必需]</B><br/> <a href="#LoggingConfiguration"><code>LoggingConfiguration</code></a> </td> <td> <p>

<code>logging</code> 指定了日志记录的选项。有关更多信息, 请参阅<a href="https://github.com/kubernetes/component-base/blob/master/logs/options.go">日志选项</a>。 </p> </td> </tr> <tr><td><code>hostnameOverride</code> <B>[必需]</B><br/> <code>string</code> </td> <td> <p>

<code>hostnameOverride</code> 如果不为空,将作为 kube-proxy 所运行节点的名称使用。 如果未设置,则默认使用节点的主机名作为节点名称。 </p> </td> </tr> <tr><td><code>bindAddress</code> <B>[必需]</B><br/> <code>string</code> </td> <td>

<p><code>bindAddress</code> 可以用来指定 kube-proxy 所认为的节点主 IP。请注意, 虽然名称中有绑定的意思,但实际上 kube-proxy 并不会将任何套接字绑定到这个 IP 地址上。 </p> </td> </tr> <tr><td><code>healthzBindAddress</code> <B>[必需]</B><br/> <code>string</code> </td> <td>

<p><code>healthzBindAddress</code> 是健康检查服务器的 IP 地址和端口,默认情况下, 如果 bindAddress 未设置或为 IPv4,则为 "0.0.0.0:10256";如果 bindAddress 为 IPv6, 则为 "[::]:10256"。</p> </td> </tr> <tr><td><code>metricsBindAddress</code> <B>[必需]</B><br/> <code>string</code> </td> <td>

<p><code>metricsBindAddress</code> 是指标服务器监听的 IP 地址和端口,默认情况下, 如果 bindAddress 未设置或为 IPv4,则为 "127.0.0.1:10249"; 如果 bindAddress 为 IPv6,则为 "[::1]:10249"。 (设置为 "0.0.0.0:10249" / "[::]:10249" 以绑定到所有接口。)。</p> </td> </tr> <tr><td><code>bindAddressHardFail</code> <B>[必需]</B><br/> <code>bool</code> </td> <td>

<p><code>bindAddressHardFail</code> 字段设置为 true 时, kube-proxy 将无法绑定到某端口这类问题视为致命错误并直接退出。</p> </td> </tr> <tr><td><code>enableProfiling</code> <B>[必需]</B><br/> <code>bool</code> </td> <td>

<p><code>enableProfiling</code> 字段通过 '/debug/pprof' 处理程序在 Web 界面上启用性能分析。 性能分析处理程序将由指标服务器执行。</p> </td> </tr> <tr><td><code>showHiddenMetricsForVersion</code> <B>[必需]</B><br/> <code>string</code> </td> <td>

<p><code>showHiddenMetricsForVersion</code> 用于指定要显示隐藏指标的版本。</p> </td> </tr> <tr><td><code>mode</code> <B>[必需]</B><br/> <a href="#kubeproxy-config-k8s-io-v1alpha1-ProxyMode"><code>ProxyMode</code></a> </td> <td>

<p><code>mode</code> 指定要使用的代理模式。</p> </td> </tr> <tr><td><code>iptables</code> <B>[必需]</B><br/> <a href="#kubeproxy-config-k8s-io-v1alpha1-KubeProxyIPTablesConfiguration"><code>KubeProxyIPTablesConfiguration</code></a> </td> <td>

<p><code>iptables</code> 字段字段包含与 iptables 相关的配置选项。</p> </td> </tr> <tr><td><code>ipvs</code> <B>[必需]</B><br/> <a href="#kubeproxy-config-k8s-io-v1alpha1-KubeProxyIPVSConfiguration"><code>KubeProxyIPVSConfiguration</code></a> </td> <td>

<p><code>ipvs</code> 字段中包含与 ipvs 相关的配置选项。</p> </td> </tr> <tr><td><code>nftables</code> <B>[必需]</B><br/> <a href="#kubeproxy-config-k8s-io-v1alpha1-KubeProxyNFTablesConfiguration"><code>KubeProxyNFTablesConfiguration</code></a> </td> <td>

<p><code>nftables</code> 包含与 nftables 相关的配置选项。</p> </td> </tr> <tr><td><code>winkernel</code> <B>[必需]</B><br/> <a href="#kubeproxy-config-k8s-io-v1alpha1-KubeProxyWinkernelConfiguration"><code>KubeProxyWinkernelConfiguration</code></a> </td> <td>

<p><code>winkernel</code> 包含与 winkernel 相关的配置选项。</p> </td> </tr> <tr><td><code>detectLocalMode</code> <B>[必需]</B><br/> <a href="#kubeproxy-config-k8s-io-v1alpha1-LocalMode"><code>LocalMode</code></a> </td> <td>

<p><code>detectLocalMode</code> 确定用于检测本地流量的模式,默认为 ClusterCIDR。</p> </td> </tr> <tr><td><code>detectLocal</code> <B>[必需]</B><br/> <a href="#kubeproxy-config-k8s-io-v1alpha1-DetectLocalConfiguration"><code>DetectLocalConfiguration</code></a> </td> <td>

<p><code>detectLocal</code> 包含与 DetectLocalMode 相关的可选配置设置。</p> </td> </tr> <tr><td><code>clusterCIDR</code> <B>[必需]</B><br/> <code>string</code> </td> <td>

<p><code>clusterCIDR</code> 指定集群中 Pod 的 CIDR 范围。 (对于双栈集群,这个参数可以是一个用逗号分隔的双栈 CIDR 范围对。) 当 DetectLocalMode 设置为 LocalModeClusterCIDR 时,如果流量的源 IP 在这个范围内, kube-proxy 会将其视为本地流量。(否则不会使用此设置。)</p> </td> </tr> <tr><td><code>nodePortAddresses</code> <B>[必需]</B><br/> <code>[]string</code> </td> <td> <p>

<code>nodePortAddresses</code> 是一个由 CIDR 范围和/或关键字组成的列表, 其中的关键字会展开为对应的 CIDR 范围。NodePort 服务只能通过该列表所覆盖的节点 IP 进行访问。支持的关键字包括:primary(节点对象的主 IPv4 和/或 IPv6 地址)、'localhost'(127.0.0.0/8 和 ::1/128)以及 'all'(0.0.0.0/0 和 ::/0)。 该列表中可以包含任意有效关键字与 CIDR 的组合。 </p>

<p>

通过本地回路 IP 提供 NodePort Service,仅在 iptables 模式下受支持(仅限 IPv4,参见 iptables.localhostNodePorts);在 nftables 模式下,则仅当 KubeProxyNFTablesLocalhostNodePorts 特性门控已启用、且列表中明确包含本地回路(例如 'localhost')时,才支持 TCP 流量。 </p>

<p>

如果未设置,则在 iptables 和 ipvs 模式下默认为 'all',在 nftables 模式下默认为 primary。 </p>

</td> </tr> <tr><td><code>oomScoreAdj</code> <B>[必需]</B><br/> <code>int32</code> </td> <td> <p>

<code>oomScoreAdj</code> 是 kube-proxy 进程的 OOM 评分调整值。该值必须在 [-1000, 1000] 范围内。 </p> </td> </tr> <tr><td><code>conntrack</code> <B>[必需]</B><br/> <a href="#kubeproxy-config-k8s-io-v1alpha1-KubeProxyConntrackConfiguration"><code>KubeProxyConntrackConfiguration</code></a> </td> <td> <p>

<code>conntrack</code> 包含与 conntrack 相关的配置选项。 </p> </td> </tr> <tr><td><code>configSyncPeriod</code> <B>[必需]</B><br/> <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration"><code>meta/v1.Duration</code></a> </td> <td> <p>

<code>configSyncPeriod</code> 指定从 apiserver 刷新配置的频率,必须大于 0。 </p> </td> </tr>

<tr><td><code>portRange</code> <B>[必需]</B><br/> <code>string</code> </td> <td> <p>

<code>portRange</code> 之前用于配置用户空间代理,但现在已不再使用。 </p> </td> </tr> <tr><td><code>windowsRunAsService</code> <B>[Required]</B><br/> <code>bool</code> </td> <td> <p>

如果为 <code>windowsRunAsService</code> 为 True,则启用 Windows 服务控制管理器 API 集成。 </p> </td> </tr>

</tbody> </table>

DetectLocalConfiguration {#kubeproxy-config-k8s-io-v1alpha1-DetectLocalConfiguration}

出现在:

DetectLocalConfiguration 包含与 DetectLocalMode 选项相关的可选设置。

<table class="table"> <thead><tr><th width="30%">字段</th><th>描述</th></tr></thead> <tbody>

<tr><td><code>bridgeInterface</code> <B>[必需]</B><br/> <code>string</code> </td> <td>

<p><code>bridgeInterface</code> 指的是桥接接口的名称。 当 DetectLocalMode 设置为 LocalModeBridgeInterface 时, 如果流量来自这个桥接接口,kube-proxy 会将其视为本地流量。</p> </td> </tr> <tr><td><code>interfaceNamePrefix</code> <B>[必需]</B><br/> <code>string</code> </td> <td>

<p><code>interfaceNamePrefix</code> 是接口名称的前缀。 当 DetectLocalMode 设置为 LocalModeInterfaceNamePrefix 时, 如果流量来自任何名称以该前缀开头的接口,kube-proxy 会将其视为本地流量。</p> </td> </tr> </tbody> </table>

KubeProxyConntrackConfiguration {#kubeproxy-config-k8s-io-v1alpha1-KubeProxyConntrackConfiguration}

出现在:

KubeProxyConntrackConfiguration 包含为 Kubernetes 代理服务器提供的 conntrack 设置。

<table class="table"> <thead><tr><th width="30%">字段</th><th>描述</th></tr></thead> <tbody>

<tr><td><code>maxPerCore</code> <B>[必需]</B><br/> <code>int32</code> </td> <td>

<p><code>maxPerCore</code> 字段是每个 CPU 核所跟踪的 NAT 链接个数上限 (0 意味着保留当前上限限制并忽略 min 字段设置值)。</p> </td> </tr> <tr><td><code>min</code> <B>[必需]</B><br/> <code>int32</code> </td> <td>

<p><code>min</code> 字段给出要分配的链接跟踪记录个数下限。 设置此值时会忽略 maxPerCore 的值(将 maxPerCore 设置为 0 时不会调整上限值)。</p> </td> </tr> <tr><td><code>tcpEstablishedTimeout</code> <B>[必需]</B><br/> <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration"><code>meta/v1.Duration</code></a> </td> <td>

<p><code>tcpEstablishedTimeout</code> 字段给出空闲 TCP 连接的保留时间(例如,'2s')。 此值必须大于 0。</p> </td> </tr> <tr><td><code>tcpCloseWaitTimeout</code> <B>[必需]</B><br/> <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration"><code>meta/v1.Duration</code></a> </td> <td>

<p><code>tcpCloseWaitTimeout</code> 字段用来设置空闲的、处于 CLOSE_WAIT 状态的 conntrack 条目 保留在 conntrack 表中的时间长度(例如,'60s')。 此设置值必须大于 0。</p> </td> </tr> <tr><td><code>tcpBeLiberal</code> <B>[必需]</B><br/> <code>bool</code> </td> <td>

<p><code>tcpBeLiberal</code> 如果设置为 true, kube-proxy 将配置 conntrack 以宽松模式运行, 对于 TCP 连接和超出窗口序列号的报文不会被标记为 INVALID。</p> </td> </tr> <tr><td><code>udpTimeout</code> <B>[必需]</B><br/> <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration"><code>meta/v1.Duration</code></a> </td> <td>

<p><code>udpTimeout</code> 指定处于 UNREPLIED 状态的空闲 UDP conntrack 条目在 conntrack 表中保留的时间 (例如 '30s')。该值必须大于 0。</p> </td> </tr> <tr><td><code>udpStreamTimeout</code> <B>[必需]</B><br/> <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration"><code>meta/v1.Duration</code></a> </td> <td>

<p><code>udpStreamTimeout</code> 指定处于 ASSURED 状态的空闲 UDP conntrack 条目在 conntrack 表中保留的时间 (例如 '300s')。该值必须大于 0。</p> </td> </tr> </tbody> </table>

KubeProxyIPTablesConfiguration {#kubeproxy-config-k8s-io-v1alpha1-KubeProxyIPTablesConfiguration}

出现在:

KubeProxyIPTablesConfiguration 包含用于 Kubernetes 代理服务器的、与 iptables 相关的配置细节。

<table class="table"> <thead><tr><th width="30%">字段</th><th>描述</th></tr></thead> <tbody>

<tr><td><code>masqueradeBit</code> <B>[必需]</B><br/> <code>int32</code> </td> <td>

<p><code>masqueradeBit</code> 字段是 iptables fwmark 空间中的具体一位, 用来在 iptables 或 ipvs 代理模式下设置 SNAT。此值必须介于 [0, 31](含边界值)。</p> </td> </tr> <tr><td><code>masqueradeAll</code> <B>[必需]</B><br/> <code>bool</code> </td> <td>

<p><code>masqueradeAll</code> 字段用来通知 kube-proxy 在使用 iptables 或 ipvs 代理模式时对所有流量执行 SNAT 操作。这在某些 CNI 插件中可能是必需的。</p> </td> </tr> <tr><td><code>localhostNodePorts</code> <B>[必需]</B><br/> <code>bool</code> </td> <td>

<p><code>localhostNodePorts</code> 如果设置为 false, 则会通知 kube-proxy 禁用通过本地主机访问 NodePort 服务的旧有行为。 (仅适用于 iptables 模式和 IPv4;在其他代理模式或 IPv6 下,不允许本地主机访问 NodePort 服务。)</p> </td> </tr> <tr><td><code>syncPeriod</code> <B>[必需]</B><br/> <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration"><code>meta/v1.Duration</code></a> </td> <td>

<p><code>syncPeriod</code> 是时间间隔(例如 '5s'、'1m'、'2h22m'), 指示各种重新同步和清理操作的执行频率。该值必须大于 0。</p> </td> </tr> <tr><td><code>minSyncPeriod</code> <B>[必需]</B><br/> <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration"><code>meta/v1.Duration</code></a> </td> <td>

<p><code>minSyncPeriod</code> 是 iptables 规则重新同步的最小时间间隔(例如 '5s'、'1m'、'2h22m')。 如果值为 0,表示每次服务或 EndpointSlice 发生变化时都会立即重新同步 iptables。</p> </td> </tr> </tbody> </table>

KubeProxyIPVSConfiguration {#kubeproxy-config-k8s-io-v1alpha1-KubeProxyIPVSConfiguration}

出现在:

KubeProxyIPVSConfiguration 包含用于 Kubernetes 代理服务器的、与 ipvs 相关的配置细节。

<table class="table"> <thead><tr><th width="30%">字段</th><th>描述</th></tr></thead> <tbody>

<tr><td><code>syncPeriod</code> <B>[必需]</B><br/> <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration"><code>meta/v1.Duration</code></a> </td> <td>

<p><code>syncPeriod</code> 是各种重新同步和清理操作执行频率的时间间隔(例如 '5s', '1m', '2h22m')。 该值必须大于 0</p> </td> </tr> <tr><td><code>minSyncPeriod</code> <B>[必需]</B><br/> <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration"><code>meta/v1.Duration</code></a> </td> <td>

<p><code>minSyncPeriod</code> 是 IPVS 规则重新同步之间的最小时间间隔(例如 '5s', '1m', '2h22m')。 值为 0 表示每次服务或 EndpointSlice 发生变化时都会立即触发 IPVS 重新同步。</p> </td> </tr> <tr><td><code>scheduler</code> <B>[必需]</B><br/> <code>string</code> </td> <td>

<p><code>scheduler</code> 是用于 IPVS 的调度器。</p> </td> </tr> <tr><td><code>excludeCIDRs</code> <B>[必需]</B><br/> <code>[]string</code> </td> <td>

<p><code>excludeCIDRs</code> 字段取值为一个 CIDR 列表,ipvs 代理程序在清理 IPVS 服务时不应触碰这些 IP 地址。</p> </td> </tr> <tr><td><code>strictARP</code> <B>[必需]</B><br/> <code>bool</code> </td> <td>

<p><code>strictARP</code> 字段用来配置 arp_ignore 和 arp_announce,以避免(错误地)响应来自 kube-ipvs0 接口的 ARP 查询请求。</p> </td> </tr> <tr><td><code>tcpTimeout</code> <B>[必需]</B><br/> <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration"><code>meta/v1.Duration</code></a> </td> <td>

<p><code>tcpTimeout</code> 字段是用于设置空闲 IPVS TCP 会话的超时值。 默认值为 0,意味着使用系统上当前的超时值设置。</p> </td> </tr> <tr><td><code>tcpFinTimeout</code> <B>[必需]</B><br/> <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration"><code>meta/v1.Duration</code></a> </td> <td>

<p><code>tcpFinTimeout</code> 字段用来设置 IPVS TCP 会话在收到 FIN 之后的超时值。 默认值为 0,意味着使用系统上当前的超时值设置。</p> </td> </tr> <tr><td><code>udpTimeout</code> <B>[必需]</B><br/> <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration"><code>meta/v1.Duration</code></a> </td> <td>

<p><code>udpTimeout</code> 字段用来设置 IPVS UDP 包的超时值。 默认值为 0,意味着使用系统上当前的超时值设置。</p> </td> </tr> </tbody> </table>

KubeProxyNFTablesConfiguration {#kubeproxy-config-k8s-io-v1alpha1-KubeProxyNFTablesConfiguration}

出现在:

<p>KubeProxyNFTablesConfiguration 包含 Kubernetes 代理服务器的 nftables 相关配置详细信息。</p>

<table class="table"> <thead><tr><th width="30%">Field</th><th>Description</th></tr></thead> <tbody>

<tr><td><code>masqueradeBit</code> <B>[必需]</B><br/> <code>int32</code> </td> <td>

<p><code>masqueradeBit</code> 字段是 iptables fwmark 空间中的具体一位, 用来在 nftables 代理模式下设置 SNAT。此值必须介于 [0, 31](含边界值)。</p> </td> </tr> <tr><td><code>masqueradeAll</code> <B>[必需]</B><br/> <code>bool</code> </td> <td>

<p><code>masqueradeAll</code> 通知 kube-proxy 在使用 nftables 模式时, 对发送到服务集群 IP 的所有流量执行 SNAT。这在某些 CNI 插件中可能是必需的。</p> </td> </tr> <tr><td><code>syncPeriod</code> <B>[必需]</B><br/> <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration"><code>meta/v1.Duration</code></a> </td> <td>

<p><code>syncPeriod</code> 表示各种重新同步和清理操作执行频率的时间间隔(例如 '5s'、'1m'、'2h22m')。 该值必须大于 0。</p> </td> </tr> <tr><td><code>minSyncPeriod</code> <B>[必需]</B><br/> <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration"><code>meta/v1.Duration</code></a> </td> <td>

<p><code>minSyncPeriod</code>是 iptables 规则重新同步之间的最小时间间隔(例如 '5s'、'1m'、'2h22m')。 值为 0 时,表示每次服务或 EndpointSlice 发生变化时都会立即重新同步 iptables。</p> </td> </tr> </tbody> </table>

KubeProxyWinkernelConfiguration {#kubeproxy-config-k8s-io-v1alpha1-KubeProxyWinkernelConfiguration}

出现在:

KubeProxyWinkernelConfiguration 包含 Kubernetes 代理服务器的 Windows/HNS 设置。

<table class="table"> <thead><tr><th width="30%">字段</th><th>描述</th></tr></thead> <tbody>

<tr><td><code>networkName</code> <B>[必需]</B><br/> <code>string</code> </td> <td>

<p><code>networkName</code> 字段是 kube-proxy 用来创建端点和策略的网络名称。</p> </td> </tr> <tr><td><code>sourceVip</code> <B>[必需]</B><br/> <code>string</code> </td> <td>

<p><code>sourceVip</code> 字段是执行负载均衡时进行 NAT 转换所使用的源端 VIP 端点 IP 地址。</p> </td> </tr> <tr><td><code>enableDSR</code> <B>[必需]</B><br/> <code>bool</code> </td> <td>

<p><code>enableDSR</code> 字段通知 kube-proxy 是否使用 DSR 来创建 HNS 策略。</p> </td> </tr> <tr><td><code>rootHnsEndpointName</code> <B>[必需]</B><br/> <code>string</code> </td> <td>

<p><code>rootHnsEndpointName</code> 字段是附加到用于根网络命名空间二层桥接的 hnsendpoint 的名称。</p> </td> </tr> <tr><td><code>forwardHealthCheckVip</code> <B>[必需]</B><br/> <code>bool</code> </td> <td>

<p><code>forwardHealthCheckVip</code> 字段为 Windows 上的健康检查端口转发服务 VIP。</p> </td> </tr> </tbody> </table>

LocalMode {#kubeproxy-config-k8s-io-v1alpha1-LocalMode}

(<code>string</code> 类型的别名)

出现在:

LocalMode 代表的是对节点上本地流量进行检测的模式。

ProxyMode {#kubeproxy-config-k8s-io-v1alpha1-ProxyMode}

(<code>string</code> 类型的别名)

出现在:

<p>ProxyMode 表示的是 Kubernetes 代理服务器所使用的模式。</p>

<p>Linux 平台上有三种可用的代理模式:<code>iptables</code>、<code>ipvs</code> 和 <code>nftables</code>。 在 Windows 平台上可用的一种代理模式是:<code>kernelspace</code>。</p>

<p>如果代理模式未被指定,将使用默认的代理模式(目前在 Linux 上是 <code>iptables</code>,在 Windows 上是 <code>kernelspace</code>)。 如果不能使用选定的代理模式(由于缺少内核支持、缺少用户空间组件等),则 kube-proxy 将出错并退出。</p>

来源:Kubernetes 文档贡献者 · 作者与贡献记录 · CC BY 4.0。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
Kubernetes 文档贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY 4.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。