Docker COPY命令src参数失效：无法找到.pgpass文件求助

核心原因 #

你遇到的错误和.pgpass是隐藏文件无关，根源是两个关键问题：

1. Docker的COPY命令不解析Shell波浪号~：Docker构建时不会把~识别为主机用户的家目录，它只会从构建上下文（即执行docker build时指定的.目录）里查找文件。
2. 主机家目录文件不在构建上下文范围内：Docker daemon构建镜像时只能访问你指定的构建上下文里的文件，/home/username/.pgpass属于主机系统文件，不在上下文中，所以会提示找不到。

另外你的Dockerfile还有几个需要修正的小问题：

• 连续两个FROM属于多阶段构建，但postgres:17.0会完全覆盖前面的ubuntu:20.04，前者无意义，建议删除。
• CMD里用了中文引号“/bin/bash”，必须改成英文双引号"/bin/bash"。
• postgres镜像本身已包含bash，无需额外安装。
• .pgpass文件要求权限必须为0600（仅所有者可读可写），否则PostgreSQL会忽略该文件，需添加权限设置。

解决方法（按推荐程度排序） #

方法1：将.pgpass复制到构建上下文目录

这是最直接的方案：

1. 把主机上的~/.pgpass复制到执行docker build的目录（构建上下文）：

   cp ~/.pgpass ./
   

2. 修改Dockerfile中的COPY命令并添加权限设置：

   FROM postgres:17.0
   
   COPY backup.sh /usr/local/bin/
   COPY .pgpass /var/lib/postgresql/.pgpass  # postgres镜像默认用户为postgres，家目录是/var/lib/postgresql
   WORKDIR /usr/local/bin/
   RUN chmod u+x backup.sh && chmod 0600 /var/lib/postgresql/.pgpass
   
   RUN apt-get update \
       && apt-get install -y cron iputils-ping \
       && rm -rf /var/lib/apt/lists/*  # 清理缓存减小镜像体积
   
   CMD ["/bin/bash"]
   

3. 重新执行构建命令即可。

方法2：用BuildKit挂载主机文件构建（无需复制文件到上下文）

如果不想把.pgpass复制到构建目录，可使用Docker BuildKit的挂载功能：

1. 构建命令前加DOCKER_BUILDKIT=1开启BuildKit。
2. 修改Dockerfile，通过RUN --mount挂载主机文件并复制到容器内：

   FROM postgres:17.0
   
   COPY backup.sh /usr/local/bin/
   WORKDIR /usr/local/bin/
   RUN chmod u+x backup.sh
   
   # 挂载主机pgpass文件，复制到容器内postgres用户家目录并设置权限
   RUN --mount=type=bind,source=/home/username/.pgpass,target=/host_pgpass \
       cp /host_pgpass /var/lib/postgresql/.pgpass && chmod 0600 /var/lib/postgresql/.pgpass
   
   RUN apt-get update \
       && apt-get install -y cron iputils-ping \
       && rm -rf /var/lib/apt/lists/*
   
   CMD ["/bin/bash"]
   

3. 执行构建命令：

   sudo DOCKER_BUILDKIT=1 docker build --no-cache -t hcorte/bakcup_container .
   

方法3：通过构建参数传递.pgpass内容

如果连挂载都不想用，可把.pgpass内容通过构建参数传入并写入文件：

1. 执行构建命令：

   sudo DOCKER_BUILDKIT=1 docker build --no-cache -t hcorte/bakcup_container \
       --build-arg PGPASS_CONTENT="$(cat /home/username/.pgpass)" .
   

2. 修改Dockerfile：

   FROM postgres:17.0
   
   COPY backup.sh /usr/local/bin/
   WORKDIR /usr/local/bin/
   RUN chmod u+x backup.sh
   
   # 接收构建参数并写入pgpass文件，设置权限
   ARG PGPASS_CONTENT
   RUN echo "$PGPASS_CONTENT" > /var/lib/postgresql/.pgpass && chmod 0600 /var/lib/postgresql/.pgpass
   
   RUN apt-get update \
       && apt-get install -y cron iputils-ping \
       && rm -rf /var/lib/apt/lists/*
   
   CMD ["/bin/bash"]
   

内容的提问来源于stack exchange，提问作者H.C