Dockerfile执行chmod报错：No such file or directory问题排查

原因分析 #

• Docker的VOLUME指令仅在容器运行阶段才会创建指定路径的目录，镜像构建过程中的RUN步骤执行时，该目录尚未存在，因此chmod命令会提示找不到文件。
• 镜像构建时，VOLUME只是标记该路径为卷挂载点，不会实际创建目录；只有当容器启动时，Docker才会自动生成这个目录（若宿主机或绑定的卷中无对应路径）。

修复方法 #

方法一：先创建目录再声明VOLUME #

修改Dockerfile，先手动创建目标目录并设置权限，最后标记为卷：

FROM jupyterhub/jupyterhub:latest

RUN pip install --no-cache \
    oauthenticator \
    dockerspawner \
    jupyterhub-nativeauthenticator

COPY jupyterhub_config.py /srv/jupyterhub/jupyterhub_config.py

WORKDIR /srv/jupyterhub
# 先创建目录
RUN mkdir -p /srv/jupyterhub/shared_data
# 设置目录权限
RUN chmod 777 /srv/jupyterhub/shared_data
# 声明VOLUME
VOLUME /srv/jupyterhub/shared_data

方法二：在容器启动脚本中设置权限 #

如果需要更灵活的权限控制，可以在容器启动时执行权限修改操作：

1. 创建启动脚本start_jupyterhub.sh：

#!/bin/bash
# 确保目录存在并设置权限
mkdir -p /srv/jupyterhub/shared_data && chmod 777 /srv/jupyterhub/shared_data
# 启动JupyterHub
jupyterhub -f /srv/jupyterhub/jupyterhub_config.py

2. 更新Dockerfile，复制脚本并设置为入口点：

FROM jupyterhub/jupyterhub:latest

RUN pip install --no-cache \
    oauthenticator \
    dockerspawner \
    jupyterhub-nativeauthenticator

COPY jupyterhub_config.py /srv/jupyterhub/jupyterhub_config.py
COPY start_jupyterhub.sh /srv/jupyterhub/start_jupyterhub.sh

WORKDIR /srv/jupyterhub
# 给脚本添加执行权限
RUN chmod +x /srv/jupyterhub/start_jupyterhub.sh
VOLUME /srv/jupyterhub/shared_data

# 设置入口点
ENTRYPOINT ["/srv/jupyterhub/start_jupyterhub.sh"]

注意事项 #

• 方法一是最规范的做法：镜像中预先创建目录并设置权限，容器启动时卷会挂载到该路径，不会覆盖已设置的权限（针对匿名卷场景）。
• 若你是将宿主机目录绑定到该卷，宿主机目录的权限会覆盖镜像中的设置，此时需要确保宿主机目录本身已配置好对应权限。

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