Docker Build（BuildKit）中如何挂载主机目录作为构建缓存？

推荐方案：使用BuildKit内置缓存管理（无需主机目录挂载） #

这种方式无需依赖主机特定目录，由BuildKit自动维护缓存卷，既优雅又适配CI环境的临时主机特性。

修改你的Dockerfile，在RUN命令中加入--mount=type=cache参数：

FROM node:18

WORKDIR /app
ADD package.json yarn.lock .
# 挂载BuildKit缓存卷到/tmp/yarn，指定唯一id确保缓存复用
RUN --mount=type=cache,target=/tmp/yarn,id=yarn-cache,sharing=locked \
    YARN_CACHE_FOLDER=/tmp/yarn yarn --frozen-lockfile
...

说明：

• type=cache：告知BuildKit这是缓存挂载，后续构建会自动复用缓存
• id=yarn-cache：给缓存卷设置唯一标识，避免不同项目缓存混淆
• sharing=locked：确保同一时间仅一个构建进程使用缓存，防止冲突
• 无需额外buildx参数，只要CI环境启用了BuildKit（docker buildx默认已启用），缓存就会自动生效

备选方案：直接挂载主机目录（仅当必须使用主机缓存时） #

如果确实需要挂载主机上的特定Yarn缓存目录，可使用type=bind挂载方式，但需处理权限问题（CI环境中主机用户和容器用户可能不一致）。

1. 修改Dockerfile

FROM node:18

WORKDIR /app
ADD package.json yarn.lock .
# 绑定主机目录到容器内的/tmp/yarn
RUN --mount=type=bind,source=/path/on/host/yarn-cache,target=/tmp/yarn \
    YARN_CACHE_FOLDER=/tmp/yarn yarn --frozen-lockfile
...

2. 构建前配置主机目录权限

node镜像默认使用node用户（UID通常为1000），需确保主机缓存目录对该用户有读写权限：

mkdir -p /path/on/host/yarn-cache
chown -R 1000:1000 /path/on/host/yarn-cache

3. 执行buildx构建

docker buildx build -t your-image-tag .

注意：

这种方式依赖主机本地目录，若CI环境主机为临时实例，缓存无法跨构建复用，因此不推荐作为常规方案。

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