Docker化Mozilla pdf.js应用：权限错误与页面空白问题求助

一、解决初始Dockerfile的EACCES权限错误 #

最初的Dockerfile切换到app用户后执行npm install --global gulp-cli报错，核心原因是全局npm包目录/usr/local/lib/node_modules属于root用户，普通用户无写入权限。以下两种方案可修复：

方案1：先以root身份安装全局依赖，再切换到普通用户 #

调整步骤顺序，先完成全局包安装再切换非root用户，兼顾安全性与权限要求：

FROM node:18

# 创建非root用户组及用户
RUN groupadd -r app && useradd -r -g app -G node -m -s /bin/bash app

WORKDIR /app

# root身份安装全局gulp-cli
RUN npm install --global gulp-cli

# 复制依赖配置文件并安装项目依赖
COPY package*.json ./
RUN npm install

# 复制全部项目文件
COPY . .

# 转移工作目录权限给app用户
RUN chown -R app:app /app

# 切换到非root用户运行服务
USER app

EXPOSE 8888
CMD ["gulp", "server"]

方案2：不安装全局gulp，直接使用项目本地依赖 #

无需全局安装gulp-cli，利用npx调用项目本地的gulp命令，彻底规避权限问题：

FROM node:18

RUN groupadd -r app && useradd -r -g app -G node -m -s /bin/bash app

WORKDIR /app

COPY package*.json ./
RUN npm install

COPY . .
RUN chown -R app:app /app

USER app

EXPOSE 8888
# 使用npx调用本地gulp
CMD ["npx", "gulp", "server"]

二、解决修改后页面空白的问题 #

修改后的Dockerfile构建成功但页面空白，可从以下几个方向排查修复：

1. 确保gulp server绑定0.0.0.0 #

默认gulp server可能仅绑定127.0.0.1，导致容器外部无法正常访问。检查项目的gulpfile.js，将server的host设置为0.0.0.0：

// gulpfile.js中的server配置示例
gulp.task('server', function() {
  connect.server({
    root: '.',
    port: 8888,
    host: '0.0.0.0' // 必须设置为0.0.0.0才能对外提供服务
  });
});

2. 避免本地挂载覆盖容器内依赖 #

你的docker-compose.yml中挂载了./:/app，本地目录的node_modules会覆盖容器内安装的依赖，可能导致依赖缺失。修改配置排除node_modules目录：

version: '3'
services:
  pdfjs:
    build: .
    ports:
      - "8888:8888"
    volumes:
      - .:/app
      - /app/node_modules # 保留容器内的依赖目录，不被本地覆盖

3. 验证示例PDF路径正确性 #

访问/web/viewer.html时，默认加载的PDF路径可能有误，可手动指定完整路径测试：

http://localhost:8888/web/viewer.html?file=/test/pdfs/helloworld.pdf

如果能正常显示，说明是viewer.html默认加载路径配置错误，可修改web/viewer.js中的默认文件路径。

4. 检查容器内文件完整性 #

进入容器确认项目文件是否复制完整：

docker-compose exec pdfjs ls -la /app/web

确保viewer.html、viewer.js及示例PDF文件均存在且路径正确。

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