Jenkins流水线Docker容器中npm的StrictHostKeyChecking=no设置及SSH代理传递问题

一、npm install时StrictHostKeyChecking配置不生效的问题 #

你提到git clone能成功跳过主机验证，但npm install失败，核心原因是npm在调用Git时可能没有正确继承或使用你设置的GIT_SSH_COMMAND环境变量。这里有两个可靠的解决方案：

方案1：在Docker容器中配置全局SSH Config #

直接在Dockerfile中生成SSH配置文件，让所有Git操作（包括npm触发的）自动应用StrictHostKeyChecking规则：

# 创建ssh目录并写入全局配置
RUN mkdir -p ~/.ssh && \
    echo -e "Host github.****\n\tStrictHostKeyChecking no\n\tUserKnownHostsFile /dev/null\n" >> ~/.ssh/config && \
    chmod 600 ~/.ssh/config

# 后续npm install无需额外指定GIT_SSH_COMMAND
RUN --mount=type=ssh,id=github npm install git+ssh://git@github.****

这个方案的优势是一劳永逸，所有Git相关操作都会遵循这个配置，避免重复设置环境变量。

方案2：强制npm使用指定的SSH命令 #

如果不想修改全局配置，可以通过npm的内置配置或明确传递环境变量来确保Git调用时使用SSH参数：

# 方式A：通过npm config设置默认Git命令
RUN npm config set git "ssh -o StrictHostKeyChecking=no"
RUN --mount=type=ssh,id=github npm install git+ssh://git@github.****

# 方式B：执行npm install时明确传递GIT_SSH_COMMAND（用env确保变量传递）
RUN --mount=type=ssh,id=github env GIT_SSH_COMMAND="ssh -o StrictHostKeyChecking=no" npm install git+ssh://git@github.****

注意：直接在RUN中写GIT_SSH_COMMAND=xxx npm install可能因为shell解析问题导致变量无法传递给npm调用的子进程，用env包裹更可靠。

二、将Jenkins SSH Agent传递给Docker容器 #

要让Docker BuildKit的SSH挂载功能使用Jenkins的SSH Agent，需要完成以下步骤：

1. 确保Jenkins配置了SSH凭据 #

在Jenkins中存储你的GitHub私有仓库SSH密钥，记录凭据的ID（比如github-private-repo-key）。

2. 在Jenkins流水线中使用sshagent插件加载密钥 #

通过sshagent块加载凭据，然后在docker build命令中传递SSH_AUTH_SOCK给Docker：

pipeline {
  agent any
  environment {
    // 启用Docker BuildKit
    DOCKER_BUILDKIT = 1
  }
  stages {
    stage('Build Image with Private NPM Modules') {
      steps {
        // 加载Jenkins中存储的SSH凭据
        sshagent(['github-private-repo-key']) {
          // 传递SSH_AUTH_SOCK给Docker，对应Dockerfile中的id=github
          sh 'docker build --ssh github=$SSH_AUTH_SOCK -t my-app-image .'
        }
      }
    }
  }
}

3. 关键注意事项 #

• Docker版本需支持BuildKit（建议18.09+），如果是旧版本，需要在Docker daemon配置中开启BuildKit，或者每次build前设置export DOCKER_BUILDKIT=1。
• Dockerfile中的--mount=type=ssh,id=github必须和docker build命令中的--ssh github=...的ID完全匹配。
• 确保Jenkins用户有足够的权限执行Docker命令（加入docker用户组）。

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