Docker基于jupyter/datascience-notebook自定义用户时文件复制异常求助

问题根源 #

Docker镜像构建阶段无法读取docker-compose.yml中设置的环境变量，此时NB_USER使用的是基础镜像jupyter/datascience-notebook默认的jovyan值，导致COPY指令将启动脚本复制到了/home/jovyan/.ipython/...目录，而非运行阶段指定的my-user目录。

解决方案 #

方案1：构建时传递自定义用户参数（推荐） #

通过构建参数将自定义用户信息传递到Dockerfile，确保构建阶段就能使用正确的用户路径：

修改后的Dockerfile

FROM jupyter/datascience-notebook

# 定义构建参数，默认值兼容基础镜像设置
ARG NB_USER=${NB_USER:-jovyan}
ARG NB_UID=${NB_UID:-1000}
ARG NB_GID=${NB_GID:-100}

# 创建自定义用户并初始化IPython目录
USER root
RUN useradd -m -s /bin/bash -u ${NB_UID} ${NB_USER} && \
    mkdir -p /home/${NB_USER}/.ipython/profile_default/startup && \
    chown -R ${NB_UID}:${NB_GID} /home/${NB_USER}/.ipython

USER ${NB_USER}
ENV JUPYTER_ENABLE_LAB=yes

# 复制启动脚本到自定义用户的IPython启动目录
COPY --chown=${NB_UID}:${NB_GID} notebook-startup-scripts/00-s3fs.py /home/${NB_USER}/.ipython/profile_default/startup/

修改后的docker-compose.yml

version: "3.9"
services:
  jupyter-1:
    build:
      context: ./jupyter-lab
      args:
        NB_USER: "my-user"
        NB_UID: 1001  # 可自定义UID，避免与宿主机用户冲突
        NB_GID: 100
    user: "my-user"
    working_dir: /home/my-user/work
    ports:
      - "8888:8888"
    volumes:
      # 按需添加卷挂载配置
    environment:
      CHOWN_HOME: "yes"
      restartable: "yes"
    stdin_open: true
    tty: true
    command: /usr/local/bin/start-notebook.sh --ServerApp.allow_origin="*" --ServerApp.open_browser=False --ServerApp.allow_remote_access=True --ServerApp.trust_xheaders=True --ServerApp.password=${JUPYTER_PASSWORD}

方案2：容器启动时动态复制文件 #

如果不想调整构建流程，可将脚本先复制到共享临时目录，启动时再拷贝到目标用户目录：

修改后的Dockerfile

FROM jupyter/datascience-notebook

ENV JUPYTER_ENABLE_LAB=yes

# 复制脚本到容器临时共享目录
COPY notebook-startup-scripts/00-s3fs.py /tmp/startup-scripts/

修改docker-compose.yml的command指令

command: >
  bash -c "mkdir -p /home/${NB_USER}/.ipython/profile_default/startup && 
           cp /tmp/startup-scripts/00-s3fs.py /home/${NB_USER}/.ipython/profile_default/startup/ && 
           chown ${NB_USER}:${NB_USER} /home/${NB_USER}/.ipython/profile_default/startup/00-s3fs.py &&
           /usr/local/bin/start-notebook.sh --ServerApp.allow_origin=\"*\" --ServerApp.open_browser=False --ServerApp.allow_remote_access=True --ServerApp.trust_xheaders=True --ServerApp.password=${JUPYTER_PASSWORD}"

验证方法 #

启动容器后，执行以下命令检查文件是否在目标路径：

docker exec -it <容器名称> ls /home/my-user/.ipython/profile_default/startup/

若输出包含00-s3fs.py则配置成功。

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