使用--mount=type=ssh构建Docker时无法克隆私有Git仓库

以下是针对你遇到问题的具体排查和解决步骤：

1. 必须显式传递SSH代理给构建命令 #

这是最容易遗漏的关键步骤：Docker默认不会自动访问主机的SSH代理，构建时需要添加--ssh default参数，让容器能使用主机的SSH密钥：

docker build --ssh default . -t test:latest

2. 确认SSH密钥已被代理正确加载 #

执行以下命令验证密钥是否在SSH代理中生效：

ssh-add -l

确保输出包含你的id_ed25519密钥指纹。如果没有，重新执行密钥添加命令：

ssh-add /home/<username>/.ssh/id_ed25519

（若密钥设置了密码，需输入密码完成添加）

3. 调试容器内SSH连接可用性 #

在Dockerfile的私有仓库克隆步骤前添加调试命令，确认SSH代理是否能正常连接GitHub：

RUN --mount=type=ssh,uid=$test_uid cd /opt/$proj_name && \
    echo "SSH_AUTH_SOCK路径: $SSH_AUTH_SOCK" && \
    ssh -T git@github.com && \
    git clone git@github.com:<private_repo>.git

通过ssh -T的输出可以直接看到连接失败的具体原因，帮助定位问题。

4. 简化SSH挂载配置 #

尝试移除挂载参数中的uid，让Docker自动匹配容器内当前用户的权限：

RUN --mount=type=ssh,required=true cd /opt/$proj_name && \
    git clone git@github.com:<private_repo>.git

添加required=true可以确保SSH挂载必须生效，避免静默失败。

5. 验证Docker版本兼容性 #

SSH挂载特性需要Docker 18.09及以上版本支持，检查你的Docker版本：

docker --version

若版本过低，升级到最新稳定版即可解决兼容性问题。

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