运行Docker部署的Nginx时找不到构建阶段复制的letsencrypt文件怎么办

核心错误原因定位 #

报错提示找不到/etc/letsencrypt/options-ssl-nginx.conf文件，大概率由Dockerfile语法错误、构建上下文配置错误、运行时挂载覆盖三类问题导致，可按以下步骤逐一排查解决：

步骤1：修正Dockerfile语法错误 #

你提供的Dockerfile中前4条COPY指令末尾多余添加了分号，Docker会将分号识别为目标路径的一部分，导致文件实际被存储为/etc/letsencrypt/options-ssl-nginx.conf;（末尾带分号后缀），与Nginx配置中读取的路径不匹配。

修正后的Dockerfile参考：

FROM nginx

COPY fullchain.pem /etc/letsencrypt/live/engi.network/fullchain.pem
COPY privkey.pem /etc/letsencrypt/live/engi.network/privkey.pem
COPY options-ssl-nginx.conf /etc/letsencrypt/options-ssl-nginx.conf
COPY ssl-dhparams.pem /etc/letsencrypt/ssl-dhparams.pem
COPY default.conf.template /etc/nginx/templates/default.conf.template
COPY nginx.conf /etc/nginx/nginx.conf
COPY index.html /usr/share/nginx/html/index.html

步骤2：验证构建阶段文件复制正常 #

• 确认执行docker build或docker compose build的工作目录下，存在所有需要复制的文件：fullchain.pem、privkey.pem、options-ssl-nginx.conf等，路径拼写完全匹配，大小写符合Linux规范。
• 确认docker-compose.yml中build.context字段指向存放上述文件的目录，没有配置错误的相对路径。
• 镜像构建完成后，可执行以下命令验证文件是否存在于镜像内：

  docker run --rm <你的镜像名称> ls /etc/letsencrypt/
  

  如果输出列表中没有options-ssl-nginx.conf，说明构建阶段复制失败，重新检查上述配置。

步骤3：排除运行时挂载覆盖问题 #

检查docker-compose.yml中Nginx服务的volumes配置，是否存在将本地目录挂载到/etc/letsencrypt、/etc/nginx的规则：

• 如果存在这类挂载，你构建阶段复制到镜像内的文件会被本地挂载目录的内容完全覆盖，若本地目录没有对应文件就会报错。
• 解决方案：删除无效挂载规则，或者将证书、配置文件放到挂载对应的本地目录中。

步骤4：重启验证 #

所有配置修正后，执行以下命令重新构建启动：

docker compose build --no-cache && docker compose up -d

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