Docker构建添加外部文件：相对路径传递语法问题求助

Hey，我来帮你搞定这个Dockerfile的路径问题！先理清楚你的场景：你的构建根目录下有Dockerfile、downloads、images、kafka这几个文件夹，现在想通过FILE_SOURCE_DIR这个ARG传递相对路径，但一直没搞对语法对吧？

1. 先确认构建上下文 #

首先要明确：你执行docker build命令的目录，就是Docker的构建上下文——所有ADD/COPY指令里的路径，都是相对于这个上下文的。所以你肯定是在那个包含Dockerfile的根目录下执行构建命令的，对吧？

2. 优化你的Dockerfile #

你的ARG定义本身没问题，但可以做两个小优化：

• 给ARG加个默认值，方便本地测试不用每次传参数；
• 把R目录下的jar包合并成一条ADD指令，减少重复代码。

修改后的Dockerfile大概是这样：

# 先定义ARG，默认用当前上下文（.），方便测试
ARG FILE_SOURCE_DIR=.

# 复制脚本
ADD ${FILE_SOURCE_DIR}/check-md5.sh /download/
# 复制app目录
ADD ${FILE_SOURCE_DIR}/app /app/
# 一次性复制R目录下所有jar包
ADD ${FILE_SOURCE_DIR}/R/*.jar /download/

3. 正确传递相对路径的构建命令 #

这是关键！执行docker build时，用--build-arg参数传递你的相对路径，注意路径是**相对于构建上下文（根目录）**的。比如你要从downloads目录取文件，就这么执行：

docker build --build-arg FILE_SOURCE_DIR=downloads -t your-image-name .

这里的.就是构建上下文（根目录），downloads是根目录下的子目录，Docker会自动识别这个相对路径，把对应文件复制到镜像里。

⚠️ 注意：Docker不允许访问构建上下文之外的目录！所以你的FILE_SOURCE_DIR必须是根目录下的子目录（比如downloads、images这些），不能是../xxx这种上级路径，这是Docker的安全限制。

4. 常见坑点排查 #

• 别画蛇添足加./前缀：比如--build-arg FILE_SOURCE_DIR=./downloads也能跑，但完全没必要，Docker会自动处理相对路径；
• ARG的作用域要注意：如果是多阶段构建，要在每个需要使用ARG的阶段重新定义，或者把ARG放在FROM指令之前（全局生效）；
• 先检查文件是否存在：构建前先在根目录下执行ls downloads/check-md5.sh，确认文件确实在你指定的路径里，避免因为文件不存在导致构建失败。

举个完整的测试例子：
假设你的Dockerfile是基于ubuntu镜像，完整代码如下：

FROM ubuntu:latest
ARG FILE_SOURCE_DIR=.
ADD ${FILE_SOURCE_DIR}/check-md5.sh /download/
ADD ${FILE_SOURCE_DIR}/app /app/
ADD ${FILE_SOURCE_DIR}/R/*.jar /download/

然后在根目录（有Dockerfile的那个目录）执行构建命令：

docker build --build-arg FILE_SOURCE_DIR=downloads -t test-md5-image .

这样就能正确把downloads目录下的文件复制到镜像对应的位置了。

内容的提问来源于stack exchange，提问作者user1071914