Docker构建执行COPY指令复制本地~/.ssh目录报错文件不存在求助

• Docker 构建的**上下文（build context）**仅包含执行docker build命令时指定的目录及其子目录内容，默认无法访问上下文外的路径（比如用户家目录~/.ssh）
• Dockerfile 的COPY指令不支持解析~这类 Shell 风格的家目录占位符，会直接把~当做普通字符串处理，自然无法找到对应路径
• 后续运行时抛出的文件不存在报错，就是因为构建阶段COPY指令执行失败，容器内根本没有生成对应的ssh密钥文件

根据你的使用场景选择以下任意一种方案即可：

方案1：构建时打入镜像（仅推荐本地测试使用，不建议生产环境使用，避免私钥泄露到镜像层） #

操作步骤：

1. 把本地~/.ssh目录下需要的id_rsa、known_hosts文件复制到你的Docker构建上下文目录（即Dockerfile所在的目录）下的.ssh子目录中
2. 修改Dockerfile中的COPY指令，同时补充SSH要求的权限配置：

COPY ./.ssh /root/.ssh
# SSH对密钥文件权限有严格要求，权限过高会拒绝访问，必须做以下配置
RUN chmod 600 /root/.ssh/id_rsa \
    && chmod 644 /root/.ssh/known_hosts

3. 检查项目根目录下的.dockerignore文件，如果里面有排除.ssh目录的规则，删除对应规则即可
4. 注意：请把复制到构建目录的.ssh加入.gitignore，避免不小心把私钥提交到代码仓库

方案2：运行时挂载（生产环境推荐，私钥不会存入镜像层，安全性更高） #

不需要修改Dockerfile，直接在启动容器时通过挂载参数把本地ssh目录映射到容器内即可：

• 原生docker run命令：

docker run -v ~/.ssh:/root/.ssh [你的其他启动参数] [镜像名称]

• docker-compose配置：在对应服务的volumes节点下增加以下配置：

volumes:
  - ~/.ssh:/root/.ssh

补充注意：如果你的容器运行用户不是root，需要把容器内的目标路径替换为对应用户的家目录下的.ssh路径，同时确保挂载的文件对应用户有读取权限，避免出现权限不足问题。

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