如何通过Dockerfile将SharePoint中的大文件添加/挂载至Docker容器

一、先明确ADD命令中路径的含义 #

你看到的ADD http://example.com/big.tar.xz /usr/src/things/里，/usr/src/things/是容器内部的目标路径，和本地代码仓库无关：

• 当ADD的源是本地文件/文件夹时，才会用到相对于Dockerfile所在目录的路径（比如ADD ./local-dir /usr/src/things/里的./local-dir）；
• 当源是HTTP/HTTPS链接时，Docker会直接把下载的文件放到容器内的/usr/src/things/路径下，同时如果是tar.gz/xz这类压缩包，会自动解压到该目录。

二、从SharePoint添加1GB大文件夹的两种方法 #

方法1：构建时将文件加入镜像（不推荐大文件场景） #

如果必须把文件打包进镜像，建议先将SharePoint文件夹打包成压缩包（比如tar.gz），再通过Dockerfile下载，原因是：

• 单个压缩包下载比多个文件逐个下载效率更高；
• 避免镜像中残留冗余文件，减小镜像体积。

步骤&命令：

1. 获取SharePoint压缩包的可下载链接：需要生成带权限的直接下载URL（SharePoint默认分享链接可能需要跳转，可通过浏览器开发者工具抓包获取，或用SharePoint API生成）。
2. 在Dockerfile中添加下载逻辑：
   • 若链接公开无需权限：

     # 下载并自动解压到容器内目标路径
     ADD https://your-sharepoint-direct-url/big-folder.tar.gz /usr/src/things/
     

   • 若链接需要权限（比如Bearer令牌）：ADD不支持自定义请求头，改用curl下载并即时解压：

     # 安装curl（基于Debian/Ubuntu镜像的例子）
     RUN apt-get update && apt-get install -y curl && rm -rf /var/lib/apt/lists/*
     # 下载并解压到目标路径，避免留下压缩包
     RUN curl -L -H "Authorization: Bearer YOUR_VALID_TOKEN" "https://your-sharepoint-direct-url/big-folder.tar.gz" | tar -xz -C /usr/src/things/
     

方法2：运行时挂载卷（推荐大文件场景） #

对于1GB的大文件，挂载卷是更优选择，原因：

• 镜像体积不会被大文件撑大，构建、推送、拉取速度更快；
• 文件可独立于镜像更新，无需重新构建镜像；
• 支持跨容器共享、持久化存储。

步骤&命令：

1. 先将SharePoint文件夹下载到宿主机或共享存储：比如下载到宿主机的/host/storage/big-folder路径。
2. 挂载卷运行容器：
   • 直接挂载宿主机路径（简单直接）：

     docker run -d -v /host/storage/big-folder:/usr/src/things/ your-image:latest
     

   • 使用命名卷（适合持久化或跨容器共享）：

     # 1. 创建命名卷
     docker volume create big-folder-vol
     # 2. 将本地下载的文件夹复制到命名卷（用临时busybox容器完成）
     docker run --rm -v big-folder-vol:/mnt -v /host/storage/big-folder:/source busybox cp -r /source/. /mnt/
     # 3. 运行容器时挂载命名卷
     docker run -d -v big-folder-vol:/usr/src/things/ your-image:latest
     

三、两种方案的对比选择 #

总结：如果大文件是容器运行的核心依赖（比如启动必须加载的静态资源）且极少更新，可选择构建时加入；绝大多数场景下，优先用卷挂载方案。

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