文档中心

容器服务

请输入

节点池

配置节点池 Containerd 参数

容器服务 VKE 支持自定义节点池的 Containerd 参数，以满足镜像拉取加速、安全认证和并发性能调优等需求。本文介绍支持的 Containerd 配置项、使用限制及配置方式。

使用限制

节点池自定义 Containerd 配置，仅对新扩容的节点和新添加的节点生效。

支持的 Containerd 配置

配置项	说明	配置建议
容器镜像仓库代理（RegistryProxyConfigs）	容器镜像仓库代理配置，便于容器运行时（Container runtime）拉取容器镜像时使用替代的镜像仓库，加速镜像拉取。容器镜像仓库：容器镜像仓库地址。格式为不带协议的域名或 IP 地址，可以携带端口号。例如：example.com或example.com:8080。代理地址：代理地址。格式为带协议的域名或 IP 地址，可以携带端口号。例如：https://example.com或https://example.com:8080。	推荐使用镜像仓库（CR）产品的远端代理仓能力配置 VKE 的容器镜像仓库代理，请参见通过远端代理仓域名拉取 Docker Hub 官方镜像。
跳过证书认证的容器镜像仓库（Insecure Registries）	指定跳过证书认证的容器镜像仓库地址。Container runtime 拉取容器镜像时，会跳过该镜像仓库的安全证书校验。格式为不带协议的域名或 IP 地址，可以携带端口号，例如：example.com或example.com:8080。	跳过证书认证一般用于测试环境中从采用自签名证书的容器镜像仓库拉取容器镜像的场景。建议不要在业务环境中使用。
自定义参数
max_concurrent_downloads	Containerd 单次拉取镜像时可并发下载的镜像层最大数量。正整数形式，默认值为 3。未配置时，系统使用默认值。说明仅 Containerd 为 v2.1.0 及以上版本时，支持配置该参数。	建议保留默认值，在需要加快多层镜像拉取，且节点网络带宽、磁盘 I/O 和镜像仓库限流能力充足时，可增大该值。
max_concurrent_unpacks	Containerd 同时解压镜像层的最大数量。正整数形式，默认值为 1。仅在use_local_image_pull配置为关闭时生效。说明仅 Containerd 为 v2.2.0 及以上版本时，支持配置该参数。	增大该值可提高镜像层解压并发能力，但也会增加节点的 CPU 和磁盘 I/O 压力，建议结合节点规格和业务负载进行压测后逐步调整。
concurrent_layer_fetch_buffer	并发分块拉取单个镜像层时使用的缓冲区大小。正整数形式，单位为 Byte。说明仅 Containerd 为 v2.1.0 及以上版本时，支持配置该参数。	建议按需配置。增大该值可能提高大镜像层的拉取吞吐，但会增加 Containerd 的内存占用；请结合镜像大小、网络带宽和节点可用内存进行压测，避免因设置过大导致节点内存压力升高。
use_local_image_pull	Containerd 的镜像拉取模式。开启：（默认值）使用本地客户端拉取镜像。关闭：使用 Transfer Service 拉取镜像。说明仅 Containerd 为 v2.1.0 及以上版本时，支持配置该参数。	该参数关闭时，无法使用 Nydus 镜像懒加载功能，请确认节点未使用相关能力后再调整。

自定义 Containerd 配置

创建集群时配置

您可以在创建集群时，进行 Containerd 配置。

在 ②节点池配置步骤中的高级配置模块下自定义 Containerd 配置。详细的操作步骤，请参见创建集群。

创建节点池时配置

您可以在集群中创建新的节点池时，自定义 Containerd 配置。

在 ①节点池配置步骤中的高级配置模块下自定义 Containerd 配置。详细的操作步骤，请参见创建节点池、创建托管节点池。

配置存量节点池

您可以为集群中的存量节点池配置 Containerd 参数。

说明

在存量节点池中自定义 Containerd 配置时，目前仅对该节点池中新扩容出的节点生效，暂不对存量节点生效。

在节点池页面的目标节点池操作列中，选择... > Containerd 配置，自定义 Containerd 配置。详细的操作步骤，请参见管理节点池。

最近更新时间：2026.09.30 16:34:41

这个页面对您有帮助吗？

有用

无用