确认 Docker 与 Buildx 可用
先启动 Docker,再执行以下命令。docker-container 使用独立的 BuildKit 容器,仍需单独配置镜像源。
docker info
docker buildx version适合 Linux、macOS 或 Windows 的 WSL / Bash 环境。为 docker-container 构建器单独配置镜像源,无需修改 Dockerfile 中的基础镜像名称。
docker.1ms.run先启动 Docker,再执行以下命令。docker-container 使用独立的 BuildKit 容器,仍需单独配置镜像源。
docker info
docker buildx version在执行 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-builder0BuildKit 启动前,由 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.io 会自动补全 library/;未指定标签时 Docker 默认使用 latest;非 library 官方镜像请写完整命名空间。
docker pull nginxdocker pull docker.1ms.run/library/nginx:latest免费用户也可使用 ghcr.io 通道,需将域名前缀替换为 ghcr.1ms.run。
docker pull ghcr.io/linuxserver/webtop:latestdocker pull ghcr.1ms.run/linuxserver/webtop:latest付费通道支持 registry.k8s.io,不会自动补全 library/。
docker pull registry.k8s.io/pause:3.10docker pull k8s.1ms.run/pause:3.10Compose 文件只需要替换 image 字段中的域名前缀。
image: ghcr.io/linuxserver/webtop:latestimage: ghcr.1ms.run/linuxserver/webtop:latest新机器可先安装 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,并创建 /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需要更多帮助? 查看完整使用文档