Docker容器中Jupyter Notebook访问映射目录/data时权限拒绝问题

你这明显是遇到了目录权限问题——Jupyter Notebook运行的进程用户没有/data根目录的读取（列出内容）权限，不过子目录能正常访问，说明挂载本身没毛病，就是根目录的权限设置卡了进程的读取操作。

问题根源 #

从报错里的PermissionError: [Errno 13] Permission denied: '/data'能看出来，Jupyter调用os.listdir想读/data目录内容的时候被拒了。通常这种情况无非两个原因：

• /data目录的所有者/所属组和Jupyter运行的用户不匹配
• /data目录的权限位没给Jupyter用户开放读取+执行权限（目录的execute权限允许进入目录，read权限允许列出里面的内容）

解决方案 #

1. 先确认容器内/data的权限状态

先进入你的Docker容器，执行以下命令查看目录权限细节：

docker exec -it [你的容器名/容器ID] bash
ls -ld /data

输出会类似这样：

drwxr-xr-x 2 root root 4096 Aug 10 12:00 /data

这里的root root就是目录的所有者和所属组，如果Jupyter不是以root用户运行（大部分官方Notebook镜像默认用jovyan用户），那肯定会出现权限不足的情况。

2. 修改/data目录的所有者（推荐方案）

如果Jupyter是用jovyan用户运行的（官方Notebook镜像基本都是这个默认用户），在容器内执行以下命令修改目录所有者：

chown jovyan:jovyan /data

要是你用的是自定义用户，替换成对应的用户名和组名即可。

3. 临时开放目录权限（仅用于快速测试）

要是你只是想快速验证是不是权限问题，也可以给其他用户开放读取+执行权限（注意：生产环境不推荐这么做，安全性较低）：

chmod o+rx /data

4. 从Docker启动阶段规避权限问题

下次启动容器时，可以直接指定运行用户，或者确保主机侧的目录权限和容器内用户匹配：

• 指定用户启动容器的命令：

docker run -p 3000:8888 -v /host/data:/data --user $(id -u):$(id -g) [你的镜像名]

这个命令会让容器内的进程以当前主机用户的UID/GID运行，从根源上避免权限不匹配的问题。

为啥子目录能正常访问？ #

因为/data/abc/要么是Jupyter进程自己创建的，要么已经被赋予了Jupyter用户的权限，所以进程对这个子目录有完整的读写权限；但/data根目录的权限是挂载或初始化时设置的，没同步给Jupyter运行的用户，所以没法列出根目录的内容。

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