Jenkins容器内运行docker命令提示权限不足/命令不存在如何解决？

根因分析 #

• 直接挂载宿主机docker二进制的方式不可靠：宿主机docker二进制依赖的系统库和Jenkins官方镜像（基于Debian系统）的运行环境不匹配，导致挂载过去的二进制无法执行，这就是进入容器执行docker提示command not found的核心原因。
• 之前的权限操作无效：你在宿主机修改sock权限、将宿主机用户加入docker组的操作，对容器内的运行环境不生效，权限判断是基于容器内的用户和用户组规则。

具体修复方案 #

步骤1：修改docker-compose配置 #

不要直接挂载宿主机docker二进制，改为在容器启动时安装适配容器系统的docker客户端，修改后的配置如下：

version: '3.7'
services:
  jenkins:
    image: jenkins/jenkins:lts
    privileged: true
    user: root
    ports:
      - 8080:8080 # 补充Jenkins web访问端口，之前的配置遗漏了该端口
      - 50000:50000
    container_name: jenkins
    volumes:
      - ~/jenkins:/var/jenkins_home
      - /var/run/docker.sock:/var/run/docker.sock
    # 启动前自动安装docker客户端
    command: >
      bash -c "apt-get update && apt-get install -y apt-transport-https ca-certificates curl gnupg-agent software-properties-common &&
      curl -fsSL https://download.docker.com/linux/debian/gpg | apt-key add - &&
      add-apt-repository \"deb [arch=amd64] https://download.docker.com/linux/debian $(lsb_release -cs) stable\" &&
      apt-get update && apt-get install -y docker-ce-cli &&
      /usr/local/bin/jenkins.sh"

如果想要启动速度更快，也可以自己基于jenkins/jenkins:lts构建自定义镜像，将安装docker客户端的步骤写入Dockerfile，避免每次启动都执行安装命令。

步骤2：修复docker套接字权限 #

进入运行中的Jenkins容器执行以下命令：

# 可选更安全的权限配置，避免给sock开过高权限
# 先查询宿主机docker组的gid，假设宿主机docker组gid为999
groupmod -g 999 docker
usermod -aG docker root
# 如果嫌麻烦可以直接给sock赋权
chmod 666 /var/run/docker.sock

步骤3：验证并测试 #

• 重启Jenkins容器生效配置：docker-compose down && docker-compose up -d
• 进入容器执行docker info，正常输出信息说明配置生效
• 你的测试流水线可以调整为规范写法，避免废弃警告：

node {
    stage("Create build output") {
        sh "docker info"
    }
}

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