docker之WORKDIR指令的使用及说明

更新时间：2025年07月19日 08:48:01 作者：hero.zhong

WORKDIR设置工作目录,后续命令基于此路径执行,若目录不存在则自动创建,RUN指令每层独立,不继承前层状态,需用WORKDIR确保文件路径正确,避免因分层存储导致的文件找不到错误

docker WORKDIR指令的使用

WORKDIR 指定工作目录

格式为 WORKDIR <工作目录路径>。
使用 WORKDIR 指令可以来指定工作目录（或者称为当前目录），以后各层的当前目录就被改为指定的目录，如该目录不存在，WORKDIR 会帮你建立目录。

#test
FROM ubuntu
MAINTAINER hello
RUN mkdir /mydir
RUN echo hello world > /mydir/test.txt
WORKDIR /mydir
CMD ["more" ,"test.txt"]

假设根据该dockerfile构建的镜像名为 myimage

1、运行 docker run myimage 输出 hello world

2、运行 docker run myimage more test.txt 和上面输出一致

可以看出，more的参数是 test.txt，但没有指定路径，却能成功，说明当前路径就是上面WORKDIR指令设置的。

如果我们在上面的dockerfile中把WORKDIR指令去掉，创建的容器运行会报文件不存在错误。

之前提到一些初学者常犯的错误是把 Dockerfile 等同于 Shell 脚本来书写，这种错误的理解还可能会导致出现下面这样的错误：

RUN cd /app
RUN echo "hello" > world.txt

如果将这个 Dockerfile 进行构建镜像运行后，会发现找不到 /app/world.txt 文件，或者其内容不是 hello。原因其实很简单，在 Shell 中，连续两行是同一个进程执行环境，因此前一个命令修改的内存状态，会直接影响后一个命令；而在 Dockerfile 中，这两行 RUN 命令的执行环境根本不同，是两个完全不同的容器。这就是对 Dockerfile 构建分层存储的概念不了解所导致的错误。

之前说过每一个 RUN 都是启动一个容器、执行命令、然后提交存储层文件变更。第一层 RUN cd /app 的执行仅仅是当前进程的工作目录变更，一个内存上的变化而已，其结果不会造成任何文件变更。而到第二层的时候，启动的是一个全新的容器，跟第一层的容器更完全没关系，自然不可能继承前一层构建过程中的内存变化。

因此如果需要改变以后各层的工作目录的位置，那么应该使用 WORKDIR 指令。

总结

以上为个人经验，希望能给大家一个参考，也希望大家多多支持脚本之家。

您可能感兴趣的文章:

docker 移除掉运行不正常的container操作
这篇文章主要介绍了docker 移除掉运行不正常的container操作，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧
2021-03-03
Docker自动化构建Automated Build实现过程图解
这篇文章主要介绍了Docker自动化构建Automated Build实现过程图解,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
2020-10-10
docker pull镜像失败问题解决方法
在使用Docker拉取镜像时可能会遇到超时失败的问题,通常由网络问题导致,本文介绍了两种解决方法：更改镜像加速地址和添加DNS配置,这些措施可以帮助改善与Docker Hub的连接,提高拉取镜像的成功率,如果问题依旧,请参考更多相关资料或寻求专业帮助
2024-09-09
Docker Compose 网络设置详解
这篇文章主要介绍了Docker Compose 网络设置详解，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
2019-10-10
如何实现不同网段docker容器网络互通
文章讲解了通过Docker bridge网络实现容器间通信的方法,包括关闭防火墙、拉取busybox镜像、创建容器并测试IP连通性,使用--link参数连接容器,以及跨网段通信的配置技巧
2025-07-07
docker 连接宿主Mysql操作
这篇文章主要介绍了docker 连接宿主Mysql操作，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧
2020-11-11
导出与导入Docker的容器实现示例
本文主要介绍了导出与导入Docker的容器实现示例，文中通过示例代码介绍的非常详细，具有一定的参考价值，感兴趣的小伙伴们可以参考一下
2021-12-12
docker-desktop启动k8s的详细方法
这篇文章主要介绍了docker-desktop启动k8s,本文给大家介绍的非常详细，对大家的学习或工作具有一定的参考借鉴价值，需要的朋友可以参考下
2022-08-08
Docker部署.NET6项目的实现步骤
Docker是现在比较流行的开源容器引擎,有了它让我们部署和维护系统更加方便，本文主要介绍了Docker部署.NET6项目，具有一定的参考价值，感兴趣的可以了解一下
2023-12-12
docker安装geoserver的方法步骤
GeoServer是OGC Web服务器规范的J2EE实现,利用GeoServer可以方便地发布地图数据,本文主要介绍了docker安装geoserver的方法步骤,感兴趣的可以了解一下
2024-08-08