BuildKit / Buildx 镜像加速配置

适合 Linux、macOS 或 Windows 的 WSL / Bash 环境。为 docker-container 构建器单独配置镜像源,无需修改 Dockerfile 中的基础镜像名称。

免费使用
Docker Hub
docker.1ms.run

操作步骤

确认 Docker 与 Buildx 可用

先启动 Docker,再执行以下命令。docker-container 使用独立的 BuildKit 容器,仍需单独配置镜像源。

docker info
docker buildx version

创建 BuildKit 配置文件

在执行 Docker CLI 的机器上保存以下配置。mirrors 使用本页选定的域名,不带 https:// 或 /v2/;debug 用于后续检查请求地址。如果已有同名文件,请合并配置,避免覆盖或重复声明 docker.io 配置段。

mkdir -p "$HOME/.config/buildkit"
cat > "$HOME/.config/buildkit/1ms.toml" <<'EOF'
debug = true

[registry."docker.io"]
  mirrors = ["docker.1ms.run"]
EOF

创建并启用构建器

加载配置并启动 1ms-builder,然后确认驱动为 docker-container、节点状态为 running。如果同名构建器已存在,请换一个名称,并同步修改后续命令中的构建器名和容器名。

docker buildx create \
  --name 1ms-builder \
  --driver docker-container \
  --buildkitd-config "$HOME/.config/buildkit/1ms.toml" \
  --use \
  --bootstrap
docker buildx inspect 1ms-builder --bootstrap

构建测试镜像

直接从标准输入读取 Dockerfile。--builder 指定刚创建的构建器,--pull 尝试拉取基础镜像,--load 将单平台构建结果加载到本机 Docker。

docker buildx build \
  --builder 1ms-builder \
  --pull \
  --progress=plain \
  --load \
  -t 1ms-buildkit-test:latest - <<'EOF'
FROM alpine:latest
RUN echo "1ms BuildKit mirror test"
EOF

验证配置

确认测试镜像存在、容器内的 mirrors 与本页所选地址一致,并在调试日志中确认该域名的请求及响应成功。构建输出仍显示 docker.io/library/alpine 属于正常现象;仅构建成功不能证明已使用加速。

docker image inspect 1ms-buildkit-test:latest
docker exec buildx_buildkit_1ms-builder0 cat /etc/buildkit/buildkitd.toml
docker logs --since 10m buildx_buildkit_1ms-builder0
遇到问题?查看排查方法

启动时拉取 moby/buildkit 超时

BuildKit 启动前,由 Docker 拉取构建器镜像,此时 TOML 尚未生效。先配置 Docker 的镜像源,或在创建构建器的命令中增加 --driver-opt image=docker.1ms.run/moby/buildkit:buildx-stable-1,并保留 --buildkitd-config。

在实际项目中使用

在 Dockerfile 所在目录执行以下命令。docker build 默认使用 Docker Engine 自带的构建器,请显式选择 1ms-builder。

docker buildx build --builder 1ms-builder --load -t myapp:latest .

修改配置或切换加速地址后没有生效

本地 TOML 在创建时传入,并非持续挂载。切换公共地址或专属域名后,请更新配置文件,使用新名称创建构建器,再用 --builder 新名称验证。排查完成后也可关闭 debug,再按此方式应用配置。

专属域名访问失败

确认域名对应 docker.io、已启用且未过期,并检查资源包或余额。IP 白名单应允许实际运行 BuildKit 的机器访问,远程构建器的出口 IP 可能与本机不同。

公共地址参考

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

支持镜像源与通道
源站替换为替换域名通道
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/;未指定标签时 Docker 默认使用 latest;非 library 官方镜像请写完整命名空间。

原命令docker pull nginx
加速后docker pull docker.1ms.run/library/nginx:latest

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:3.10
加速后docker pull k8s.1ms.run/pause:3.10

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

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