Jenkins流水线构建Docker镜像遇权限拒绝问题求助

看起来你遇到的问题很典型——手动执行docker命令没问题，但Jenkins流水线就是报权限错误，核心原因大概率是Jenkins服务实际运行的系统用户和你手动操作的admin用户不是同一个，下面一步步帮你排查解决：

1. 修正Jenkins运行用户的Docker组权限 #

Jenkins Web界面的admin是应用层面的用户，但Jenkins后台服务默认是用系统用户jenkins运行的（不是你登录VM的admin用户）。你需要把这个jenkins用户加入docker组：

# 将jenkins系统用户添加到docker组
sudo usermod -aG docker jenkins

# 重启Jenkins服务让权限配置生效
sudo systemctl restart jenkins

这是最常见的解决点，很多人会误把Web管理用户当成服务运行用户，导致权限配置错了对象。

2. 验证Jenkins用户的Docker访问权限 #

重启Jenkins后，你可以在Jenkins内部快速验证权限是否生效：

• 进入Jenkins的脚本控制台（路径：Manage Jenkins -> Script Console）
• 执行以下代码：

def dockerCheck = "docker ps".execute()
dockerCheck.waitFor()
println "退出码: ${dockerCheck.exitValue()}"
println "输出: ${dockerCheck.in.text}"
println "错误: ${dockerCheck.err.text}"

如果输出里没有权限拒绝类的错误，说明权限已经生效，重新运行流水线试试。

3. 针对Kubernetes环境的额外配置（结合你的Deploy阶段） #

如果你是在K8s集群中部署的Jenkins，还要考虑agent pod的权限问题：

• 若你用的是agent any，可以修改Jenkins的Deployment配置，添加宿主机docker socket的挂载：

  volumes:
  - name: docker-sock
    hostPath:
      path: /var/run/docker.sock
  containers:
  - name: jenkins
    volumeMounts:
    - mountPath: /var/run/docker.sock
      name: docker-sock
  

• 或者直接在Jenkinsfile里指定Kubernetes agent时配置挂载（替换原来的agent any）：

  agent {
    kubernetes {
      yaml '''
        apiVersion: v1
        kind: Pod
        spec:
          containers:
          - name: jnlp
            image: jenkins/inbound-agent:latest
            volumeMounts:
            - mountPath: /var/run/docker.sock
              name: docker-sock
          volumes:
          - name: docker-sock
            hostPath:
              path: /var/run/docker.sock
      '''
    }
  }
  

4. 检查Docker Socket的基础权限 #

如果前面步骤都没解决，检查宿主机的docker socket权限：

ls -l /var/run/docker.sock

正常输出应该是srw-rw---- 1 root docker 0 ...，如果权限不符合预期，执行：

sudo chmod 660 /var/run/docker.sock

这能确保docker组内的用户可以正常访问socket。

按照这个流程排查，你的Build Image阶段权限问题应该就能解决，建议先从第一步开始验证，这是最容易被忽略的核心点。

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