Docker挂载卷运行Node.js开发：文件未同步与异常目录问题

问题情况 #

• Node.js开发场景下，尝试用Docker挂载宿主机卷实现文件同步，但宿主机文件无法同步到容器内
• 尚未启动Node服务，仅调试挂载逻辑
• 容器/node/目录下自动生成了app和src目录

现有配置 #

Dockerfile #

FROM node:18

WORKDIR /node/
#COPY ./package.json ./package.json

# RUN npm install

COPY . ./node

EXPOSE 3000

# CMD [ "node", "app.js" ]

RUN ["apt-get", "update"]
RUN ["apt-get", "install", "nano"]

CMD [ "npm", "run" , "start" ]
#CMD tail -f /dev/null

Docker Compose #

version: '3.8'  #specifies docker compose version
services:
  web:
    build:
      context: .
      dockerfile: ./Dockerfile
    volumes:
      - /var/www/node/dram/:/node/
    ports:
      - "3000:3000"
    environment:
      NODE_ENV: development
      DEBUG: nodejs-docker-express:*

项目文件结构 #

问题原因 #

1. 镜像构建时的多余复制：Dockerfile中的COPY . ./node指令，会把宿主机当前项目目录的所有文件复制到容器的/node/node/路径下（因为WORKDIR设置为/node/，./node是相对路径），这就是容器内出现app和src目录的原因——构建镜像时被复制进去的。
2. 卷挂载逻辑冲突：虽然Compose配置了宿主机目录挂载到/node/，但如果镜像构建时该目录已有内容，旧内容可能干扰挂载后的文件同步，甚至导致宿主机文件无法正常覆盖容器目录。

解决方案 #

1. 修正Dockerfile #

开发场景下不需要把代码复制到镜像中（依赖卷挂载同步），直接移除COPY . ./node指令：

FROM node:18

WORKDIR /node/
#COPY ./package.json ./package.json

# RUN npm install

EXPOSE 3000

# CMD [ "node", "app.js" ]

RUN ["apt-get", "update"]
RUN ["apt-get", "install", "nano"]

CMD [ "npm", "run" , "start" ]
#CMD tail -f /dev/null

2. 确认宿主机路径有效性 #

确保宿主机的/var/www/node/dram/目录确实存在，并且包含你的项目文件（如app.js、src/、package.json等）。

3. 重新构建并启动容器 #

执行以下命令清理旧容器、重新构建镜像并启动：

docker-compose down
docker-compose build --no-cache
docker-compose up -d

4. 验证文件同步 #

进入容器查看文件是否同步：

docker-compose exec web ls /node/

修改宿主机/var/www/node/dram/下的文件，再次在容器中查看，确认文件已同步更新。

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