Docker COPY指令未复制文件问题排查（BotPress镜像异常）

问题根源 #

BotPress官方镜像（如botpress/server:v12_31_5）大概率在Dockerfile中使用了VOLUME指令，将特定目录（比如插件、数据目录）声明为可挂载卷。构建镜像时COPY的文件确实会写入镜像层，但容器启动时，Docker会自动为这些VOLUME目录挂载匿名卷，覆盖掉镜像层中原本的文件，导致进入容器后看不到内容。而Ubuntu镜像没有这类预设的VOLUME，所以COPY的文件能正常保留。

具体解决步骤 #

• 检查镜像的VOLUME配置
  执行命令查看目标镜像的VOLUME定义：

  docker inspect botpress/server:v12_31_5 | grep -A 10 "Volumes"
  

  如果输出中包含你COPY的目标路径（比如/actions），就说明该路径被声明为VOLUME，这就是问题所在。

• 更换COPY的目标路径
  将文件复制到镜像未声明为VOLUME的目录，比如：

  FROM botpress/server:v12_31_5
  USER root
  # 复制到未被VOLUME占用的路径
  COPY actions /botpress-custom-actions
  COPY entrypoint.sh /botpress-custom-entrypoint.sh
  RUN chmod +x /botpress-custom-entrypoint.sh
  

  之后根据BotPress文档，调整配置让它加载这个自定义路径下的actions。

• 自定义启动脚本（可选）
  如果需要将文件放到BotPress默认的加载目录，可以先把文件复制到临时路径，再在启动脚本中同步到目标目录，最后调用原镜像的启动命令：

  1. 先通过docker inspect找到原镜像的ENTRYPOINT：

     docker inspect botpress/server:v12_31_5 | grep -A 5 "Entrypoint"
     

  2. 编写自定义entrypoint.sh：

     #!/bin/bash
     # 将临时目录的文件同步到目标路径
     cp -r /tmp/actions/* /actions/
     # 执行原镜像的启动命令
     exec /usr/bin/entrypoint.sh "$@"
     

  3. 修改Dockerfile：

     FROM botpress/server:v12_31_5
     USER root
     COPY actions /tmp/actions
     COPY entrypoint.sh /tmp/entrypoint.sh
     RUN chmod +x /tmp/entrypoint.sh
     ENTRYPOINT ["/tmp/entrypoint.sh"]
     

• 验证构建阶段的COPY结果
  构建时添加--no-cache避免缓存干扰，同时在Dockerfile中加入验证命令，确认文件已被复制到镜像层：

  FROM botpress/server:v12_31_5
  USER root
  COPY actions /actions
  COPY entrypoint.sh /entrypoint.sh
  # 验证文件是否存在
  RUN ls -l /actions && ls -l /entrypoint.sh
  

  如果构建时能看到文件列表，说明问题出在容器启动阶段的VOLUME覆盖，而非构建阶段的COPY失败。

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