如何在VS Code DevContainers构建阶段通过SSH克隆GitHub私有仓库

你的Dockerfile写法本身没有问题，问题核心是devcontainer.json未正确透传Docker Build所需的SSH参数，不存在所谓BuildKit支持缺陷，按以下步骤修改即可实现构建阶段SSH认证：

• 第一步：修改devcontainer.json的build配置块，新增options字段透传--ssh default构建参数，该参数会在DevContainers触发镜像构建时自动传给docker build命令，效果和你手动在命令行执行docker build --ssh default .完全一致。
  修正后的完整devcontainer.json配置如下：

  {
      "name": "Python 3",
      "build": {
          "dockerfile": "Dockerfile",
          "context": "..",
          "args": {
              "VARIANT": "3.10-bullseye"
          },
          "options": [
              "--ssh", "default"
          ]
      },
      "settings": {
          "terminal.integrated.profiles.linux": {
              "bash": {
                  "path": "/bin/bash"
              }
          }
      },
      "extensions": [
          "ms-python.python",
          "ms-python.vscode-pylance"
      ],
      "mounts": [
          "source=/var/run/docker.sock,target=/var/run/docker.sock,type=bind",
          "source=/run/host-services/ssh-auth.sock,target=/run/host-services/ssh-auth.sock,type=bind,consistency=cached"
      ]
  }
  

  注意：你之前配置的mounts字段仅对容器运行阶段生效，构建阶段无法读取该挂载配置，必须通过build.options传入SSH参数才能在构建时使用SSH代理。
• 第二步：提前配置宿主机SSH认证环境
  1. 确保本地SSH私钥已添加到ssh-agent，终端执行ssh-add ~/.ssh/你的GitHub私钥文件路径即可
  2. 验证本地SSH认证正常：执行ssh -T git@github.com，返回GitHub认证成功提示即可
  3. Windows/macOS环境使用Docker Desktop无需额外配置，Docker会自动转发宿主机ssh-agent；Linux环境需确保Docker服务有权限访问SSH_AUTH_SOCK对应的套接字文件。
• 配置验证
  修改完成后在VS Code中执行Dev Containers: Rebuild Container即可，构建阶段会自动通过SSH完成私有仓库克隆，只要Dockerfile中克隆相关的指令没有变动，后续重建容器会直接复用镜像缓存，不会重复执行克隆操作，大幅加快启动速度。

注意：你当前Dockerfile中使用RUN --mount=type=ssh的写法是安全的，SSH挂载仅在对应RUN指令执行时临时存在，指令执行结束后自动卸载，不会将私钥内容写入镜像层，不存在凭证泄露风险。

内容的提问来源于stack exchange，提问作者Error - Syntactical Remorse