文档首页/ 云容器引擎 CCE/ 用户指南（吉隆坡区域）/ 节点池/ 管理节点池/ 修改节点池配置

更新时间：2025-12-08 GMT+08:00

查看PDF

修改节点池配置

当集群默认的节点配置无法满足业务需求时，您可以在节点池维度自定义调整节点的kubelet、kube-proxy、容器引擎等组件的参数，对核心组件进行深度配置。通过精细调整这些参数，可以确保资源的高效利用，同时满足应用的负载需求。

节点池支持的配置参数如下：

kubelet组件配置
kube-proxy组件配置
容器引擎Docker配置（仅使用Docker的节点池可见）
容器引擎Containerd配置（仅使用Containerd的节点池可见）

约束与限制

默认节点池（DefaultPool）不支持节点池配置参数修改。
仅支持在v1.15及以上版本的集群中对节点池进行配置，v1.15以下版本不显示该功能。

通过控制台修改

登录CCE控制台，单击集群名称进入集群。
在左侧导航栏中选择“节点管理”，切换至“节点池”页签。
单击节点池名称后的“更多 > 配置管理”。
在侧边栏滑出的“配置管理”窗口中，根据业务需求修改节点池参数值，关于参数说明详情请参见集群配置参数说明。

通过API修改

您可以通过API接口修改CCE集群配置参数。

PUT /api/v3/projects/{project_id}/clusters/{cluster_id}/nodepools/{nodepool_id}/configuration

参数	描述
project_id	项目ID。
cluster_id	集群ID。
nodepool_id	节点池ID。

请求体示例如下：

{
  "kind" : "Configuration",
  "apiVersion" : "v3",
  "metadata" : {
    "name" : "configuration"
  },
  "spec" : {
    "packages" : [ {
      "name" : "kubelet",
      "configurations" : [ {
        "name" : "system-reserved-mem",
        "value" : 600
      }, {
        "name" : "kube-reserved-mem",
        "value" : 800
      } ]
    } ]
  }
}

以上示例中，修改kubelet组件配置参数如下：

系统内存预留（system-reserved-mem）：设置为600Mi。
Kubernetes组件内存预留（kube-reserved-mem）：设置为800Mi。

kubelet组件配置

名称	参数	参数说明	取值	修改说明	配置方式
CPU管理策略配置	cpu-manager-policy	CPU管理策略配置，详情请参见CPU调度。 none：关闭工作负载实例独占CPU的功能，优点是CPU共享池的可分配核数较多。 static：开启工作负载实例独占CPU，适用于对CPU缓存和调度延迟敏感的场景。 enhanced-static：在支持CPU独占的基础上，增强支持给Burstable Pods配置CPU优先使用核，适用于波峰、波谷相差大且大部分时间处于波谷状态的工作负载。	默认：none	-	控制台/API
请求至kube-apiserver的QPS配置	kube-api-qps	与APIServer通信的每秒查询个数。	默认：100	-	控制台/API
请求至kube-apiserver的Burst配置	kube-api-burst	每秒发送到APIServer的突发请求数量上限。	默认：100	-	控制台/API
kubelet管理的Pod上限	max-pods	Node能运行的Pod最大数量。	CCE Standard集群：由节点最大实例数设置决定。	-	控制台/API
限制Pod中的进程数	pod-pids-limit	每个Pod中可使用的PID个数上限。	默认：-1，表示不限制	-	控制台/API
是否使用本地IP作为该节点的ClusterDNS	with-local-dns	开启后，会自动在节点的kubelet配置中添加节点默认网卡IP作为首选DNS地址。	默认：关闭（参数值为false）	-	控制台/API
事件创建QPS限制	event-qps	每秒可生成的事件数量。	默认：5	-	控制台/API
事件创建的个数的突发峰值上限	event-burst	突发性事件创建的上限值，允许突发性事件创建临时上升到所指定数量。	默认：10	-	控制台/API
允许使用的不安全系统配置	allowed-unsafe-sysctls	允许使用的不安全系统配置。 CCE从1.17.17集群版本开始，kube-apiserver开启了pod安全策略，需要在pod安全策略的allowedUnsafeSysctls中增加相应的配置才能生效（1.17.17以下版本的集群可不配置）。详情请参见Pod安全策略开放非安全系统配置示例。	默认：[]	-	控制台/API
拓扑管理策略	topology-manager-policy	设置拓扑管理策略。合法值包括： restricted：kubelet 仅接受在所请求资源上实现最佳 NUMA对齐的Pod。 best-effort：kubelet会优先选择在 CPU 和设备资源上实现NUMA对齐的Pod。 none（默认）：不启用拓扑管理策略。 single-numa-node：kubelet仅允许在 CPU和设备资源上对齐到同一NUMA节点的Pod。	默认：none	须知：请谨慎修改，修改topology-manager-policy和topology-manager-scope会重启kubelet，并且以更改后的策略重新计算容器实例的资源分配，这有可能导致已经运行的容器实例重启甚至无法进行资源分配。	控制台/API
拓扑管理策略的资源对齐粒度	topology-manager-scope	设置拓扑管理策略的资源对齐粒度。合法值包括： container （默认)：对齐粒度为容器级 pod：对齐粒度为Pod级	默认：container		控制台/API
容器指定DNS解析配置文件	resolv-conf	容器指定DNS解析配置文件	默认为空值	-	控制台/API
除长期运行的请求之外所有运行时请求的超时时长	runtime-request-timeout	除长期运行的请求（pull、 logs、exec和attach）之外所有运行时请求的超时时长。	默认为2m0s	v1.21.10-r0、v1.23.8-r0、v1.25.3-r0及以上版本的集群支持该参数。	控制台/API
是否让kubelet每次仅拉取一个镜像	serialize-image-pulls	串行拉取镜像。关闭：建议值，以支持并行拉取镜像，提高Pod启动速度。开启：支持串行拉取镜像。	集群版本为v1.21.12-r0、v1.23.11-r0、v1.25.6-r0、v1.27.3-r0、v1.28.1-r0以下：默认为开启（参数值为true）集群版本为v1.21.12-r0、v1.23.11-r0、v1.25.6-r0、v1.27.3-r0、v1.28.1-r0及以上：默认为关闭（参数值为false）	v1.21.10-r0、v1.23.8-r0、v1.25.3-r0及以上版本的集群支持该参数。	控制台/API
每秒钟可以执行的镜像仓库拉取操作限值	registry-pull-qps	镜像仓库的QPS上限。	默认为5 取值范围为1~50	v1.21.10-r0、v1.23.8-r0、v1.25.3-r0及以上版本的集群支持该参数。	控制台/API
突发性镜像拉取的上限值	registry-burst	突发性镜像拉取的上限值，允许镜像拉取临时上升到所指定数量。	默认为10 取值范围为1~100，且取值必须大于等于registry-pull-qps的值。	v1.21.10-r0、v1.23.8-r0、v1.25.3-r0及以上版本的集群支持该参数。	控制台/API
容器的日志文件个数上限	container-log-max-files	每个容器日志文件的最大数量。当存在的日志文件数量超过这个值时，最旧的日志文件将被删除，以便为新的日志留出空间。	默认为10 取值范围为2~100	v1.23.14-r0、v1.25.9-r0、v1.27.6-r0、v1.28.4-r0及以上版本的集群支持该参数。	控制台/API
容器日志文件在轮换生成新文件时之前的最大值	container-log-max-size	每个容器的日志文件的最大大小。当日志文件达到这个大小时，将会触发日志轮换即关闭当前日志文件并创建新的日志文件以继续记录。	默认为50Mi 取值范围为1Mi~4096Mi	v1.23.14-r0、v1.25.9-r0、v1.27.6-r0、v1.28.4-r0及以上版本的集群支持该参数。	控制台/API
镜像垃圾回收上限百分比	image-gc-high-threshold	当kubelet磁盘使用达到阈值时，kubelet开始回收镜像。	默认为80 取值范围为1~100	如果需要禁用镜像垃圾回收，请将该参数设置为100。 v1.23.14-r0、v1.25.9-r0、v1.27.6-r0、v1.28.4-r0及以上版本的集群支持该参数。	控制台/API
镜像垃圾回收下限百分比	image-gc-low-threshold	回收镜像后，磁盘使用率降低至特定阈值时，回收过程将停止。	默认为70 取值范围为1~100	该参数取值不得大于镜像垃圾回收上限百分比。 v1.23.14-r0、v1.25.9-r0、v1.27.6-r0、v1.28.4-r0及以上版本的集群支持该参数。	控制台/API
节点内存预留	system-reserved-mem	系统内存预留，目的是为OS系统守护进程（如 sshd、udev 等）预留内存资源。	默认值：自动计算预留内存数，预留值随节点规格变动，具体请参见节点预留资源策略说明可选配置如下：自动计算预留内存数：建议使用自动计算预留内存数，以保证节点的稳定性。预留值随节点规格变动，具体请参见节点预留资源策略说明。自定义预留内存数：自定义节点预留内存分布。	kube-reserved-mem，system-reserved-mem之和小于节点池中节点最小内存规格的50%。	控制台/API
节点内存预留	kube-reserved-mem	Kubernetes组件内存预留，目的是为Kubernetes系统守护进程（如kubelet、container runtime等）预留内存资源。		kube-reserved-mem，system-reserved-mem之和小于节点池中节点最小内存规格的50%。	控制台/API
evictionHard 硬驱逐配置项	memory.available	节点可用内存值	固定为100Mi	关于节点压力驱逐详情请参考节点压力驱逐。须知：驱逐配置项相关配置请谨慎修改，不合理的配置可能会导致节点频繁触发驱逐或节点已过载但未触发驱逐。 kubelet可识别以下两个特定的文件系统标识符： nodefs：节点的主要文件系统，用于本地磁盘卷、不受内存支持的 emptyDir 卷、日志存储等。例如，nodefs 包含 /var/lib/kubelet/。 imagefs：容器引擎使用的文件系统分区。	控制台/API
	nodefs.available	Kubelet 使用的文件系统的可用容量的百分比	默认10% 取值范围为1%~99%		控制台/API
	nodefs.inodesFree	Kubelet 使用的文件系统的可用inodes数的百分比	默认5% 取值范围为1%~99%		控制台/API
	imagefs.available	容器运行时存放镜像等资源的文件系统的可用容量的百分比	默认10% 取值范围为1%~99%		控制台/API
	imagefs.inodesFree	容器运行时存放镜像等资源的文件系统的可用inodes数的百分比	默认为空，不设置取值范围为1%~99%		控制台/API
	pid.available	留给分配 Pod 使用的可用 PID 数的百分比	默认10% 取值范围为1%~99%		控制台/API
evictionSoft 软驱逐配置项	memory.available	节点可用内存值。设置值要求大于相同参数的硬驱逐配置值，且需同时配置对应的驱逐宽限期（evictionSoftGracePeriod）。	默认为空，不设置取值范围为100Mi~1000000Mi		控制台/API
	nodefs.available	Kubelet 使用的文件系统的可用容量的百分比。设置值要求大于相同参数的硬驱逐配置值，且需同时配置对应的驱逐宽限期（evictionSoftGracePeriod）。	默认为空，不设置取值范围为1%~99%		控制台/API
	nodefs.inodesFree	Kubelet 使用的文件系统的可用inodes数的百分比。设置值要求大于相同参数的硬驱逐配置值，且需同时配置对应的驱逐宽限期（evictionSoftGracePeriod）。	默认为空，不设置取值范围为1%~99%		控制台/API
	imagefs.available	容器运行时存放镜像等资源的文件系统的可用容量的百分比。设置值要求大于相同参数的硬驱逐配置值，且需同时配置对应的驱逐宽限期（evictionSoftGracePeriod）。	默认为空，不设置取值范围为1%~99%		控制台/API
	imagefs.inodesFree	容器运行时存放镜像等资源的文件系统的可用inodes数的百分比。设置值要求大于相同参数的硬驱逐配置值，且需同时配置对应的驱逐宽限期（evictionSoftGracePeriod）。	默认为空，不设置取值范围为1%~99%		控制台/API
	pid.available	留给分配 Pod 使用的可用 PID 数的百分比。设置值要求大于相同参数的硬驱逐配置值，且需同时配置对应的驱逐宽限期（evictionSoftGracePeriod）。	默认为空，不设置取值范围为1%~99%		控制台/API

kube-proxy组件配置

名称	参数	参数说明	取值	修改说明	配置方式
节点连接跟踪表中保留的最小连接跟踪条目数	conntrack-min	用于设置Linux连接跟踪表（conntrack table）中保留的最小连接跟踪条目数。该参数确保系统始终预留指定数量的连接跟踪记录，即使当前实际连接数较低，以避免因动态分配/释放资源带来的性能开销。可通过以下命令查询： sysctl net.nf_conntrack_max	默认：131072	-	控制台/API
TCP连接在关闭状态下等待的时间	conntrack-tcp-timeout-close-wait	控制TCP连接在关闭状态下等待的时间。可通过以下命令查询： sysctl net.netfilter.nf_conntrack_tcp_timeout_close_wait	默认：1h0m0s	-	控制台/API

名称

参数

参数说明

取值

修改说明

配置方式

节点连接跟踪表中保留的最小连接跟踪条目数

conntrack-min

用于设置Linux连接跟踪表（conntrack table）中保留的最小连接跟踪条目数。该参数确保系统始终预留指定数量的连接跟踪记录，即使当前实际连接数较低，以避免因动态分配/释放资源带来的性能开销。

可通过以下命令查询：

sysctl net.nf_conntrack_max

默认：131072

控制台/API

TCP连接在关闭状态下等待的时间

conntrack-tcp-timeout-close-wait

控制TCP连接在关闭状态下等待的时间。

可通过以下命令查询：

sysctl net.netfilter.nf_conntrack_tcp_timeout_close_wait

默认：1h0m0s

控制台/API

容器引擎Docker配置（仅使用Docker的节点池可见）

名称	参数	参数说明	取值	修改说明	配置方式
容器umask值	native-umask	默认值为normal，表示启动的容器umask值为0022。	默认：normal	不支持修改	-
单容器可用数据空间	docker-base-size	设置每个容器可使用的最大数据空间。	默认：0	不支持修改	-
不安全的镜像源地址	insecure-registry	是否允许使用不安全的镜像源地址。	false	不支持修改	-
容器core文件的大小限制	limitcore	容器core文件的大小限制，单位是Byte。如果不设置大小限制，可设置为infinity。	默认：5368709120	-	控制台/API
容器内句柄数限制	default-ulimit-nofile	设置容器中可使用的句柄数上限。	默认：{soft}:{hard}	该值大小不可超过节点内核参数nr_open的值，且不能是负数。节点内核参数nr_open可通过以下命令获取： sysctl -a \| grep nr_open	控制台/API
镜像拉取超时时间	image-pull-progress-timeout	如果超时之前镜像没有拉取成功，本次镜像拉取将会被取消。	默认：1m0s	该参数在v1.25.3-r0版本开始支持	控制台/API
单次拉取镜像层的最大并发数	max-concurrent-downloads	设置拉取镜像层的最大并发数。	默认：3 取值范围为1~20	该参数如果设置过大，可能导致节点其他业务的网络性能受影响或导致磁盘IO和CPU增高。 v1.23.14-r0、v1.25.9-r0、v1.27.6-r0、v1.28.4-r0及以上版本的集群支持该参数。	控制台/API
容器日志文件轮换生成新文件的最大值	max-size	容器日志文件开始转储的最大大小。当日志文件达到这个大小时，将会触发日志轮换即关闭当前日志文件并创建新的日志文件以继续记录。	默认为50Mi 取值范围为1Mi~4096Mi	该参数如果设置过小，可能导致重要日志信息的丢失；如果设置过大，则可能占用过多的磁盘空间。 v1.23.14-r0、v1.25.9-r0、v1.27.6-r0、v1.28.4-r0及以上版本的集群支持该参数。	控制台/API
容器的日志文件个数上限	max-file	容器可以保留的日志文件的最大数量。当存在的日志文件数量超过这个值时，最旧的日志文件将被删除，以便为新的日志留出空间。	默认：20 取值范围为2~100	该参数如果设置过小，可能导致重要日志信息的丢失；如果设置过大，则可能占用过多的磁盘空间。 v1.23.14-r0、v1.25.9-r0、v1.27.6-r0、v1.28.4-r0及以上版本的集群支持该参数。	控制台/API
替代镜像仓库配置	registry-mirrors	配置一个或多个镜像仓库，以便在从容器运行时获取镜像时使用替代的镜像仓库。	默认：[] 替代的镜像仓库需要是http://或者https://开头的IP地址或域名。例如，使用自建的镜像仓库地址"http://example.com"和"https://example.com"替代默认仓库，则参数值为["http://example.com,https://example.com"]。	如果需要提高镜像拉取速度可以将替代仓库配置为本地镜像仓库。如果需要提高容错能力和可用性可以配置多个替代镜像仓库。须知：配置错误的替代镜像仓库可能导致容器无法拉取所需镜像。 v1.23.18-r10、v1.25.16-r0、v1.27.16-r0、v1.28.13-r0、v1.29.8-r0、v1.30.4-r0及以上版本的集群支持该参数。	控制台/API

容器引擎Containerd配置（仅使用Containerd的节点池可见）

名称	参数	参数说明	取值	修改说明	配置方式
容器core文件的大小限制	limitcore	容器core文件的大小限制，单位是Byte。如果不设置大小限制，可设置为infinity。	默认：5368709120	-	控制台/API
容器内句柄数限制	default-ulimit-nofile	设置容器中可使用的句柄数上限。	默认：1048576	该值大小不可超过节点内核参数nr_open的值，且不能是负数。节点内核参数nr_open可通过以下命令获取： sysctl -a \| grep nr_open	控制台/API
镜像拉取超时时间	image-pull-progress-timeout	如果超时之前镜像没有拉取成功，本次镜像拉取将会被取消。	默认：1m0s	该参数在v1.25.3-r0版本开始支持	控制台/API
insecure_skip_verify	insecure_skip_verify	跳过仓库证书验证。	默认：false	不支持修改	-
单次拉取镜像层的最大并发数	max-concurrent-downloads	设置拉取镜像层的最大并发数。	默认：3 取值范围为1~20	该参数如果设置过大，可能导致节点其他业务的网络性能受影响或导致磁盘IO和CPU增高。 v1.23.14-r0、v1.25.9-r0、v1.27.6-r0、v1.28.4-r0及以上版本的集群支持该参数。	控制台/API
容器的最大日志行大小	max-container-log-line-size	是容器的最大日志行大小（以字节为单位）。超过限制的日志行将被分成多行。	默认：16384 取值范围为1~2097152	配置增大会增加containerd内存消耗。 v1.23.14-r0、v1.25.9-r0、v1.27.6-r0、v1.28.4-r0及以上版本的集群支持该参数。	控制台/API
单容器可用数据空间	container-base-size	设置每个容器可使用的最大数据空间。	默认：0	不支持修改	-
替代镜像仓库配置	registry-mirrors	配置一个或多个镜像仓库，以便在从容器运行时获取镜像时使用替代的镜像仓库。	不配置时镜像仓库默认为docker.io，且配置SWR镜像仓库为替代镜像仓库。镜像仓库需要是IP地址或域名，替代的镜像仓库需要是http://或者https://开头的IP地址或域名。	建议添加本地镜像仓库以提高镜像拉取速度。使用多个镜像仓库以提高容错能力和可用性。 v1.23.17-r0、v1.25.12-r0、v1.27.9-r0、v1.28.7-r0、v1.29.3-r0及以上版本的集群支持该参数。须知：配置错误的镜像仓库或者替代镜像仓库可能导致容器无法拉取所需镜像。	控制台/API
跳过证书认证的镜像仓库	insecure-registries	控制指定的镜像仓库跳过对安全证书的验证，一般用于与不安全或自签名的镜像仓库建立连接。	默认为空镜像仓库需要是IP地址或域名。	仅在开发或测试环境中使用，不建议在生产环境中启用。如果使用自签名证书或无法获取有效证书的私有镜像仓库时，才考虑启用此选项。 v1.23.17-r0、v1.25.12-r0、v1.27.9-r0、v1.28.7-r0、v1.29.3-r0及以上版本的集群支持该参数。	控制台/API

父主题： 管理节点池

上一篇：更新弹性伸缩配置

下一篇：纳管节点至节点池

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消