You need to enable JavaScript to run this app. Windows10下通过Jenkins Pipeline构建Docker镜像出现docker_engine报错如何解决
优惠活动
大模型
产品
解决方案
定价
更多

Windows10下通过Jenkins Pipeline构建Docker镜像出现docker_engine报错如何解决

Windows 10 Jenkins Pipeline 构建Docker镜像报错解决方案

报错信息:

open //./pipe/docker_engine: Le fichier spécifié est introuvable. In the default daemon configuration on Windows, the docker client must be run elevated to connect. This error may also indicate that the docker daemon is not running.

该报错本质是Jenkins运行时无法访问Windows系统上的Docker守护进程命名管道,按以下步骤排查修复:

  • 第一步:确认Docker守护进程正常运行
    打开Docker Desktop,确认界面左下角显示「运行中」状态,可打开管理员权限PowerShell执行docker info命令,若能正常返回Docker配置信息则说明守护进程正常。同时可在Docker Desktop设置中开启「Expose daemon on tcp://localhost:2375 without TLS」选项,适配本地工具调用需求。
  • 第二步:配置Jenkins服务访问Docker的权限
    默认Jenkins服务使用系统内置的NT AUTHORITY\SYSTEM账户运行,该账户默认不在Docker的授权用户组内,可执行以下操作修复:
    1. 打开管理员权限PowerShell,执行命令net localgroup docker-users "NT AUTHORITY\SYSTEM" /add,将Jenkins运行账户加入Docker授权组
    2. 依次重启Docker Desktop、Jenkins服务生效
      如果你修改过Jenkins服务的默认运行账户,将你使用的账户替换上述命令中的NT AUTHORITY\SYSTEM即可。
  • 第三步:适配Jenkinsfile的Windows运行环境
    你使用的Jenkinsfile默认适配Linux运行环境,在Windows下需要做两处调整:
    1. 将所有sh执行步骤替换为bat或者powershell步骤,适配Windows命令执行环境
    2. 若使用Docker agent,需明确指定容器运行平台,避免平台不兼容报错
  • 第四步:验证修复效果
    配置完成后可以运行测试Pipeline验证Docker调用是否正常,测试Pipeline示例如下:
    pipeline {
        agent any
        stages {
            stage('Test Docker') {
                steps {
                    bat 'docker version'
                }
            }
        }
    }
    
    若步骤正常输出Docker客户端和服务端版本信息,说明问题已修复。

内容的提问来源于stack exchange,提问作者Thouraya Louati

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.08 18:48:03