containerd 2.x 接入 Harbor 私有仓库：避坑配置全指南

首页

科技数码

热心网友

转载

2025-12-23

本文将指导你如何在 containerd 2.x 版本中配置容器镜像仓库，以 Harbor 仓库的配置为例。

如今，不少操作系统在安装 containerd 时，若未明确指定，默认会采用 2.x 版本。其配置镜像仓库的方式与 1.x 版本有所不同。如果你的 containerd 仍是 1.x 版本，可以参考我之前的文章进行配置：

《快速配置 Containerd 镜像加速（附最新可用加速地址）》

接下来，我们将演示如何在 containerd 2.x 版本中配置镜像仓库，这里以 Harbor 仓库为例。

1. 配置结构

containerd 2.x 版本的所有镜像仓库配置均位于 /etc/containerd/certs.d/ 目录下。

其配置结构如下：

一个 registry 域名对应一个目录
一个目录内包含一个 hosts.toml 文件
在 hosts.toml 文件中定义：服务器地址、认证信息、以及是否跳过证书验证

2. 配置实战

首先，确认你的 containerd 是否为 2.x 版本：

[root@k8s-master ~]# containerd --version
containerd containerd.io v2.2.0 1c4457e00facac03ce1d75f7b6777a7a851e5c41

创建对应的配置目录：

mkdir -p /etc/containerd/certs.d/harbor.liyb.com

目录名称必须与镜像操作中使用的 registry 地址完全一致。如果没有使用域名，直接使用 IP 地址作为目录名也是可以的。

创建 hosts.toml 配置文件：

vi /etc/containerd/certs.d/harbor.liyb.com/hosts.toml

添加以下配置内容：

server = "https://harbor.liyb.com"

[host."https://harbor.liyb.com"]
  capabilities = ["pull", "resolve", "push"]
  skip_verify = true

  [host."https://harbor.liyb.com".auth]
    username = "admin"
    password = "Harbor12345"

由于我使用的是自签名证书，因此设置了跳过验证 (skip_verify = true)。如果你使用的是企业级有效证书，则无需设置此项，只需将 CA 证书文件放入 /etc/containerd/certs.d/harbor.liyb.com/ 目录即可。

接下来，需要去主配置文件 config.toml 中确认 config_path 的配置路径：

# /etc/containerd/config.toml
[plugins."io.containerd.grpc.v1.cri".registry]
  config_path = "/etc/containerd/certs.d"

containerd 2.x 版本通常默认开启此配置，但在生产环境中务必进行检查确认。

3. 验证方式

可以使用 nerdctl 命令行工具进行验证：

nerdctl pull harbor.liyb.com/prod/nginx:1.27

也可以在 Kubernetes 节点上使用 crictl 验证：

crictl pull harbor.liyb.com/prod/nginx:1.27

请注意，镜像名称必须显式包含完整的 registry 地址。

4. 最容易踩的几个坑

hosts.toml 配置不生效 → 目录名称写错（域名或端口不一致）。

HTTP 仓库拉不下来 → 忘了写 https:// 协议头。

K8s Pod 拉不到镜像 → Image 字段没写 registry 地址。

误以为 daemon.json 生效 → containerd 不读取 Docker 的配置。

来源:https://www.51cto.com/article/832554.html

免责声明：游乐网为非赢利性网站，所展示的游戏/软件/文章内容均来自于互联网或第三方用户上传分享，版权归原作者所有，本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容，请联系youleyoucom@outlook.com。

上一篇：暗网AI工具DIG AI如何助长威胁分子的复杂网络攻击下一篇：Redis缓存满了怎么办？三种有效清理策略详解

相关攻略

AI资讯

Ubuntu系统安装OpenClaw详细步骤教程

第一步：彻底卸载旧版 Node js 为确保安装过程顺利，避免版本冲突，我们首先需要完全移除系统中可能存在的旧版本 Node js 及其关联组件。请打开终端，依次执行以下命令： apt remove --purge -y nodejs libnode-dev npm 该命令将彻底卸载 Node j

热心网友

05.20

AI资讯

OpenClaw自动化部署指南与实战教程

想在Windows上快速部署OpenClaw吗？这个PowerShell脚本能帮你搞定从环境检查到配置向导的全过程。脚本版本是1 0，发布日期是2026年3月27日，设计目标就是让安装变得省心。脚本启动与欢迎信息运行脚本后，你会首先看到一条醒目的彩色分隔线，以及“OpenClaw 一键安装脚本”

热心网友

05.20

科技数码

中国电子发布全新国产数据库系统

近日，国产数据库领域迎来重大进展。中国电子旗下达梦数据正式推出四款核心新品，涵盖新一代数据库管理系统DM9、新一代数据库一体机DAMENG PAI V2 0、启云数据库V4 0以及图数据库GDMBASE V4 0。此次发布全面覆盖集中式、分布式、云原生、一体机及图数据库等关键应用场景，标志着国产数据

热心网友

05.17