Docker容器与主机同步node_modules问题求助

问题描述 #

想把React应用容器化，要求在Docker容器里安装node_modules并同步到主机，全程用容器跑npm命令，不用在主机装依赖。现在容器里的node_modules是完整的，但主机上对应的文件夹是空的，导致IDE一直报依赖未安装的警告。

当前配置文件 #

docker-compose.yml #

version: '3.9'

services:
  frontend:
    build:
      dockerfile: Dockerfile
      context: ./frontend
    volumes:
      - /usr/src/app/node_modules
      - ./frontend:/usr/src/app

Dockerfile #

FROM node:18-alpine3.15
WORKDIR /usr/src/app
COPY package*.json ./
RUN npm install && \
    mkdir -p node_modules/.cache && \
    chmod -R 777 node_modules/.cache
COPY ./ ./ 
CMD npm run start

问题原因 #

你现在用的/usr/src/app/node_modules是Docker的匿名卷，这个卷的作用是把容器内的node_modules目录单独隔离开，不和主机挂载的./frontend目录重叠。所以容器里装的依赖都存在匿名卷里，不会同步回主机的文件夹，自然主机上的node_modules是空的。

解决方案 #

要让容器内安装的依赖同步到主机，得改挂载方式，去掉匿名卷，让容器直接把依赖装到主机挂载的目录里。

1. 修改docker-compose.yml #

删掉匿名卷那一行，只保留主机目录挂载：

version: '3.9'

services:
  frontend:
    build:
      dockerfile: Dockerfile
      context: ./frontend
    volumes:
      - ./frontend:/usr/src/app

2. 调整Dockerfile（可选，解决权限问题） #

如果担心主机目录权限冲突，可以给容器创建非root用户，避免用root权限安装依赖：

FROM node:18-alpine3.15
WORKDIR /usr/src/app
# 创建非root用户组和用户
RUN addgroup -S appgroup && adduser -S appuser -G appgroup
COPY package*.json ./
# 切换到非root用户执行安装
USER appuser
RUN npm install && \
    mkdir -p node_modules/.cache && \
    chmod -R 777 node_modules/.cache
COPY ./ ./ 
CMD npm run start

3. 重新构建启动容器 #

先清理之前的容器和残留的匿名卷：

docker-compose down -v

然后重新构建镜像并启动：

docker-compose up --build

这样容器启动时，npm install会直接把依赖装到主机的./frontend/node_modules目录下，IDE就能识别到依赖了。

注意：如果主机和容器的系统架构不一样（比如主机是ARM芯片，容器是x86架构），部分依赖可能会出现兼容性问题。这种情况建议还是用匿名卷隔离容器内的依赖，同时在主机手动跑一次npm install（只为让IDE识别，实际运行还是用容器里的依赖）。

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