Docker构建提示空间不足：VPS视频平台少量代码更新后重建失败

1. 排除构建上下文里的大文件目录 #

检查项目根目录的.dockerignore文件，确保存储视频的目录被添加到忽略列表中。比如视频存放在./video-storage，就在.dockerignore中添加：

video-storage/

这样执行docker compose build时，Docker不会将该目录的内容复制到构建上下文，彻底避免构建过程中占用大量磁盘空间。这是最快速解决当前问题的方法，因为你仅修改了少量代码，完全不需要把视频数据纳入构建流程。

2. 重构Dockerfile，分离应用与存储 #

确保你的Dockerfile中没有任何复制视频数据的指令（如COPY/ADD）。视频数据应该在容器运行时通过卷挂载的方式提供，而不是打包进镜像。镜像只保留应用程序代码和依赖，这样构建镜像时根本不会触碰视频数据，从根源上消除空间占用问题。

3. 改用Bind Mount替代Named Volume #

如果当前使用的是Docker命名卷（Named Volume），可以换成Bind Mount直接映射本地视频存储目录到容器：
在docker-compose.yaml中修改卷配置：

services:
  your-video-service:
    # ...其他配置
    volumes:
      # 替换原来的named volume为本地目录映射
      - /path/to/local/video-storage:/container/path/to/video-storage

Bind Mount不会在容器启动或构建时复制任何数据，只是做目录映射，完全避免了数据复制带来的空间消耗。

4. 优化Dockerfile的构建缓存 #

调整Dockerfile指令顺序，将不常变动的步骤（如安装依赖）放在前面，代码修改部分放在后面，让Docker充分利用构建缓存，减少重复构建的磁盘占用。示例：

FROM node:18-alpine
WORKDIR /app

# 先复制依赖文件，利用缓存
COPY package*.json ./
RUN npm install --production

# 最后复制应用代码
COPY . .
CMD ["npm", "start"]

5. 低成本对象存储替代方案（预算有限） #

如果本地存储长期有容量压力，可以考虑部署开源轻量对象存储工具MinIO，用Docker即可快速部署，兼容S3协议，迁移成本低。将视频数据迁移到MinIO后，应用直接通过API访问视频，本地仅存储应用镜像，构建时完全不涉及视频数据，彻底解决存储瓶颈。也可以选择国内云厂商的按量付费对象存储套餐，成本远低于持续扩容VPS存储。

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