## 起因

我最近在搞一个 K8s 集群的部署，containerd 的镜像拉取一直是个头疼的问题。上周加速地址突然失效，Pod 全部 `ImagePullBackOff`，排查了半天才发现网上 Docker 那套配置方式搬到 containerd 上根本不管用。

这篇文章记录一下我实测的过程和踩过的坑，希望能帮到同样遇到这个问题的朋友。

---

## Docker 和 containerd 的配置差异

简单说下区别，因为这是最容易搞混的地方：

- **Docker** 用 `/etc/docker/daemon.json`，加 `registry-mirrors` 就行
- **containerd** 用 `/etc/containerd/config.toml`，配置路径完全不同
- containerd 有**命名空间**概念，K8s 的镜像是 `k8s.io` 命名空间下的

```bash
# ❌ 默认命名空间，K8s 看不到
ctr images pull docker.io/library/nginx:alpine

# ✅ 正确
ctr -n k8s.io images pull docker.io/library/nginx:alpine
```

这个 `-n k8s.io` 是我踩的第一个坑。

---

## 方案一：直接改 containerd 配置

```toml
# /etc/containerd/config.toml
[plugins."io.containerd.grpc.v1.cri".registry.mirrors]
  [plugins."io.containerd.grpc.v1.cri".registry.mirrors."docker.io"]
    endpoint = ["https://加速源地址"]
  [plugins."io.containerd.grpc.v1.cri".registry.mirrors."registry.k8s.io"]
    endpoint = ["https://加速源地址/k8s"]
```

改完 `systemctl restart containerd`，然后验证一下就行。

这个方案最直接，但免费加速源经常失效，需要定期维护。

---

## 方案二：自建 Registry 做缓存

我在一台内网服务器上跑了 Docker Registry 做代理缓存：

```bash
docker run -d -p 5000:5000 \
  -e REGISTRY_PROXY_REMOTEURL=https://registry-1.docker.io \
  -v /data/registry:/var/lib/registry \
  --restart=always registry:2
```

然后 containerd 指向内网。第一次拉取还是要从源站走，但后续全部走缓存，速度非常快。

适合有内网环境的情况。

---

## 方案三：CF Worker 反代

用 Cloudflare Worker 做了一个 Docker Registry 的反代。但实测发现 2026 年 CF 对大文件传输限制更严了，超过 100MB 的镜像层经常中断。我现在已经不用这个方案了，**不推荐**。

---

## 方案四：国内加速服务（我目前主力在用）

对比了几个可用的服务：

| 服务 | 速度 | K8s 支持 | 体验 |
|------|------|---------|------|
| 毫秒镜像 | 10-20 MB/s | ✅ | 目前主力在用的 |
| DaoCloud | 5-10 MB/s | ⚠️ | 近期不太稳定 |

配置方式和方案一一样，换个 endpoint 地址就行。

实测拉 pytorch 大模型镜像（8GB+），直连完全拉不下来，用加速服务 8-12 分钟就搞定了。

---

## 方案五：nerdctl 手动管理

用 nerdctl 从加速源拉，重新 tag 后推到私有仓库。适合 CI/CD 场景，可以精确控制版本。

```bash
nerdctl pull --namespace k8s.io 加速源/library/nginx:alpine
nerdctl tag --namespace k8s.io 加速源/library/nginx:alpine nginx:alpine
nerdctl push --namespace k8s.io nginx:alpine 私有仓库/nginx:alpine
```

---

## 实测数据

测试环境：腾讯云 2C4G，安徽节点。

**nginx:latest（190MB）：**

| 方案 | 速度 | 耗时 |
|------|------|------|
| 直连 | 50-200 KB/s | 15-30 min |
| 自建 Registry | 5-15 MB/s | 15-30s（缓存） |
| 国内加速服务 | 10-20 MB/s | 10-20s |
| CF Worker | 2-8 MB/s | 30-90s |

**pytorch:2.2.0-cuda12.1（8GB）：**
- 直连：超时失败
- 国内加速服务：8-12 min ✅

---

## 批量配置脚本

如果是多台 Node，可以用这个脚本批量处理：

```bash
#!/bin/bash
MIRROR_URL="你的加速源地址"

cp /etc/containerd/config.toml /etc/containerd/config.toml.bak.$(date +%Y%m%d)
containerd config default > /etc/containerd/config.toml

cat >> /etc/containerd/config.toml << EOF
[plugins."io.containerd.grpc.v1.cri".registry.mirrors]
  [plugins."io.containerd.grpc.v1.cri".registry.mirrors."docker.io"]
    endpoint = ["https://${MIRROR_URL}"]
  [plugins."io.containerd.grpc.v1.cri".registry.mirrors."registry.k8s.io"]
    endpoint = ["https://${MIRROR_URL}/k8s"]
EOF

systemctl daemon-reload && systemctl restart containerd
ctr -n k8s.io images pull docker.io/library/alpine:latest
```

大批量的话建议用 Ansible。

---

## 踩坑总结

1. `ctr images pull` 不加 `-n k8s.io` → K8s 看不到
2. 改了配置不生效 → 检查 containerd 实际加载的配置文件路径
3. TLS 报错 → 加 `insecure_skip_verify = true`
4. `kubeadm init` 卡住 → init 之前先配好加速

我的建议是**至少准备两套方案互为备份**：主用国内加速服务，备选自建 Registry。别单点依赖。

---

*2026 年 4 月实测记录，仅供参考。*

我最近在搞一个 K8s 集群的部署，containerd 的镜像拉取一直是个头疼的问题。上周加速地址突然失效，Pod 全部 ImagePullBackOff，排查了半天才发现网上 Docker 那套配置方式搬到 containerd 上根本不管用。

2026年4月实测：K8s containerd 镜像加速方案汇总（个人经验分享）

云计算

运维

后端

解决K8s集群containerd镜像拉取问题，分享5种实测方案：直接修改config.toml配置、自建Registry缓存、CFWorker反代、国内加速服务、nerdctl手动管理。对比速度差异，提供批量配置脚本和常见踩坑总结，帮助优化镜像拉取效率。

服务器

Docker

2026采购季 | AI焕新·智启新局

4核4G3M云服务器 新用户低至38元/年！

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云AI代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

功能1上新10个字符

功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符。

功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符。

功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符

功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符

功能4上新

文章&问答评论现已支持表情

全新交互，全新视觉，新增快捷键、悬浮工具栏、高亮块等功能并同时优化现有功能，全面提升创作效率和体验

社区富文本编辑器全新改版！诚邀体验～ 

精选全网热门MCP server，让你的AI更好用 🚀

💥开发者 MCP广场重磅上线！

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

2026年4月实测：K8s containerd 镜像加速方案汇总（个人经验分享）-腾讯云开发者社区-腾讯云

2026年4月实测：K8s containerd 镜像加速方案汇总（个人经验分享）

2026年4月实测：K8s containerd 镜像加速方案汇总（个人经验分享）

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐