docker build --build-arg 传递构建参数

把外部值传给 Dockerfile 里声明的 ARG：版本号、镜像变体、环境标识等；CI 里常与流水线变量组合。

Docker 容器速查云更新于 2026-10-12

用途	传构建期参数值
语法	docker build --build-arg KEY=VALUE .
生效前提	Dockerfile 中已用 ARG 声明

示例

docker build --build-arg APP_VERSION=1.2.3 --build-arg BASE=node:22-alpine -t app/web:1.2.3 .
docker build --build-arg APP_VERSION=$CI_COMMIT_TAG -t app/web:$CI_COMMIT_TAG .

参数值会进入镜像构建历史；token、密码类值请改用 --secret（见构建期机密条目）。

易错点

值里有空格要用引号包住，否则 shell 先拆分，参数传递不完整
传了 Dockerfile 未声明的参数不会生效（可能有 warning），参数不生效先检查 ARG 声明与拼写

数据来源与参考

Docker 官方 CLI 参考：docker build --build-arg（docs.docker.com）

继续搜索

常用关键词：3389 traceroute iptables 子网掩码 docker

‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌