当前位置：首页 > news >正文

k8s中containerd配置镜像加速

news 2026/7/24 7:40:31

针对 Kubernetes 1.30 版本（使用 kubeadm 安装）和 Containerd 运行时，配置镜像加速的最佳实践是采用 hosts.toml 的方式。

这种方式比旧版的 config.toml 内嵌配置更灵活，且支持热加载（部分修改无需重启）。鉴于当前网络环境，配置多个镜像源（国内源+备用源）非常重要。

1. 检查并修改主配置文件

首先，我们需要确保 Containerd 的主配置文件指向了正确的配置目录。

生成/检查配置文件
如果 /etc/containerd/config.toml 不存在，请先生成默认配置：
```
sudo mkdir -p /etc/containerd
containerd config default | sudo tee /etc/containerd/config.toml
```
修改 config.toml
编辑文件，找到 [plugins."io.containerd.grpc.v1.cri".registry] 部分，确保包含 config_path 设置。
```
# 编辑 /etc/containerd/config.toml
[plugins."io.containerd.grpc.v1.cri".registry]config_path = "/etc/containerd/certs.d"
```
注意：如果文件中没有这一段，直接添加即可。

2. 配置 Docker Hub 镜像加速

Docker Hub 是最常用的源，建议配置多个加速地址以防某个失效。

创建目录

sudo mkdir -p /etc/containerd/certs.d/docker.io

创建 hosts.toml
创建文件 /etc/containerd/certs.d/docker.io/hosts.toml，填入以下内容（这里配置了多个目前可用的源）：

# /etc/containerd/certs.d/docker.io/hosts.toml
server = "https://docker.io"# 镜像源 1
[host."https://docker.m.daocloud.io"]capabilities = ["pull", "resolve"]# 镜像源 2 (备用)
[host."https://docker.1panel.live"]capabilities = ["pull", "resolve"]# 镜像源 3 (备用)
[host."https://hub.rat.dev"]capabilities = ["pull", "resolve"]

3. 配置 K8s 官方镜像仓库加速

K8s 1.30 的核心组件（如 pause, coredns, kube-apiserver）默认从 registry.k8s.io 拉取，这个源在国内非常慢，必须配置加速。

sudo mkdir -p /etc/containerd/certs.d/registry.k8s.io

创建 hosts.toml
创建文件 /etc/containerd/certs.d/registry.k8s.io/hosts.toml：
```
# /etc/containerd/certs.d/registry.k8s.io/hosts.toml
server = "https://registry.k8s.io"[host."https://k8s.m.daocloud.io"]capabilities = ["pull", "resolve"]
```
注：如果你使用的是阿里云等云厂商的 K8s 镜像源，也可以将 host 地址替换为阿里云的对应地址。

4. 重启服务并验证

配置完成后，需要重启 Containerd 以确保主配置文件的更改生效（虽然 hosts.toml 支持热更新，但重启是最稳妥的方式）。

重启 Containerd

sudo systemctl daemon-reload
sudo systemctl restart containerd

验证配置
使用 crictl 命令（K8s 推荐工具）拉取镜像测试。

测试 Docker Hub：
```
crictl pull nginx:latest
```
测试 K8s 镜像：
```
crictl pull registry.k8s.io/pause:3.9
```
如果看到 Image is up to date 或 Downloaded 且速度较快，说明配置成功。