K8s / Containerd 配置

适合 Kubernetes、K3s、使用 containerd 的节点。先确认 containerd 版本，再选择对应配置方式。

Docker Hub: docker.1ms.run
GHCR: ghcr.1ms.run

开始之前

确认 containerd 版本

1.5 之前使用 mirrors；1.5 及以后使用 certs.d/hosts.toml 目录化配置。

containerd --version

1.5 及以后

使用 certs.d/hosts.toml 配置。

配置 config_path

containerd 1.5+ 需要确认 config.toml 指向 certs.d。

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

创建镜像源目录

仅为 Docker Hub 和 GHCR 配置免费公共镜像源。

BASE=/etc/containerd/certs.d

mkdir -p "$BASE/docker.io"

mkdir -p "$BASE/ghcr.io"

配置 hosts.toml

仅为 Docker Hub 和 GHCR 配置免费公共镜像源。

# /etc/containerd/certs.d/docker.io/hosts.toml
server = "https://registry-1.docker.io"
[host."https://docker.1ms.run"]
  capabilities = ["pull", "resolve"]

# /etc/containerd/certs.d/ghcr.io/hosts.toml
server = "https://ghcr.io"
[host."https://ghcr.1ms.run"]
  capabilities = ["pull", "resolve"]

重启并验证

重启 containerd 后，拉取 Docker Hub 镜像验证配置。

systemctl restart containerd

crictl pull docker.io/library/redis:7-alpine

1.5 之前

使用 config.toml 中的 mirrors 配置。

Containerd 1.5 之前

仅为 Docker Hub 和 GHCR 配置免费公共镜像源。

[plugins."io.containerd.grpc.v1.cri".registry]
  [plugins."io.containerd.grpc.v1.cri".registry.mirrors]

    [plugins."io.containerd.grpc.v1.cri".registry.mirrors."docker.io"]
      endpoint = ["https://docker.1ms.run"]

    [plugins."io.containerd.grpc.v1.cri".registry.mirrors."ghcr.io"]
      endpoint = ["https://ghcr.1ms.run"]

重启并检查旧版配置

Containerd 1.5 之前配置完成后需要重启服务并检查状态。

systemctl restart containerd
systemctl status containerd

验证配置

运行以下命令，确认镜像下载成功。若失败，请核对 containerd 版本、配置路径及镜像地址。

crictl pull docker.io/library/redis:7-alpine

公共地址参考

以下是公共地址示例。使用专属域名时，请复制上方引导步骤中生成的内容。

支持镜像源与通道

源站替换为替换域名通道

docker.iodocker.1ms.run可选免费、付费

ghcr.ioghcr.1ms.run必须免费、付费

gcr.iogcr.1ms.run必须付费

registry.k8s.iok8s.1ms.run必须付费

nvcr.ionvcr.1ms.run必须付费

quay.ioquay.1ms.run必须付费

mcr.microsoft.commcr.1ms.run必须付费

docker.elastic.coelastic.1ms.run必须付费

镜像地址替换示例

Docker Hub 镜像

仅 docker.io 会自动补全 library/ 和 latest；非 library 官方镜像请写完整命名空间。

原命令docker pull nginx

加速后docker pull docker.1ms.run/nginx

GitHub Container Registry

免费用户也可使用 ghcr.io 通道，需将域名前缀替换为 ghcr.1ms.run。

原命令docker pull ghcr.io/linuxserver/webtop:latest

加速后docker pull ghcr.1ms.run/linuxserver/webtop:latest

Kubernetes 镜像源

付费通道支持 registry.k8s.io，不会自动补全 library/。

原命令docker pull registry.k8s.io/pause

加速后docker pull k8s.1ms.run/pause

Docker Compose

Compose 文件只需要替换 image 字段中的域名前缀。

原命令image: ghcr.io/linuxserver/webtop:latest

加速后image: ghcr.1ms.run/linuxserver/webtop:latest

安装与登录命令

一键安装 Docker

新机器可先安装 Docker，并将默认镜像源配置为毫秒镜像。

bash <(curl -f -s --connect-timeout 10 --retry 3 https://linuxmirrors.cn/docker.sh) --source mirrors.tencent.com/docker-ce --source-registry docker.1ms.run --protocol https --install-latested true --close-firewall false --ignore-backup-tips

一键安装 Docker Compose

安装最新 docker-compose，并创建 /usr/bin/docker-compose 软链接。

sudo curl -L "https://1ms.run/install/docker-compose/latest/$(uname -s)/$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose
sudo ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose

助手登录

推荐付费用户使用，会按提示完成账号配置和加速配置。

bash <(curl -sSL https://n3.ink/helper)

原版登录

用户名使用 1ms，密码使用用户中心创建的 Docker 密钥。

docker login docker.1ms.run

需要更多帮助？查看完整使用文档