本站支持搜索的镜像仓库:Docker Hub、gcr.io、ghcr.io、quay.io、k8s.gcr.io、registry.gcr.io、elastic.co、mcr.microsoft.com

docker-with-buildx 是一个在 Docker 容器中预装了 Docker Buildx 的镜像。它实现了"Docker-in-Docker"(DinD)模式,将 Buildx 工具直接集成到容器环境中,主要用途是便捷地在隔离环境中运行各类 docker buildx 命令,无需在宿主机系统直接安装 Docker 或 Buildx 依赖。
docker buildx 命令docker buildx 命令(如 build、create、use、inspect 等)通过以下命令可直接在当前目录执行镜像构建,使用默认 Buildx 配置:
docker run --rm \ -e DOCKER_TLS_CERTDIR=/certs \ # 指定 TLS 证书目录(默认配置) -v /var/run/docker.sock:/var/run/docker.sock \ # 挂载宿主机 Docker 套接字,实现与宿主机 Docker 通信 -v $(pwd):$(pwd) -w $(pwd) \ # 挂载当前工作目录到容器内相同路径,并设置为工作目录 maniator/docker-with-buildx \ build . # 执行 Buildx 构建命令(当前目录下的 Dockerfile)
参数说明:
--rm:容器退出后自动删除-e DOCKER_TLS_CERTDIR=/certs:设置 TLS 证书目录环境变量,适配 Docker 安全配置-v /var/run/docker.sock:/var/run/docker.sock:关键挂载项,使容器内的 Docker 客户端能控制宿主机 Docker 守护进程-v $(pwd):$(pwd) -w $(pwd):确保容器内构建上下文与宿主机当前目录一致,避免路径问题若需在多次容器运行间共享 Buildx 配置(如自定义构建器实例),可通过挂载卷持久化配置目录。以下示例创建并使用自定义构建器:
# 定义 Buildx 配置存储路径(默认使用宿主机 Docker 配置目录下的 buildx 子目录) DOCKER_CONFIG=${DOCKER_CONFIG:-$HOME/.docker} BUILDX_DIR="$DOCKER_CONFIG/buildx" mkdir -p $BUILDX_DIR # 确保目录存在
docker run --rm \ -e DOCKER_TLS_CERTDIR=/certs \ -v /var/run/docker.sock:/var/run/docker.sock \ -v $BUILDX_DIR:/env_configs/.docker/buildx \ # 挂载持久化配置目录到容器内 Buildx 配置路径 -v $(pwd):$(pwd) -w $(pwd) \ maniator/docker-with-buildx \ create --driver docker-container --name my_builder --use # 创建名为 my_builder 的构建器并设为默认
docker run --rm \ -e DOCKER_TLS_CERTDIR=/certs \ -v /var/run/docker.sock:/var/run/docker.sock \ -v $BUILDX_DIR:/env_configs/.docker/buildx \ # 复用之前的配置目录 -v $(pwd):$(pwd) -w $(pwd) \ maniator/docker-with-buildx \ --builder=my_builder build . # 指定使用 my_builder 构建器执行构建
说明:通过挂载 $BUILDX_DIR:/env_configs/.docker/buildx,容器内的 Buildx 配置会持久化到宿主机的 $BUILDX_DIR 目录,后续运行容器时可直接复用已创建的构建器(如 my_builder)。
| 环境变量 | 作用 | 默认值 |
|---|---|---|
DOCKER_TLS_CERTDIR | 指定 Docker TLS 证书存储目录 | /certs |
免费版仅支持 Docker Hub 加速,不承诺可用性和速度;专业版支持更多镜像源,保证可用性和稳定速度,提供优先客服响应。
免费版仅支持 docker.io;专业版支持 docker.io、gcr.io、ghcr.io、registry.k8s.io、nvcr.io、quay.io、mcr.microsoft.com、docker.elastic.co 等。
当返回 402 Payment Required 错误时,表示流量已耗尽,需要充值流量包以恢复服务。
通常由 Docker 版本过低导致,需要升级到 20.x 或更高版本以支持 V2 协议。
先检查 Docker 版本,版本过低则升级;版本正常则验证镜像信息是否正确。
使用 docker tag 命令为镜像打上新标签,去掉域名前缀,使镜像名称更简洁。
探索更多轩辕镜像的使用方法,找到最适合您系统的配置方式
通过 Docker 登录方式配置轩辕镜像加速服务,包含7个详细步骤
在 Linux 系统上配置轩辕镜像源,支持主流发行版
在 Docker Desktop 中配置轩辕镜像加速,适用于桌面系统
在 Docker Compose 中使用轩辕镜像加速,支持容器编排
在 k8s 中配置 containerd 使用轩辕镜像加速
在宝塔面板中配置轩辕镜像加速,提升服务器管理效率
在 Synology 群晖NAS系统中配置轩辕镜像加速
在飞牛fnOS系统中配置轩辕镜像加速
在极空间NAS中配置轩辕镜像加速
在爱快ikuai系统中配置轩辕镜像加速
在绿联NAS系统中配置轩辕镜像加速
在威联通NAS系统中配置轩辕镜像加速
在 Podman 中配置轩辕镜像加速,支持多系统
配置轩辕镜像加速9大主流镜像仓库,包含详细配置步骤
无需登录即可使用轩辕镜像加速服务,更加便捷高效
需要其他帮助?请查看我们的 常见问题 或 官方QQ群: 13763429