终端可克隆私有Git仓库，但Dockerfile用--mount=type=ssh失败求助

我之前也踩过这个一模一样的坑！本地终端用SSH克隆私有仓库完全正常，一放到Docker的--mount=type=ssh里就报权限被拒，折腾了好一会儿才梳理出几个可行的解决办法：

1. 确保Docker Build时启用SSH代理转发 #

你大概率是漏掉了docker build时的SSH代理参数！Dockerfile里的--mount=type=ssh只是声明要挂载SSH资源，但需要在build命令里明确告诉Docker要复用主机的SSH认证信息。

执行build命令时加上--ssh参数：

docker build --ssh default=$SSH_AUTH_SOCK .

这里的default对应Dockerfile中未指定id的--mount=type=ssh（默认就是default），$SSH_AUTH_SOCK是主机上SSH代理的套接字路径，会自动把你的本地认证信息传递到容器构建环境中。

如果你的SSH密钥不是默认的~/.ssh/id_rsa，可以指定具体路径：

docker build --ssh default=~/.ssh/your_custom_key .

2. 检查Dockerfile中的用户上下文 #

如果你的Dockerfile里用了USER指令切换到非root用户，~/.ssh会指向该用户的家目录，而挂载的SSH代理可能无法被这个用户访问到。

解决办法二选一：

• 在切换用户之前执行克隆操作（保持root用户执行git clone）
• 在--mount里指定目标路径为非root用户的.ssh目录：

  RUN --mount=type=ssh,target=/home/nonrootuser/.ssh git clone git@github.com:X/X.git
  

3. 备用方案：使用GitHub个人访问令牌（PAT）替代SSH #

如果SSH的方式还是卡壳，用HTTPS+PAT的方法会更简洁，尤其是在CI/CD环境里：

先在Dockerfile中添加ARG接收PAT：

ARG GITHUB_PAT
RUN git clone https://${GITHUB_PAT}@github.com:X/X.git

然后执行build命令时传递PAT：

docker build --build-arg GITHUB_PAT=your_github_pat_here .

注意：PAT需要配置仓库的读取权限，绝对不要把PAT硬编码到Dockerfile里，用build参数传递更安全。

快速验证SSH连通性 #

可以在Dockerfile里加个测试命令，先确认SSH认证是否正常：

RUN --mount=type=ssh ssh -T git@github.com

如果输出Hi username! You've successfully authenticated, but GitHub does not provide shell access.，说明SSH认证没问题，再执行克隆就应该能成功了。

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