如何在Puppeteer Docker容器中运行Node.js项目并兼顾本地开发？

一、本地开发环境标准化 #

• 项目根目录维护独立的package.json，统一管理所有依赖：
  • 生产依赖：express、puppeteer（本地开发也需安装，用于调试PDF生成逻辑）
  • 开发依赖：typescript、@types/express、@types/puppeteer、ts-node等
• 本地执行npm install生成node_modules，直接供VS Code做类型提示、语法检查与本地编译运行
• 本地开发时，用ts-node src/index.ts直接启动服务，或编译为JS后运行，确保核心逻辑与容器环境一致

二、容器部署的Dockerfile优化 #

基于官方Puppeteer镜像，通过覆盖容器内的依赖配置，实现依赖统一管理，避免重复维护：

# 基于官方Puppeteer镜像
FROM puppeteer/puppeteer:latest

# 切换到官方预设的工作目录
WORKDIR /home/pptruser

# 复制本地的依赖配置文件（带lock文件确保版本一致）
COPY package*.json ./

# 用pptruser用户安装生产依赖（官方镜像默认用该用户，避免权限问题）
RUN npm ci --only=production

# 复制本地编译好的JS代码（提前在本地执行tsc编译，减少容器构建时间与体积）
COPY dist/ ./dist/

# 启动服务
CMD ["node", "dist/index.js"]

可选：容器内编译TS（适合开发调试阶段） #

如果需要在容器内直接编译TS，可调整Dockerfile安装开发依赖：

FROM puppeteer/puppeteer:latest

WORKDIR /home/pptruser

COPY package*.json ./
COPY tsconfig.json ./
COPY src/ ./src/

# 安装所有依赖（含开发依赖）
RUN npm install

# 编译TS为JS
RUN npm run build

# 启动服务
CMD ["node", "dist/index.js"]

三、开发阶段的容器调试方案 #

如果需要在容器内实时调试代码，避免目录冲突，可通过Docker Compose挂载指定目录：

version: '3.8'
services:
  pdf-service:
    build: .
    volumes:
      # 挂载本地src目录到容器，实现代码热更新
      - ./src:/home/pptruser/src
      # 挂载本地package.json，确保依赖配置一致
      - ./package.json:/home/pptruser/package.json
    ports:
      - "3000:3000"
    command: npm run dev # 假设package.json里配置了"dev": "ts-node src/index.ts"

注意：首次启动时需进入容器执行npm install，确保容器内依赖与本地一致；后续修改代码无需重新构建镜像，直接重启服务即可。

四、关键注意事项 #

• 始终用同一个package.json管理本地与容器的依赖，通过package-lock.json锁定版本，避免两边依赖不一致
• 生产环境优先采用本地编译后复制JS的方式，减少容器体积，无需安装开发依赖
• 容器内必须使用pptruser用户运行服务，官方镜像已配置好Chrome的权限，避免权限报错

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