Docker中Jupyter Notebook只读模式问题：如何启用修改保存？

问题场景 #

使用以下配置启动Jupyter Notebook容器后，访问http://localhost:8888/notebooks/notebooks/app.ipynb时，界面显示只读模式，无法保存修改。

Dockerfile

FROM jupyter/tensorflow-notebook
WORKDIR /app
COPY ./notebooks ./notebooks
RUN chmod -R 777 /app

docker-compose.yml

services:
  app:
    build:
      context: .
      dockerfile: Dockerfile
    container_name: tensorf-notebook
    volumes:
      - .:/app
    ports:
      - "8888:8888"
    read_only: false
    command: jupyter notebook --allow-root --ip=0.0.0.0 --port=8888 --NotebookApp.password='sha1:...'

原因分析 #

1. 挂载目录权限冲突：宿主机目录挂载到容器/app后，容器内原有的chmod -R 777 /app设置会被宿主机的目录权限覆盖。jupyter/tensorflow-notebook默认以jovyan用户（UID=1000）运行，该用户可能没有宿主机挂载目录的写入权限。
2. 路径映射混淆：访问路径中的双重notebooks导致Jupyter识别的文件路径权限异常，宿主机的./notebooks被复制到容器/app/notebooks，同时挂载后宿主机的当前目录覆盖/app，出现路径权限叠加问题。

修复方案 #

方案1：直接以root用户运行容器 #

在docker-compose.yml中添加用户配置，跳过权限校验：

services:
  app:
    build:
      context: .
      dockerfile: Dockerfile
    container_name: tensorf-notebook
    volumes:
      - .:/app
    ports:
      - "8888:8888"
    read_only: false
    user: root  # 指定以root用户运行
    command: jupyter notebook --allow-root --ip=0.0.0.0 --port=8888 --NotebookApp.password='sha1:...'

方案2：调整宿主机目录权限 #

在宿主机执行命令，给容器默认用户jovyan（UID=1000）赋予当前目录的写入权限：

sudo chown -R 1000:1000 ./

然后重启容器：

docker-compose down && docker-compose up -d --build

方案3：优化路径映射逻辑 #

修改docker-compose.yml的挂载路径，避免双重notebooks路径混淆：

services:
  app:
    build:
      context: .
      dockerfile: Dockerfile
    container_name: tensorf-notebook
    volumes:
      - ./notebooks:/app/notebooks  # 仅挂载notebooks目录
    ports:
      - "8888:8888"
    read_only: false
    command: jupyter notebook --allow-root --ip=0.0.0.0 --port=8888 --NotebookApp.password='sha1:...'

同时修改Dockerfile，让Jupyter直接在notebooks目录启动：

FROM jupyter/tensorflow-notebook
WORKDIR /app/notebooks
COPY ./notebooks ./
RUN chmod -R 777 /app/notebooks

之后访问路径改为http://localhost:8888/notebooks/app.ipynb即可。

验证方法 #

重启容器后，打开Notebook尝试修改内容并保存，若能正常保存则说明问题解决。

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