| 语法 | ARG NAME[=默认值]；配合 docker build --build-arg NAME=值 |
|---|---|
| 作用域 | 从声明处到该构建阶段结束；每阶段重新声明 |
| 与 ENV | ARG 仅构建期；ENV 持久进入镜像，可被 ARG 赋值 |
| 安全 | 值可从 docker history 读出：敏感数据用 BuildKit --secret |
镜像源参数示例
镜像源参数示例
# Dockerfile
ARG NPM_REGISTRY=https://registry.npmmirror.com
RUN npm config set registry "$NPM_REGISTRY"
# 构建时覆盖
docker build --build-arg NPM_REGISTRY=https://registry.npmjs.org -t app:dev .构建失败信息里回显 ARG 值：CI 日志中带 token 的 ARG 会一并泄露，改用 --secret 挂载。